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/STLExtras.h"
33 #include "llvm/ADT/SmallPtrSet.h"
34 #include "llvm/ADT/SmallString.h"
35 #include <algorithm>
36 #include <cstdlib>
37 
38 namespace clang {
39 using namespace sema;
40 
41 /// A convenience routine for creating a decayed reference to a function.
42 static ExprResult
43 CreateFunctionRefExpr(Sema &S, FunctionDecl *Fn, NamedDecl *FoundDecl,
44                       bool HadMultipleCandidates,
45                       SourceLocation Loc = SourceLocation(),
46                       const DeclarationNameLoc &LocInfo = DeclarationNameLoc()){
47   if (S.DiagnoseUseOfDecl(FoundDecl, Loc))
48     return ExprError();
49   // If FoundDecl is different from Fn (such as if one is a template
50   // and the other a specialization), make sure DiagnoseUseOfDecl is
51   // called on both.
52   // FIXME: This would be more comprehensively addressed by modifying
53   // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
54   // being used.
55   if (FoundDecl != Fn && S.DiagnoseUseOfDecl(Fn, Loc))
56     return ExprError();
57   DeclRefExpr *DRE = new (S.Context) DeclRefExpr(Fn, false, Fn->getType(),
58                                                  VK_LValue, Loc, LocInfo);
59   if (HadMultipleCandidates)
60     DRE->setHadMultipleCandidates(true);
61 
62   S.MarkDeclRefReferenced(DRE);
63 
64   ExprResult E = DRE;
65   E = S.DefaultFunctionArrayConversion(E.get());
66   if (E.isInvalid())
67     return ExprError();
68   return E;
69 }
70 
71 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
72                                  bool InOverloadResolution,
73                                  StandardConversionSequence &SCS,
74                                  bool CStyle,
75                                  bool AllowObjCWritebackConversion);
76 
77 static bool IsTransparentUnionStandardConversion(Sema &S, Expr* From,
78                                                  QualType &ToType,
79                                                  bool InOverloadResolution,
80                                                  StandardConversionSequence &SCS,
81                                                  bool CStyle);
82 static OverloadingResult
83 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
84                         UserDefinedConversionSequence& User,
85                         OverloadCandidateSet& Conversions,
86                         bool AllowExplicit,
87                         bool AllowObjCConversionOnExplicit);
88 
89 
90 static ImplicitConversionSequence::CompareKind
91 CompareStandardConversionSequences(Sema &S,
92                                    const StandardConversionSequence& SCS1,
93                                    const StandardConversionSequence& SCS2);
94 
95 static ImplicitConversionSequence::CompareKind
96 CompareQualificationConversions(Sema &S,
97                                 const StandardConversionSequence& SCS1,
98                                 const StandardConversionSequence& SCS2);
99 
100 static ImplicitConversionSequence::CompareKind
101 CompareDerivedToBaseConversions(Sema &S,
102                                 const StandardConversionSequence& SCS1,
103                                 const StandardConversionSequence& SCS2);
104 
105 
106 
107 /// GetConversionCategory - Retrieve the implicit conversion
108 /// category corresponding to the given implicit conversion kind.
109 ImplicitConversionCategory
110 GetConversionCategory(ImplicitConversionKind Kind) {
111   static const ImplicitConversionCategory
112     Category[(int)ICK_Num_Conversion_Kinds] = {
113     ICC_Identity,
114     ICC_Lvalue_Transformation,
115     ICC_Lvalue_Transformation,
116     ICC_Lvalue_Transformation,
117     ICC_Identity,
118     ICC_Qualification_Adjustment,
119     ICC_Promotion,
120     ICC_Promotion,
121     ICC_Promotion,
122     ICC_Conversion,
123     ICC_Conversion,
124     ICC_Conversion,
125     ICC_Conversion,
126     ICC_Conversion,
127     ICC_Conversion,
128     ICC_Conversion,
129     ICC_Conversion,
130     ICC_Conversion,
131     ICC_Conversion,
132     ICC_Conversion,
133     ICC_Conversion,
134     ICC_Conversion
135   };
136   return Category[(int)Kind];
137 }
138 
139 /// GetConversionRank - Retrieve the implicit conversion rank
140 /// corresponding to the given implicit conversion kind.
141 ImplicitConversionRank GetConversionRank(ImplicitConversionKind Kind) {
142   static const ImplicitConversionRank
143     Rank[(int)ICK_Num_Conversion_Kinds] = {
144     ICR_Exact_Match,
145     ICR_Exact_Match,
146     ICR_Exact_Match,
147     ICR_Exact_Match,
148     ICR_Exact_Match,
149     ICR_Exact_Match,
150     ICR_Promotion,
151     ICR_Promotion,
152     ICR_Promotion,
153     ICR_Conversion,
154     ICR_Conversion,
155     ICR_Conversion,
156     ICR_Conversion,
157     ICR_Conversion,
158     ICR_Conversion,
159     ICR_Conversion,
160     ICR_Conversion,
161     ICR_Conversion,
162     ICR_Conversion,
163     ICR_Conversion,
164     ICR_Complex_Real_Conversion,
165     ICR_Conversion,
166     ICR_Conversion,
167     ICR_Writeback_Conversion
168   };
169   return Rank[(int)Kind];
170 }
171 
172 /// GetImplicitConversionName - Return the name of this kind of
173 /// implicit conversion.
174 const char* GetImplicitConversionName(ImplicitConversionKind Kind) {
175   static const char* const Name[(int)ICK_Num_Conversion_Kinds] = {
176     "No conversion",
177     "Lvalue-to-rvalue",
178     "Array-to-pointer",
179     "Function-to-pointer",
180     "Noreturn adjustment",
181     "Qualification",
182     "Integral promotion",
183     "Floating point promotion",
184     "Complex promotion",
185     "Integral conversion",
186     "Floating conversion",
187     "Complex conversion",
188     "Floating-integral conversion",
189     "Pointer conversion",
190     "Pointer-to-member conversion",
191     "Boolean conversion",
192     "Compatible-types conversion",
193     "Derived-to-base conversion",
194     "Vector conversion",
195     "Vector splat",
196     "Complex-real conversion",
197     "Block Pointer conversion",
198     "Transparent Union Conversion"
199     "Writeback conversion"
200   };
201   return Name[Kind];
202 }
203 
204 /// StandardConversionSequence - Set the standard conversion
205 /// sequence to the identity conversion.
206 void StandardConversionSequence::setAsIdentityConversion() {
207   First = ICK_Identity;
208   Second = ICK_Identity;
209   Third = ICK_Identity;
210   DeprecatedStringLiteralToCharPtr = false;
211   QualificationIncludesObjCLifetime = false;
212   ReferenceBinding = false;
213   DirectBinding = false;
214   IsLvalueReference = true;
215   BindsToFunctionLvalue = false;
216   BindsToRvalue = false;
217   BindsImplicitObjectArgumentWithoutRefQualifier = false;
218   ObjCLifetimeConversionBinding = false;
219   CopyConstructor = nullptr;
220 }
221 
222 /// getRank - Retrieve the rank of this standard conversion sequence
223 /// (C++ 13.3.3.1.1p3). The rank is the largest rank of each of the
224 /// implicit conversions.
225 ImplicitConversionRank StandardConversionSequence::getRank() const {
226   ImplicitConversionRank Rank = ICR_Exact_Match;
227   if  (GetConversionRank(First) > Rank)
228     Rank = GetConversionRank(First);
229   if  (GetConversionRank(Second) > Rank)
230     Rank = GetConversionRank(Second);
231   if  (GetConversionRank(Third) > Rank)
232     Rank = GetConversionRank(Third);
233   return Rank;
234 }
235 
236 /// isPointerConversionToBool - Determines whether this conversion is
237 /// a conversion of a pointer or pointer-to-member to bool. This is
238 /// used as part of the ranking of standard conversion sequences
239 /// (C++ 13.3.3.2p4).
240 bool StandardConversionSequence::isPointerConversionToBool() const {
241   // Note that FromType has not necessarily been transformed by the
242   // array-to-pointer or function-to-pointer implicit conversions, so
243   // check for their presence as well as checking whether FromType is
244   // a pointer.
245   if (getToType(1)->isBooleanType() &&
246       (getFromType()->isPointerType() ||
247        getFromType()->isObjCObjectPointerType() ||
248        getFromType()->isBlockPointerType() ||
249        getFromType()->isNullPtrType() ||
250        First == ICK_Array_To_Pointer || First == ICK_Function_To_Pointer))
251     return true;
252 
253   return false;
254 }
255 
256 /// isPointerConversionToVoidPointer - Determines whether this
257 /// conversion is a conversion of a pointer to a void pointer. This is
258 /// used as part of the ranking of standard conversion sequences (C++
259 /// 13.3.3.2p4).
260 bool
261 StandardConversionSequence::
262 isPointerConversionToVoidPointer(ASTContext& Context) const {
263   QualType FromType = getFromType();
264   QualType ToType = getToType(1);
265 
266   // Note that FromType has not necessarily been transformed by the
267   // array-to-pointer implicit conversion, so check for its presence
268   // and redo the conversion to get a pointer.
269   if (First == ICK_Array_To_Pointer)
270     FromType = Context.getArrayDecayedType(FromType);
271 
272   if (Second == ICK_Pointer_Conversion && FromType->isAnyPointerType())
273     if (const PointerType* ToPtrType = ToType->getAs<PointerType>())
274       return ToPtrType->getPointeeType()->isVoidType();
275 
276   return false;
277 }
278 
279 /// Skip any implicit casts which could be either part of a narrowing conversion
280 /// or after one in an implicit conversion.
281 static const Expr *IgnoreNarrowingConversion(const Expr *Converted) {
282   while (const ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(Converted)) {
283     switch (ICE->getCastKind()) {
284     case CK_NoOp:
285     case CK_IntegralCast:
286     case CK_IntegralToBoolean:
287     case CK_IntegralToFloating:
288     case CK_FloatingToIntegral:
289     case CK_FloatingToBoolean:
290     case CK_FloatingCast:
291       Converted = ICE->getSubExpr();
292       continue;
293 
294     default:
295       return Converted;
296     }
297   }
298 
299   return Converted;
300 }
301 
302 /// Check if this standard conversion sequence represents a narrowing
303 /// conversion, according to C++11 [dcl.init.list]p7.
304 ///
305 /// \param Ctx  The AST context.
306 /// \param Converted  The result of applying this standard conversion sequence.
307 /// \param ConstantValue  If this is an NK_Constant_Narrowing conversion, the
308 ///        value of the expression prior to the narrowing conversion.
309 /// \param ConstantType  If this is an NK_Constant_Narrowing conversion, the
310 ///        type of the expression prior to the narrowing conversion.
311 NarrowingKind
312 StandardConversionSequence::getNarrowingKind(ASTContext &Ctx,
313                                              const Expr *Converted,
314                                              APValue &ConstantValue,
315                                              QualType &ConstantType) const {
316   assert(Ctx.getLangOpts().CPlusPlus && "narrowing check outside C++");
317 
318   // C++11 [dcl.init.list]p7:
319   //   A narrowing conversion is an implicit conversion ...
320   QualType FromType = getToType(0);
321   QualType ToType = getToType(1);
322   switch (Second) {
323   // -- from a floating-point type to an integer type, or
324   //
325   // -- from an integer type or unscoped enumeration type to a floating-point
326   //    type, except where the source is a constant expression and the actual
327   //    value after conversion will fit into the target type and will produce
328   //    the original value when converted back to the original type, or
329   case ICK_Floating_Integral:
330     if (FromType->isRealFloatingType() && ToType->isIntegralType(Ctx)) {
331       return NK_Type_Narrowing;
332     } else if (FromType->isIntegralType(Ctx) && ToType->isRealFloatingType()) {
333       llvm::APSInt IntConstantValue;
334       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
335       if (Initializer &&
336           Initializer->isIntegerConstantExpr(IntConstantValue, Ctx)) {
337         // Convert the integer to the floating type.
338         llvm::APFloat Result(Ctx.getFloatTypeSemantics(ToType));
339         Result.convertFromAPInt(IntConstantValue, IntConstantValue.isSigned(),
340                                 llvm::APFloat::rmNearestTiesToEven);
341         // And back.
342         llvm::APSInt ConvertedValue = IntConstantValue;
343         bool ignored;
344         Result.convertToInteger(ConvertedValue,
345                                 llvm::APFloat::rmTowardZero, &ignored);
346         // If the resulting value is different, this was a narrowing conversion.
347         if (IntConstantValue != ConvertedValue) {
348           ConstantValue = APValue(IntConstantValue);
349           ConstantType = Initializer->getType();
350           return NK_Constant_Narrowing;
351         }
352       } else {
353         // Variables are always narrowings.
354         return NK_Variable_Narrowing;
355       }
356     }
357     return NK_Not_Narrowing;
358 
359   // -- from long double to double or float, or from double to float, except
360   //    where the source is a constant expression and the actual value after
361   //    conversion is within the range of values that can be represented (even
362   //    if it cannot be represented exactly), or
363   case ICK_Floating_Conversion:
364     if (FromType->isRealFloatingType() && ToType->isRealFloatingType() &&
365         Ctx.getFloatingTypeOrder(FromType, ToType) == 1) {
366       // FromType is larger than ToType.
367       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
368       if (Initializer->isCXX11ConstantExpr(Ctx, &ConstantValue)) {
369         // Constant!
370         assert(ConstantValue.isFloat());
371         llvm::APFloat FloatVal = ConstantValue.getFloat();
372         // Convert the source value into the target type.
373         bool ignored;
374         llvm::APFloat::opStatus ConvertStatus = FloatVal.convert(
375           Ctx.getFloatTypeSemantics(ToType),
376           llvm::APFloat::rmNearestTiesToEven, &ignored);
377         // If there was no overflow, the source value is within the range of
378         // values that can be represented.
379         if (ConvertStatus & llvm::APFloat::opOverflow) {
380           ConstantType = Initializer->getType();
381           return NK_Constant_Narrowing;
382         }
383       } else {
384         return NK_Variable_Narrowing;
385       }
386     }
387     return NK_Not_Narrowing;
388 
389   // -- from an integer type or unscoped enumeration type to an integer type
390   //    that cannot represent all the values of the original type, except where
391   //    the source is a constant expression and the actual value after
392   //    conversion will fit into the target type and will produce the original
393   //    value when converted back to the original type.
394   case ICK_Boolean_Conversion:  // Bools are integers too.
395     if (!FromType->isIntegralOrUnscopedEnumerationType()) {
396       // Boolean conversions can be from pointers and pointers to members
397       // [conv.bool], and those aren't considered narrowing conversions.
398       return NK_Not_Narrowing;
399     }  // Otherwise, fall through to the integral case.
400   case ICK_Integral_Conversion: {
401     assert(FromType->isIntegralOrUnscopedEnumerationType());
402     assert(ToType->isIntegralOrUnscopedEnumerationType());
403     const bool FromSigned = FromType->isSignedIntegerOrEnumerationType();
404     const unsigned FromWidth = Ctx.getIntWidth(FromType);
405     const bool ToSigned = ToType->isSignedIntegerOrEnumerationType();
406     const unsigned ToWidth = Ctx.getIntWidth(ToType);
407 
408     if (FromWidth > ToWidth ||
409         (FromWidth == ToWidth && FromSigned != ToSigned) ||
410         (FromSigned && !ToSigned)) {
411       // Not all values of FromType can be represented in ToType.
412       llvm::APSInt InitializerValue;
413       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
414       if (!Initializer->isIntegerConstantExpr(InitializerValue, Ctx)) {
415         // Such conversions on variables are always narrowing.
416         return NK_Variable_Narrowing;
417       }
418       bool Narrowing = false;
419       if (FromWidth < ToWidth) {
420         // Negative -> unsigned is narrowing. Otherwise, more bits is never
421         // narrowing.
422         if (InitializerValue.isSigned() && InitializerValue.isNegative())
423           Narrowing = true;
424       } else {
425         // Add a bit to the InitializerValue so we don't have to worry about
426         // signed vs. unsigned comparisons.
427         InitializerValue = InitializerValue.extend(
428           InitializerValue.getBitWidth() + 1);
429         // Convert the initializer to and from the target width and signed-ness.
430         llvm::APSInt ConvertedValue = InitializerValue;
431         ConvertedValue = ConvertedValue.trunc(ToWidth);
432         ConvertedValue.setIsSigned(ToSigned);
433         ConvertedValue = ConvertedValue.extend(InitializerValue.getBitWidth());
434         ConvertedValue.setIsSigned(InitializerValue.isSigned());
435         // If the result is different, this was a narrowing conversion.
436         if (ConvertedValue != InitializerValue)
437           Narrowing = true;
438       }
439       if (Narrowing) {
440         ConstantType = Initializer->getType();
441         ConstantValue = APValue(InitializerValue);
442         return NK_Constant_Narrowing;
443       }
444     }
445     return NK_Not_Narrowing;
446   }
447 
448   default:
449     // Other kinds of conversions are not narrowings.
450     return NK_Not_Narrowing;
451   }
452 }
453 
454 /// dump - Print this standard conversion sequence to standard
455 /// error. Useful for debugging overloading issues.
456 void StandardConversionSequence::dump() const {
457   raw_ostream &OS = llvm::errs();
458   bool PrintedSomething = false;
459   if (First != ICK_Identity) {
460     OS << GetImplicitConversionName(First);
461     PrintedSomething = true;
462   }
463 
464   if (Second != ICK_Identity) {
465     if (PrintedSomething) {
466       OS << " -> ";
467     }
468     OS << GetImplicitConversionName(Second);
469 
470     if (CopyConstructor) {
471       OS << " (by copy constructor)";
472     } else if (DirectBinding) {
473       OS << " (direct reference binding)";
474     } else if (ReferenceBinding) {
475       OS << " (reference binding)";
476     }
477     PrintedSomething = true;
478   }
479 
480   if (Third != ICK_Identity) {
481     if (PrintedSomething) {
482       OS << " -> ";
483     }
484     OS << GetImplicitConversionName(Third);
485     PrintedSomething = true;
486   }
487 
488   if (!PrintedSomething) {
489     OS << "No conversions required";
490   }
491 }
492 
493 /// dump - Print this user-defined conversion sequence to standard
494 /// error. Useful for debugging overloading issues.
495 void UserDefinedConversionSequence::dump() const {
496   raw_ostream &OS = llvm::errs();
497   if (Before.First || Before.Second || Before.Third) {
498     Before.dump();
499     OS << " -> ";
500   }
501   if (ConversionFunction)
502     OS << '\'' << *ConversionFunction << '\'';
503   else
504     OS << "aggregate initialization";
505   if (After.First || After.Second || After.Third) {
506     OS << " -> ";
507     After.dump();
508   }
509 }
510 
511 /// dump - Print this implicit conversion sequence to standard
512 /// error. Useful for debugging overloading issues.
513 void ImplicitConversionSequence::dump() const {
514   raw_ostream &OS = llvm::errs();
515   if (isStdInitializerListElement())
516     OS << "Worst std::initializer_list element conversion: ";
517   switch (ConversionKind) {
518   case StandardConversion:
519     OS << "Standard conversion: ";
520     Standard.dump();
521     break;
522   case UserDefinedConversion:
523     OS << "User-defined conversion: ";
524     UserDefined.dump();
525     break;
526   case EllipsisConversion:
527     OS << "Ellipsis conversion";
528     break;
529   case AmbiguousConversion:
530     OS << "Ambiguous conversion";
531     break;
532   case BadConversion:
533     OS << "Bad conversion";
534     break;
535   }
536 
537   OS << "\n";
538 }
539 
540 void AmbiguousConversionSequence::construct() {
541   new (&conversions()) ConversionSet();
542 }
543 
544 void AmbiguousConversionSequence::destruct() {
545   conversions().~ConversionSet();
546 }
547 
548 void
549 AmbiguousConversionSequence::copyFrom(const AmbiguousConversionSequence &O) {
550   FromTypePtr = O.FromTypePtr;
551   ToTypePtr = O.ToTypePtr;
552   new (&conversions()) ConversionSet(O.conversions());
553 }
554 
555 namespace {
556   // Structure used by DeductionFailureInfo to store
557   // template argument information.
558   struct DFIArguments {
559     TemplateArgument FirstArg;
560     TemplateArgument SecondArg;
561   };
562   // Structure used by DeductionFailureInfo to store
563   // template parameter and template argument information.
564   struct DFIParamWithArguments : DFIArguments {
565     TemplateParameter Param;
566   };
567 }
568 
569 /// \brief Convert from Sema's representation of template deduction information
570 /// to the form used in overload-candidate information.
571 DeductionFailureInfo MakeDeductionFailureInfo(ASTContext &Context,
572                                               Sema::TemplateDeductionResult TDK,
573                                               TemplateDeductionInfo &Info) {
574   DeductionFailureInfo Result;
575   Result.Result = static_cast<unsigned>(TDK);
576   Result.HasDiagnostic = false;
577   Result.Data = nullptr;
578   switch (TDK) {
579   case Sema::TDK_Success:
580   case Sema::TDK_Invalid:
581   case Sema::TDK_InstantiationDepth:
582   case Sema::TDK_TooManyArguments:
583   case Sema::TDK_TooFewArguments:
584     break;
585 
586   case Sema::TDK_Incomplete:
587   case Sema::TDK_InvalidExplicitArguments:
588     Result.Data = Info.Param.getOpaqueValue();
589     break;
590 
591   case Sema::TDK_NonDeducedMismatch: {
592     // FIXME: Should allocate from normal heap so that we can free this later.
593     DFIArguments *Saved = new (Context) DFIArguments;
594     Saved->FirstArg = Info.FirstArg;
595     Saved->SecondArg = Info.SecondArg;
596     Result.Data = Saved;
597     break;
598   }
599 
600   case Sema::TDK_Inconsistent:
601   case Sema::TDK_Underqualified: {
602     // FIXME: Should allocate from normal heap so that we can free this later.
603     DFIParamWithArguments *Saved = new (Context) DFIParamWithArguments;
604     Saved->Param = Info.Param;
605     Saved->FirstArg = Info.FirstArg;
606     Saved->SecondArg = Info.SecondArg;
607     Result.Data = Saved;
608     break;
609   }
610 
611   case Sema::TDK_SubstitutionFailure:
612     Result.Data = Info.take();
613     if (Info.hasSFINAEDiagnostic()) {
614       PartialDiagnosticAt *Diag = new (Result.Diagnostic) PartialDiagnosticAt(
615           SourceLocation(), PartialDiagnostic::NullDiagnostic());
616       Info.takeSFINAEDiagnostic(*Diag);
617       Result.HasDiagnostic = true;
618     }
619     break;
620 
621   case Sema::TDK_FailedOverloadResolution:
622     Result.Data = Info.Expression;
623     break;
624 
625   case Sema::TDK_MiscellaneousDeductionFailure:
626     break;
627   }
628 
629   return Result;
630 }
631 
632 void DeductionFailureInfo::Destroy() {
633   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
634   case Sema::TDK_Success:
635   case Sema::TDK_Invalid:
636   case Sema::TDK_InstantiationDepth:
637   case Sema::TDK_Incomplete:
638   case Sema::TDK_TooManyArguments:
639   case Sema::TDK_TooFewArguments:
640   case Sema::TDK_InvalidExplicitArguments:
641   case Sema::TDK_FailedOverloadResolution:
642     break;
643 
644   case Sema::TDK_Inconsistent:
645   case Sema::TDK_Underqualified:
646   case Sema::TDK_NonDeducedMismatch:
647     // FIXME: Destroy the data?
648     Data = nullptr;
649     break;
650 
651   case Sema::TDK_SubstitutionFailure:
652     // FIXME: Destroy the template argument list?
653     Data = nullptr;
654     if (PartialDiagnosticAt *Diag = getSFINAEDiagnostic()) {
655       Diag->~PartialDiagnosticAt();
656       HasDiagnostic = false;
657     }
658     break;
659 
660   // Unhandled
661   case Sema::TDK_MiscellaneousDeductionFailure:
662     break;
663   }
664 }
665 
666 PartialDiagnosticAt *DeductionFailureInfo::getSFINAEDiagnostic() {
667   if (HasDiagnostic)
668     return static_cast<PartialDiagnosticAt*>(static_cast<void*>(Diagnostic));
669   return nullptr;
670 }
671 
672 TemplateParameter DeductionFailureInfo::getTemplateParameter() {
673   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
674   case Sema::TDK_Success:
675   case Sema::TDK_Invalid:
676   case Sema::TDK_InstantiationDepth:
677   case Sema::TDK_TooManyArguments:
678   case Sema::TDK_TooFewArguments:
679   case Sema::TDK_SubstitutionFailure:
680   case Sema::TDK_NonDeducedMismatch:
681   case Sema::TDK_FailedOverloadResolution:
682     return TemplateParameter();
683 
684   case Sema::TDK_Incomplete:
685   case Sema::TDK_InvalidExplicitArguments:
686     return TemplateParameter::getFromOpaqueValue(Data);
687 
688   case Sema::TDK_Inconsistent:
689   case Sema::TDK_Underqualified:
690     return static_cast<DFIParamWithArguments*>(Data)->Param;
691 
692   // Unhandled
693   case Sema::TDK_MiscellaneousDeductionFailure:
694     break;
695   }
696 
697   return TemplateParameter();
698 }
699 
700 TemplateArgumentList *DeductionFailureInfo::getTemplateArgumentList() {
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_Incomplete:
708   case Sema::TDK_InvalidExplicitArguments:
709   case Sema::TDK_Inconsistent:
710   case Sema::TDK_Underqualified:
711   case Sema::TDK_NonDeducedMismatch:
712   case Sema::TDK_FailedOverloadResolution:
713     return nullptr;
714 
715   case Sema::TDK_SubstitutionFailure:
716     return static_cast<TemplateArgumentList*>(Data);
717 
718   // Unhandled
719   case Sema::TDK_MiscellaneousDeductionFailure:
720     break;
721   }
722 
723   return nullptr;
724 }
725 
726 const TemplateArgument *DeductionFailureInfo::getFirstArg() {
727   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
728   case Sema::TDK_Success:
729   case Sema::TDK_Invalid:
730   case Sema::TDK_InstantiationDepth:
731   case Sema::TDK_Incomplete:
732   case Sema::TDK_TooManyArguments:
733   case Sema::TDK_TooFewArguments:
734   case Sema::TDK_InvalidExplicitArguments:
735   case Sema::TDK_SubstitutionFailure:
736   case Sema::TDK_FailedOverloadResolution:
737     return nullptr;
738 
739   case Sema::TDK_Inconsistent:
740   case Sema::TDK_Underqualified:
741   case Sema::TDK_NonDeducedMismatch:
742     return &static_cast<DFIArguments*>(Data)->FirstArg;
743 
744   // Unhandled
745   case Sema::TDK_MiscellaneousDeductionFailure:
746     break;
747   }
748 
749   return nullptr;
750 }
751 
752 const TemplateArgument *DeductionFailureInfo::getSecondArg() {
753   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
754   case Sema::TDK_Success:
755   case Sema::TDK_Invalid:
756   case Sema::TDK_InstantiationDepth:
757   case Sema::TDK_Incomplete:
758   case Sema::TDK_TooManyArguments:
759   case Sema::TDK_TooFewArguments:
760   case Sema::TDK_InvalidExplicitArguments:
761   case Sema::TDK_SubstitutionFailure:
762   case Sema::TDK_FailedOverloadResolution:
763     return nullptr;
764 
765   case Sema::TDK_Inconsistent:
766   case Sema::TDK_Underqualified:
767   case Sema::TDK_NonDeducedMismatch:
768     return &static_cast<DFIArguments*>(Data)->SecondArg;
769 
770   // Unhandled
771   case Sema::TDK_MiscellaneousDeductionFailure:
772     break;
773   }
774 
775   return nullptr;
776 }
777 
778 Expr *DeductionFailureInfo::getExpr() {
779   if (static_cast<Sema::TemplateDeductionResult>(Result) ==
780         Sema::TDK_FailedOverloadResolution)
781     return static_cast<Expr*>(Data);
782 
783   return nullptr;
784 }
785 
786 void OverloadCandidateSet::destroyCandidates() {
787   for (iterator i = begin(), e = end(); i != e; ++i) {
788     for (unsigned ii = 0, ie = i->NumConversions; ii != ie; ++ii)
789       i->Conversions[ii].~ImplicitConversionSequence();
790     if (!i->Viable && i->FailureKind == ovl_fail_bad_deduction)
791       i->DeductionFailure.Destroy();
792   }
793 }
794 
795 void OverloadCandidateSet::clear() {
796   destroyCandidates();
797   NumInlineSequences = 0;
798   Candidates.clear();
799   Functions.clear();
800 }
801 
802 namespace {
803   class UnbridgedCastsSet {
804     struct Entry {
805       Expr **Addr;
806       Expr *Saved;
807     };
808     SmallVector<Entry, 2> Entries;
809 
810   public:
811     void save(Sema &S, Expr *&E) {
812       assert(E->hasPlaceholderType(BuiltinType::ARCUnbridgedCast));
813       Entry entry = { &E, E };
814       Entries.push_back(entry);
815       E = S.stripARCUnbridgedCast(E);
816     }
817 
818     void restore() {
819       for (SmallVectorImpl<Entry>::iterator
820              i = Entries.begin(), e = Entries.end(); i != e; ++i)
821         *i->Addr = i->Saved;
822     }
823   };
824 }
825 
826 /// checkPlaceholderForOverload - Do any interesting placeholder-like
827 /// preprocessing on the given expression.
828 ///
829 /// \param unbridgedCasts a collection to which to add unbridged casts;
830 ///   without this, they will be immediately diagnosed as errors
831 ///
832 /// Return true on unrecoverable error.
833 static bool
834 checkPlaceholderForOverload(Sema &S, Expr *&E,
835                             UnbridgedCastsSet *unbridgedCasts = nullptr) {
836   if (const BuiltinType *placeholder =  E->getType()->getAsPlaceholderType()) {
837     // We can't handle overloaded expressions here because overload
838     // resolution might reasonably tweak them.
839     if (placeholder->getKind() == BuiltinType::Overload) return false;
840 
841     // If the context potentially accepts unbridged ARC casts, strip
842     // the unbridged cast and add it to the collection for later restoration.
843     if (placeholder->getKind() == BuiltinType::ARCUnbridgedCast &&
844         unbridgedCasts) {
845       unbridgedCasts->save(S, E);
846       return false;
847     }
848 
849     // Go ahead and check everything else.
850     ExprResult result = S.CheckPlaceholderExpr(E);
851     if (result.isInvalid())
852       return true;
853 
854     E = result.get();
855     return false;
856   }
857 
858   // Nothing to do.
859   return false;
860 }
861 
862 /// checkArgPlaceholdersForOverload - Check a set of call operands for
863 /// placeholders.
864 static bool checkArgPlaceholdersForOverload(Sema &S,
865                                             MultiExprArg Args,
866                                             UnbridgedCastsSet &unbridged) {
867   for (unsigned i = 0, e = Args.size(); i != e; ++i)
868     if (checkPlaceholderForOverload(S, Args[i], &unbridged))
869       return true;
870 
871   return false;
872 }
873 
874 // IsOverload - Determine whether the given New declaration is an
875 // overload of the declarations in Old. This routine returns false if
876 // New and Old cannot be overloaded, e.g., if New has the same
877 // signature as some function in Old (C++ 1.3.10) or if the Old
878 // declarations aren't functions (or function templates) at all. When
879 // it does return false, MatchedDecl will point to the decl that New
880 // cannot be overloaded with.  This decl may be a UsingShadowDecl on
881 // top of the underlying declaration.
882 //
883 // Example: Given the following input:
884 //
885 //   void f(int, float); // #1
886 //   void f(int, int); // #2
887 //   int f(int, int); // #3
888 //
889 // When we process #1, there is no previous declaration of "f",
890 // so IsOverload will not be used.
891 //
892 // When we process #2, Old contains only the FunctionDecl for #1.  By
893 // comparing the parameter types, we see that #1 and #2 are overloaded
894 // (since they have different signatures), so this routine returns
895 // false; MatchedDecl is unchanged.
896 //
897 // When we process #3, Old is an overload set containing #1 and #2. We
898 // compare the signatures of #3 to #1 (they're overloaded, so we do
899 // nothing) and then #3 to #2. Since the signatures of #3 and #2 are
900 // identical (return types of functions are not part of the
901 // signature), IsOverload returns false and MatchedDecl will be set to
902 // point to the FunctionDecl for #2.
903 //
904 // 'NewIsUsingShadowDecl' indicates that 'New' is being introduced
905 // into a class by a using declaration.  The rules for whether to hide
906 // shadow declarations ignore some properties which otherwise figure
907 // into a function template's signature.
908 Sema::OverloadKind
909 Sema::CheckOverload(Scope *S, FunctionDecl *New, const LookupResult &Old,
910                     NamedDecl *&Match, bool NewIsUsingDecl) {
911   for (LookupResult::iterator I = Old.begin(), E = Old.end();
912          I != E; ++I) {
913     NamedDecl *OldD = *I;
914 
915     bool OldIsUsingDecl = false;
916     if (isa<UsingShadowDecl>(OldD)) {
917       OldIsUsingDecl = true;
918 
919       // We can always introduce two using declarations into the same
920       // context, even if they have identical signatures.
921       if (NewIsUsingDecl) continue;
922 
923       OldD = cast<UsingShadowDecl>(OldD)->getTargetDecl();
924     }
925 
926     // If either declaration was introduced by a using declaration,
927     // we'll need to use slightly different rules for matching.
928     // Essentially, these rules are the normal rules, except that
929     // function templates hide function templates with different
930     // return types or template parameter lists.
931     bool UseMemberUsingDeclRules =
932       (OldIsUsingDecl || NewIsUsingDecl) && CurContext->isRecord() &&
933       !New->getFriendObjectKind();
934 
935     if (FunctionDecl *OldF = OldD->getAsFunction()) {
936       if (!IsOverload(New, OldF, UseMemberUsingDeclRules)) {
937         if (UseMemberUsingDeclRules && OldIsUsingDecl) {
938           HideUsingShadowDecl(S, cast<UsingShadowDecl>(*I));
939           continue;
940         }
941 
942         if (!isa<FunctionTemplateDecl>(OldD) &&
943             !shouldLinkPossiblyHiddenDecl(*I, New))
944           continue;
945 
946         Match = *I;
947         return Ovl_Match;
948       }
949     } else if (isa<UsingDecl>(OldD)) {
950       // We can overload with these, which can show up when doing
951       // redeclaration checks for UsingDecls.
952       assert(Old.getLookupKind() == LookupUsingDeclName);
953     } else if (isa<TagDecl>(OldD)) {
954       // We can always overload with tags by hiding them.
955     } else if (isa<UnresolvedUsingValueDecl>(OldD)) {
956       // Optimistically assume that an unresolved using decl will
957       // overload; if it doesn't, we'll have to diagnose during
958       // template instantiation.
959     } else {
960       // (C++ 13p1):
961       //   Only function declarations can be overloaded; object and type
962       //   declarations cannot be overloaded.
963       Match = *I;
964       return Ovl_NonFunction;
965     }
966   }
967 
968   return Ovl_Overload;
969 }
970 
971 bool Sema::IsOverload(FunctionDecl *New, FunctionDecl *Old,
972                       bool UseUsingDeclRules) {
973   // C++ [basic.start.main]p2: This function shall not be overloaded.
974   if (New->isMain())
975     return false;
976 
977   // MSVCRT user defined entry points cannot be overloaded.
978   if (New->isMSVCRTEntryPoint())
979     return false;
980 
981   FunctionTemplateDecl *OldTemplate = Old->getDescribedFunctionTemplate();
982   FunctionTemplateDecl *NewTemplate = New->getDescribedFunctionTemplate();
983 
984   // C++ [temp.fct]p2:
985   //   A function template can be overloaded with other function templates
986   //   and with normal (non-template) functions.
987   if ((OldTemplate == nullptr) != (NewTemplate == nullptr))
988     return true;
989 
990   // Is the function New an overload of the function Old?
991   QualType OldQType = Context.getCanonicalType(Old->getType());
992   QualType NewQType = Context.getCanonicalType(New->getType());
993 
994   // Compare the signatures (C++ 1.3.10) of the two functions to
995   // determine whether they are overloads. If we find any mismatch
996   // in the signature, they are overloads.
997 
998   // If either of these functions is a K&R-style function (no
999   // prototype), then we consider them to have matching signatures.
1000   if (isa<FunctionNoProtoType>(OldQType.getTypePtr()) ||
1001       isa<FunctionNoProtoType>(NewQType.getTypePtr()))
1002     return false;
1003 
1004   const FunctionProtoType *OldType = cast<FunctionProtoType>(OldQType);
1005   const FunctionProtoType *NewType = cast<FunctionProtoType>(NewQType);
1006 
1007   // The signature of a function includes the types of its
1008   // parameters (C++ 1.3.10), which includes the presence or absence
1009   // of the ellipsis; see C++ DR 357).
1010   if (OldQType != NewQType &&
1011       (OldType->getNumParams() != NewType->getNumParams() ||
1012        OldType->isVariadic() != NewType->isVariadic() ||
1013        !FunctionParamTypesAreEqual(OldType, NewType)))
1014     return true;
1015 
1016   // C++ [temp.over.link]p4:
1017   //   The signature of a function template consists of its function
1018   //   signature, its return type and its template parameter list. The names
1019   //   of the template parameters are significant only for establishing the
1020   //   relationship between the template parameters and the rest of the
1021   //   signature.
1022   //
1023   // We check the return type and template parameter lists for function
1024   // templates first; the remaining checks follow.
1025   //
1026   // However, we don't consider either of these when deciding whether
1027   // a member introduced by a shadow declaration is hidden.
1028   if (!UseUsingDeclRules && NewTemplate &&
1029       (!TemplateParameterListsAreEqual(NewTemplate->getTemplateParameters(),
1030                                        OldTemplate->getTemplateParameters(),
1031                                        false, TPL_TemplateMatch) ||
1032        OldType->getReturnType() != NewType->getReturnType()))
1033     return true;
1034 
1035   // If the function is a class member, its signature includes the
1036   // cv-qualifiers (if any) and ref-qualifier (if any) on the function itself.
1037   //
1038   // As part of this, also check whether one of the member functions
1039   // is static, in which case they are not overloads (C++
1040   // 13.1p2). While not part of the definition of the signature,
1041   // this check is important to determine whether these functions
1042   // can be overloaded.
1043   CXXMethodDecl *OldMethod = dyn_cast<CXXMethodDecl>(Old);
1044   CXXMethodDecl *NewMethod = dyn_cast<CXXMethodDecl>(New);
1045   if (OldMethod && NewMethod &&
1046       !OldMethod->isStatic() && !NewMethod->isStatic()) {
1047     if (OldMethod->getRefQualifier() != NewMethod->getRefQualifier()) {
1048       if (!UseUsingDeclRules &&
1049           (OldMethod->getRefQualifier() == RQ_None ||
1050            NewMethod->getRefQualifier() == RQ_None)) {
1051         // C++0x [over.load]p2:
1052         //   - Member function declarations with the same name and the same
1053         //     parameter-type-list as well as member function template
1054         //     declarations with the same name, the same parameter-type-list, and
1055         //     the same template parameter lists cannot be overloaded if any of
1056         //     them, but not all, have a ref-qualifier (8.3.5).
1057         Diag(NewMethod->getLocation(), diag::err_ref_qualifier_overload)
1058           << NewMethod->getRefQualifier() << OldMethod->getRefQualifier();
1059         Diag(OldMethod->getLocation(), diag::note_previous_declaration);
1060       }
1061       return true;
1062     }
1063 
1064     // We may not have applied the implicit const for a constexpr member
1065     // function yet (because we haven't yet resolved whether this is a static
1066     // or non-static member function). Add it now, on the assumption that this
1067     // is a redeclaration of OldMethod.
1068     unsigned OldQuals = OldMethod->getTypeQualifiers();
1069     unsigned NewQuals = NewMethod->getTypeQualifiers();
1070     if (!getLangOpts().CPlusPlus14 && NewMethod->isConstexpr() &&
1071         !isa<CXXConstructorDecl>(NewMethod))
1072       NewQuals |= Qualifiers::Const;
1073 
1074     // We do not allow overloading based off of '__restrict'.
1075     OldQuals &= ~Qualifiers::Restrict;
1076     NewQuals &= ~Qualifiers::Restrict;
1077     if (OldQuals != NewQuals)
1078       return true;
1079   }
1080 
1081   // enable_if attributes are an order-sensitive part of the signature.
1082   for (specific_attr_iterator<EnableIfAttr>
1083          NewI = New->specific_attr_begin<EnableIfAttr>(),
1084          NewE = New->specific_attr_end<EnableIfAttr>(),
1085          OldI = Old->specific_attr_begin<EnableIfAttr>(),
1086          OldE = Old->specific_attr_end<EnableIfAttr>();
1087        NewI != NewE || OldI != OldE; ++NewI, ++OldI) {
1088     if (NewI == NewE || OldI == OldE)
1089       return true;
1090     llvm::FoldingSetNodeID NewID, OldID;
1091     NewI->getCond()->Profile(NewID, Context, true);
1092     OldI->getCond()->Profile(OldID, Context, true);
1093     if (NewID != OldID)
1094       return true;
1095   }
1096 
1097   // The signatures match; this is not an overload.
1098   return false;
1099 }
1100 
1101 /// \brief Checks availability of the function depending on the current
1102 /// function context. Inside an unavailable function, unavailability is ignored.
1103 ///
1104 /// \returns true if \arg FD is unavailable and current context is inside
1105 /// an available function, false otherwise.
1106 bool Sema::isFunctionConsideredUnavailable(FunctionDecl *FD) {
1107   return FD->isUnavailable() && !cast<Decl>(CurContext)->isUnavailable();
1108 }
1109 
1110 /// \brief Tries a user-defined conversion from From to ToType.
1111 ///
1112 /// Produces an implicit conversion sequence for when a standard conversion
1113 /// is not an option. See TryImplicitConversion for more information.
1114 static ImplicitConversionSequence
1115 TryUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
1116                          bool SuppressUserConversions,
1117                          bool AllowExplicit,
1118                          bool InOverloadResolution,
1119                          bool CStyle,
1120                          bool AllowObjCWritebackConversion,
1121                          bool AllowObjCConversionOnExplicit) {
1122   ImplicitConversionSequence ICS;
1123 
1124   if (SuppressUserConversions) {
1125     // We're not in the case above, so there is no conversion that
1126     // we can perform.
1127     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1128     return ICS;
1129   }
1130 
1131   // Attempt user-defined conversion.
1132   OverloadCandidateSet Conversions(From->getExprLoc(),
1133                                    OverloadCandidateSet::CSK_Normal);
1134   OverloadingResult UserDefResult
1135     = IsUserDefinedConversion(S, From, ToType, ICS.UserDefined, Conversions,
1136                               AllowExplicit, AllowObjCConversionOnExplicit);
1137 
1138   if (UserDefResult == OR_Success) {
1139     ICS.setUserDefined();
1140     ICS.UserDefined.Before.setAsIdentityConversion();
1141     // C++ [over.ics.user]p4:
1142     //   A conversion of an expression of class type to the same class
1143     //   type is given Exact Match rank, and a conversion of an
1144     //   expression of class type to a base class of that type is
1145     //   given Conversion rank, in spite of the fact that a copy
1146     //   constructor (i.e., a user-defined conversion function) is
1147     //   called for those cases.
1148     if (CXXConstructorDecl *Constructor
1149           = dyn_cast<CXXConstructorDecl>(ICS.UserDefined.ConversionFunction)) {
1150       QualType FromCanon
1151         = S.Context.getCanonicalType(From->getType().getUnqualifiedType());
1152       QualType ToCanon
1153         = S.Context.getCanonicalType(ToType).getUnqualifiedType();
1154       if (Constructor->isCopyConstructor() &&
1155           (FromCanon == ToCanon || S.IsDerivedFrom(FromCanon, ToCanon))) {
1156         // Turn this into a "standard" conversion sequence, so that it
1157         // gets ranked with standard conversion sequences.
1158         ICS.setStandard();
1159         ICS.Standard.setAsIdentityConversion();
1160         ICS.Standard.setFromType(From->getType());
1161         ICS.Standard.setAllToTypes(ToType);
1162         ICS.Standard.CopyConstructor = Constructor;
1163         if (ToCanon != FromCanon)
1164           ICS.Standard.Second = ICK_Derived_To_Base;
1165       }
1166     }
1167   } else if (UserDefResult == OR_Ambiguous && !SuppressUserConversions) {
1168     ICS.setAmbiguous();
1169     ICS.Ambiguous.setFromType(From->getType());
1170     ICS.Ambiguous.setToType(ToType);
1171     for (OverloadCandidateSet::iterator Cand = Conversions.begin();
1172          Cand != Conversions.end(); ++Cand)
1173       if (Cand->Viable)
1174         ICS.Ambiguous.addConversion(Cand->Function);
1175   } else {
1176     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1177   }
1178 
1179   return ICS;
1180 }
1181 
1182 /// TryImplicitConversion - Attempt to perform an implicit conversion
1183 /// from the given expression (Expr) to the given type (ToType). This
1184 /// function returns an implicit conversion sequence that can be used
1185 /// to perform the initialization. Given
1186 ///
1187 ///   void f(float f);
1188 ///   void g(int i) { f(i); }
1189 ///
1190 /// this routine would produce an implicit conversion sequence to
1191 /// describe the initialization of f from i, which will be a standard
1192 /// conversion sequence containing an lvalue-to-rvalue conversion (C++
1193 /// 4.1) followed by a floating-integral conversion (C++ 4.9).
1194 //
1195 /// Note that this routine only determines how the conversion can be
1196 /// performed; it does not actually perform the conversion. As such,
1197 /// it will not produce any diagnostics if no conversion is available,
1198 /// but will instead return an implicit conversion sequence of kind
1199 /// "BadConversion".
1200 ///
1201 /// If @p SuppressUserConversions, then user-defined conversions are
1202 /// not permitted.
1203 /// If @p AllowExplicit, then explicit user-defined conversions are
1204 /// permitted.
1205 ///
1206 /// \param AllowObjCWritebackConversion Whether we allow the Objective-C
1207 /// writeback conversion, which allows __autoreleasing id* parameters to
1208 /// be initialized with __strong id* or __weak id* arguments.
1209 static ImplicitConversionSequence
1210 TryImplicitConversion(Sema &S, Expr *From, QualType ToType,
1211                       bool SuppressUserConversions,
1212                       bool AllowExplicit,
1213                       bool InOverloadResolution,
1214                       bool CStyle,
1215                       bool AllowObjCWritebackConversion,
1216                       bool AllowObjCConversionOnExplicit) {
1217   ImplicitConversionSequence ICS;
1218   if (IsStandardConversion(S, From, ToType, InOverloadResolution,
1219                            ICS.Standard, CStyle, AllowObjCWritebackConversion)){
1220     ICS.setStandard();
1221     return ICS;
1222   }
1223 
1224   if (!S.getLangOpts().CPlusPlus) {
1225     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1226     return ICS;
1227   }
1228 
1229   // C++ [over.ics.user]p4:
1230   //   A conversion of an expression of class type to the same class
1231   //   type is given Exact Match rank, and a conversion of an
1232   //   expression of class type to a base class of that type is
1233   //   given Conversion rank, in spite of the fact that a copy/move
1234   //   constructor (i.e., a user-defined conversion function) is
1235   //   called for those cases.
1236   QualType FromType = From->getType();
1237   if (ToType->getAs<RecordType>() && FromType->getAs<RecordType>() &&
1238       (S.Context.hasSameUnqualifiedType(FromType, ToType) ||
1239        S.IsDerivedFrom(FromType, ToType))) {
1240     ICS.setStandard();
1241     ICS.Standard.setAsIdentityConversion();
1242     ICS.Standard.setFromType(FromType);
1243     ICS.Standard.setAllToTypes(ToType);
1244 
1245     // We don't actually check at this point whether there is a valid
1246     // copy/move constructor, since overloading just assumes that it
1247     // exists. When we actually perform initialization, we'll find the
1248     // appropriate constructor to copy the returned object, if needed.
1249     ICS.Standard.CopyConstructor = nullptr;
1250 
1251     // Determine whether this is considered a derived-to-base conversion.
1252     if (!S.Context.hasSameUnqualifiedType(FromType, ToType))
1253       ICS.Standard.Second = ICK_Derived_To_Base;
1254 
1255     return ICS;
1256   }
1257 
1258   return TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
1259                                   AllowExplicit, InOverloadResolution, CStyle,
1260                                   AllowObjCWritebackConversion,
1261                                   AllowObjCConversionOnExplicit);
1262 }
1263 
1264 ImplicitConversionSequence
1265 Sema::TryImplicitConversion(Expr *From, QualType ToType,
1266                             bool SuppressUserConversions,
1267                             bool AllowExplicit,
1268                             bool InOverloadResolution,
1269                             bool CStyle,
1270                             bool AllowObjCWritebackConversion) {
1271   return clang::TryImplicitConversion(*this, From, ToType,
1272                                       SuppressUserConversions, AllowExplicit,
1273                                       InOverloadResolution, CStyle,
1274                                       AllowObjCWritebackConversion,
1275                                       /*AllowObjCConversionOnExplicit=*/false);
1276 }
1277 
1278 /// PerformImplicitConversion - Perform an implicit conversion of the
1279 /// expression From to the type ToType. Returns the
1280 /// converted expression. Flavor is the kind of conversion we're
1281 /// performing, used in the error message. If @p AllowExplicit,
1282 /// explicit user-defined conversions are permitted.
1283 ExprResult
1284 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1285                                 AssignmentAction Action, bool AllowExplicit) {
1286   ImplicitConversionSequence ICS;
1287   return PerformImplicitConversion(From, ToType, Action, AllowExplicit, ICS);
1288 }
1289 
1290 ExprResult
1291 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1292                                 AssignmentAction Action, bool AllowExplicit,
1293                                 ImplicitConversionSequence& ICS) {
1294   if (checkPlaceholderForOverload(*this, From))
1295     return ExprError();
1296 
1297   // Objective-C ARC: Determine whether we will allow the writeback conversion.
1298   bool AllowObjCWritebackConversion
1299     = getLangOpts().ObjCAutoRefCount &&
1300       (Action == AA_Passing || Action == AA_Sending);
1301   if (getLangOpts().ObjC1)
1302     CheckObjCBridgeRelatedConversions(From->getLocStart(),
1303                                       ToType, From->getType(), From);
1304   ICS = clang::TryImplicitConversion(*this, From, ToType,
1305                                      /*SuppressUserConversions=*/false,
1306                                      AllowExplicit,
1307                                      /*InOverloadResolution=*/false,
1308                                      /*CStyle=*/false,
1309                                      AllowObjCWritebackConversion,
1310                                      /*AllowObjCConversionOnExplicit=*/false);
1311   return PerformImplicitConversion(From, ToType, ICS, Action);
1312 }
1313 
1314 /// \brief Determine whether the conversion from FromType to ToType is a valid
1315 /// conversion that strips "noreturn" off the nested function type.
1316 bool Sema::IsNoReturnConversion(QualType FromType, QualType ToType,
1317                                 QualType &ResultTy) {
1318   if (Context.hasSameUnqualifiedType(FromType, ToType))
1319     return false;
1320 
1321   // Permit the conversion F(t __attribute__((noreturn))) -> F(t)
1322   // where F adds one of the following at most once:
1323   //   - a pointer
1324   //   - a member pointer
1325   //   - a block pointer
1326   CanQualType CanTo = Context.getCanonicalType(ToType);
1327   CanQualType CanFrom = Context.getCanonicalType(FromType);
1328   Type::TypeClass TyClass = CanTo->getTypeClass();
1329   if (TyClass != CanFrom->getTypeClass()) return false;
1330   if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto) {
1331     if (TyClass == Type::Pointer) {
1332       CanTo = CanTo.getAs<PointerType>()->getPointeeType();
1333       CanFrom = CanFrom.getAs<PointerType>()->getPointeeType();
1334     } else if (TyClass == Type::BlockPointer) {
1335       CanTo = CanTo.getAs<BlockPointerType>()->getPointeeType();
1336       CanFrom = CanFrom.getAs<BlockPointerType>()->getPointeeType();
1337     } else if (TyClass == Type::MemberPointer) {
1338       CanTo = CanTo.getAs<MemberPointerType>()->getPointeeType();
1339       CanFrom = CanFrom.getAs<MemberPointerType>()->getPointeeType();
1340     } else {
1341       return false;
1342     }
1343 
1344     TyClass = CanTo->getTypeClass();
1345     if (TyClass != CanFrom->getTypeClass()) return false;
1346     if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto)
1347       return false;
1348   }
1349 
1350   const FunctionType *FromFn = cast<FunctionType>(CanFrom);
1351   FunctionType::ExtInfo EInfo = FromFn->getExtInfo();
1352   if (!EInfo.getNoReturn()) return false;
1353 
1354   FromFn = Context.adjustFunctionType(FromFn, EInfo.withNoReturn(false));
1355   assert(QualType(FromFn, 0).isCanonical());
1356   if (QualType(FromFn, 0) != CanTo) return false;
1357 
1358   ResultTy = ToType;
1359   return true;
1360 }
1361 
1362 /// \brief Determine whether the conversion from FromType to ToType is a valid
1363 /// vector conversion.
1364 ///
1365 /// \param ICK Will be set to the vector conversion kind, if this is a vector
1366 /// conversion.
1367 static bool IsVectorConversion(Sema &S, QualType FromType,
1368                                QualType ToType, ImplicitConversionKind &ICK) {
1369   // We need at least one of these types to be a vector type to have a vector
1370   // conversion.
1371   if (!ToType->isVectorType() && !FromType->isVectorType())
1372     return false;
1373 
1374   // Identical types require no conversions.
1375   if (S.Context.hasSameUnqualifiedType(FromType, ToType))
1376     return false;
1377 
1378   // There are no conversions between extended vector types, only identity.
1379   if (ToType->isExtVectorType()) {
1380     // There are no conversions between extended vector types other than the
1381     // identity conversion.
1382     if (FromType->isExtVectorType())
1383       return false;
1384 
1385     // Vector splat from any arithmetic type to a vector.
1386     if (FromType->isArithmeticType()) {
1387       ICK = ICK_Vector_Splat;
1388       return true;
1389     }
1390   }
1391 
1392   // We can perform the conversion between vector types in the following cases:
1393   // 1)vector types are equivalent AltiVec and GCC vector types
1394   // 2)lax vector conversions are permitted and the vector types are of the
1395   //   same size
1396   if (ToType->isVectorType() && FromType->isVectorType()) {
1397     if (S.Context.areCompatibleVectorTypes(FromType, ToType) ||
1398         S.isLaxVectorConversion(FromType, ToType)) {
1399       ICK = ICK_Vector_Conversion;
1400       return true;
1401     }
1402   }
1403 
1404   return false;
1405 }
1406 
1407 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
1408                                 bool InOverloadResolution,
1409                                 StandardConversionSequence &SCS,
1410                                 bool CStyle);
1411 
1412 /// IsStandardConversion - Determines whether there is a standard
1413 /// conversion sequence (C++ [conv], C++ [over.ics.scs]) from the
1414 /// expression From to the type ToType. Standard conversion sequences
1415 /// only consider non-class types; for conversions that involve class
1416 /// types, use TryImplicitConversion. If a conversion exists, SCS will
1417 /// contain the standard conversion sequence required to perform this
1418 /// conversion and this routine will return true. Otherwise, this
1419 /// routine will return false and the value of SCS is unspecified.
1420 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
1421                                  bool InOverloadResolution,
1422                                  StandardConversionSequence &SCS,
1423                                  bool CStyle,
1424                                  bool AllowObjCWritebackConversion) {
1425   QualType FromType = From->getType();
1426 
1427   // Standard conversions (C++ [conv])
1428   SCS.setAsIdentityConversion();
1429   SCS.IncompatibleObjC = false;
1430   SCS.setFromType(FromType);
1431   SCS.CopyConstructor = nullptr;
1432 
1433   // There are no standard conversions for class types in C++, so
1434   // abort early. When overloading in C, however, we do permit
1435   if (FromType->isRecordType() || ToType->isRecordType()) {
1436     if (S.getLangOpts().CPlusPlus)
1437       return false;
1438 
1439     // When we're overloading in C, we allow, as standard conversions,
1440   }
1441 
1442   // The first conversion can be an lvalue-to-rvalue conversion,
1443   // array-to-pointer conversion, or function-to-pointer conversion
1444   // (C++ 4p1).
1445 
1446   if (FromType == S.Context.OverloadTy) {
1447     DeclAccessPair AccessPair;
1448     if (FunctionDecl *Fn
1449           = S.ResolveAddressOfOverloadedFunction(From, ToType, false,
1450                                                  AccessPair)) {
1451       // We were able to resolve the address of the overloaded function,
1452       // so we can convert to the type of that function.
1453       FromType = Fn->getType();
1454       SCS.setFromType(FromType);
1455 
1456       // we can sometimes resolve &foo<int> regardless of ToType, so check
1457       // if the type matches (identity) or we are converting to bool
1458       if (!S.Context.hasSameUnqualifiedType(
1459                       S.ExtractUnqualifiedFunctionType(ToType), FromType)) {
1460         QualType resultTy;
1461         // if the function type matches except for [[noreturn]], it's ok
1462         if (!S.IsNoReturnConversion(FromType,
1463               S.ExtractUnqualifiedFunctionType(ToType), resultTy))
1464           // otherwise, only a boolean conversion is standard
1465           if (!ToType->isBooleanType())
1466             return false;
1467       }
1468 
1469       // Check if the "from" expression is taking the address of an overloaded
1470       // function and recompute the FromType accordingly. Take advantage of the
1471       // fact that non-static member functions *must* have such an address-of
1472       // expression.
1473       CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn);
1474       if (Method && !Method->isStatic()) {
1475         assert(isa<UnaryOperator>(From->IgnoreParens()) &&
1476                "Non-unary operator on non-static member address");
1477         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode()
1478                == UO_AddrOf &&
1479                "Non-address-of operator on non-static member address");
1480         const Type *ClassType
1481           = S.Context.getTypeDeclType(Method->getParent()).getTypePtr();
1482         FromType = S.Context.getMemberPointerType(FromType, ClassType);
1483       } else if (isa<UnaryOperator>(From->IgnoreParens())) {
1484         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode() ==
1485                UO_AddrOf &&
1486                "Non-address-of operator for overloaded function expression");
1487         FromType = S.Context.getPointerType(FromType);
1488       }
1489 
1490       // Check that we've computed the proper type after overload resolution.
1491       assert(S.Context.hasSameType(
1492         FromType,
1493         S.FixOverloadedFunctionReference(From, AccessPair, Fn)->getType()));
1494     } else {
1495       return false;
1496     }
1497   }
1498   // Lvalue-to-rvalue conversion (C++11 4.1):
1499   //   A glvalue (3.10) of a non-function, non-array type T can
1500   //   be converted to a prvalue.
1501   bool argIsLValue = From->isGLValue();
1502   if (argIsLValue &&
1503       !FromType->isFunctionType() && !FromType->isArrayType() &&
1504       S.Context.getCanonicalType(FromType) != S.Context.OverloadTy) {
1505     SCS.First = ICK_Lvalue_To_Rvalue;
1506 
1507     // C11 6.3.2.1p2:
1508     //   ... if the lvalue has atomic type, the value has the non-atomic version
1509     //   of the type of the lvalue ...
1510     if (const AtomicType *Atomic = FromType->getAs<AtomicType>())
1511       FromType = Atomic->getValueType();
1512 
1513     // If T is a non-class type, the type of the rvalue is the
1514     // cv-unqualified version of T. Otherwise, the type of the rvalue
1515     // is T (C++ 4.1p1). C++ can't get here with class types; in C, we
1516     // just strip the qualifiers because they don't matter.
1517     FromType = FromType.getUnqualifiedType();
1518   } else if (FromType->isArrayType()) {
1519     // Array-to-pointer conversion (C++ 4.2)
1520     SCS.First = ICK_Array_To_Pointer;
1521 
1522     // An lvalue or rvalue of type "array of N T" or "array of unknown
1523     // bound of T" can be converted to an rvalue of type "pointer to
1524     // T" (C++ 4.2p1).
1525     FromType = S.Context.getArrayDecayedType(FromType);
1526 
1527     if (S.IsStringLiteralToNonConstPointerConversion(From, ToType)) {
1528       // This conversion is deprecated in C++03 (D.4)
1529       SCS.DeprecatedStringLiteralToCharPtr = true;
1530 
1531       // For the purpose of ranking in overload resolution
1532       // (13.3.3.1.1), this conversion is considered an
1533       // array-to-pointer conversion followed by a qualification
1534       // conversion (4.4). (C++ 4.2p2)
1535       SCS.Second = ICK_Identity;
1536       SCS.Third = ICK_Qualification;
1537       SCS.QualificationIncludesObjCLifetime = false;
1538       SCS.setAllToTypes(FromType);
1539       return true;
1540     }
1541   } else if (FromType->isFunctionType() && argIsLValue) {
1542     // Function-to-pointer conversion (C++ 4.3).
1543     SCS.First = ICK_Function_To_Pointer;
1544 
1545     // An lvalue of function type T can be converted to an rvalue of
1546     // type "pointer to T." The result is a pointer to the
1547     // function. (C++ 4.3p1).
1548     FromType = S.Context.getPointerType(FromType);
1549   } else {
1550     // We don't require any conversions for the first step.
1551     SCS.First = ICK_Identity;
1552   }
1553   SCS.setToType(0, FromType);
1554 
1555   // The second conversion can be an integral promotion, floating
1556   // point promotion, integral conversion, floating point conversion,
1557   // floating-integral conversion, pointer conversion,
1558   // pointer-to-member conversion, or boolean conversion (C++ 4p1).
1559   // For overloading in C, this can also be a "compatible-type"
1560   // conversion.
1561   bool IncompatibleObjC = false;
1562   ImplicitConversionKind SecondICK = ICK_Identity;
1563   if (S.Context.hasSameUnqualifiedType(FromType, ToType)) {
1564     // The unqualified versions of the types are the same: there's no
1565     // conversion to do.
1566     SCS.Second = ICK_Identity;
1567   } else if (S.IsIntegralPromotion(From, FromType, ToType)) {
1568     // Integral promotion (C++ 4.5).
1569     SCS.Second = ICK_Integral_Promotion;
1570     FromType = ToType.getUnqualifiedType();
1571   } else if (S.IsFloatingPointPromotion(FromType, ToType)) {
1572     // Floating point promotion (C++ 4.6).
1573     SCS.Second = ICK_Floating_Promotion;
1574     FromType = ToType.getUnqualifiedType();
1575   } else if (S.IsComplexPromotion(FromType, ToType)) {
1576     // Complex promotion (Clang extension)
1577     SCS.Second = ICK_Complex_Promotion;
1578     FromType = ToType.getUnqualifiedType();
1579   } else if (ToType->isBooleanType() &&
1580              (FromType->isArithmeticType() ||
1581               FromType->isAnyPointerType() ||
1582               FromType->isBlockPointerType() ||
1583               FromType->isMemberPointerType() ||
1584               FromType->isNullPtrType())) {
1585     // Boolean conversions (C++ 4.12).
1586     SCS.Second = ICK_Boolean_Conversion;
1587     FromType = S.Context.BoolTy;
1588   } else if (FromType->isIntegralOrUnscopedEnumerationType() &&
1589              ToType->isIntegralType(S.Context)) {
1590     // Integral conversions (C++ 4.7).
1591     SCS.Second = ICK_Integral_Conversion;
1592     FromType = ToType.getUnqualifiedType();
1593   } else if (FromType->isAnyComplexType() && ToType->isAnyComplexType()) {
1594     // Complex conversions (C99 6.3.1.6)
1595     SCS.Second = ICK_Complex_Conversion;
1596     FromType = ToType.getUnqualifiedType();
1597   } else if ((FromType->isAnyComplexType() && ToType->isArithmeticType()) ||
1598              (ToType->isAnyComplexType() && FromType->isArithmeticType())) {
1599     // Complex-real conversions (C99 6.3.1.7)
1600     SCS.Second = ICK_Complex_Real;
1601     FromType = ToType.getUnqualifiedType();
1602   } else if (FromType->isRealFloatingType() && ToType->isRealFloatingType()) {
1603     // Floating point conversions (C++ 4.8).
1604     SCS.Second = ICK_Floating_Conversion;
1605     FromType = ToType.getUnqualifiedType();
1606   } else if ((FromType->isRealFloatingType() &&
1607               ToType->isIntegralType(S.Context)) ||
1608              (FromType->isIntegralOrUnscopedEnumerationType() &&
1609               ToType->isRealFloatingType())) {
1610     // Floating-integral conversions (C++ 4.9).
1611     SCS.Second = ICK_Floating_Integral;
1612     FromType = ToType.getUnqualifiedType();
1613   } else if (S.IsBlockPointerConversion(FromType, ToType, FromType)) {
1614     SCS.Second = ICK_Block_Pointer_Conversion;
1615   } else if (AllowObjCWritebackConversion &&
1616              S.isObjCWritebackConversion(FromType, ToType, FromType)) {
1617     SCS.Second = ICK_Writeback_Conversion;
1618   } else if (S.IsPointerConversion(From, FromType, ToType, InOverloadResolution,
1619                                    FromType, IncompatibleObjC)) {
1620     // Pointer conversions (C++ 4.10).
1621     SCS.Second = ICK_Pointer_Conversion;
1622     SCS.IncompatibleObjC = IncompatibleObjC;
1623     FromType = FromType.getUnqualifiedType();
1624   } else if (S.IsMemberPointerConversion(From, FromType, ToType,
1625                                          InOverloadResolution, FromType)) {
1626     // Pointer to member conversions (4.11).
1627     SCS.Second = ICK_Pointer_Member;
1628   } else if (IsVectorConversion(S, FromType, ToType, SecondICK)) {
1629     SCS.Second = SecondICK;
1630     FromType = ToType.getUnqualifiedType();
1631   } else if (!S.getLangOpts().CPlusPlus &&
1632              S.Context.typesAreCompatible(ToType, FromType)) {
1633     // Compatible conversions (Clang extension for C function overloading)
1634     SCS.Second = ICK_Compatible_Conversion;
1635     FromType = ToType.getUnqualifiedType();
1636   } else if (S.IsNoReturnConversion(FromType, ToType, FromType)) {
1637     // Treat a conversion that strips "noreturn" as an identity conversion.
1638     SCS.Second = ICK_NoReturn_Adjustment;
1639   } else if (IsTransparentUnionStandardConversion(S, From, ToType,
1640                                              InOverloadResolution,
1641                                              SCS, CStyle)) {
1642     SCS.Second = ICK_TransparentUnionConversion;
1643     FromType = ToType;
1644   } else if (tryAtomicConversion(S, From, ToType, InOverloadResolution, SCS,
1645                                  CStyle)) {
1646     // tryAtomicConversion has updated the standard conversion sequence
1647     // appropriately.
1648     return true;
1649   } else if (ToType->isEventT() &&
1650              From->isIntegerConstantExpr(S.getASTContext()) &&
1651              (From->EvaluateKnownConstInt(S.getASTContext()) == 0)) {
1652     SCS.Second = ICK_Zero_Event_Conversion;
1653     FromType = ToType;
1654   } else {
1655     // No second conversion required.
1656     SCS.Second = ICK_Identity;
1657   }
1658   SCS.setToType(1, FromType);
1659 
1660   QualType CanonFrom;
1661   QualType CanonTo;
1662   // The third conversion can be a qualification conversion (C++ 4p1).
1663   bool ObjCLifetimeConversion;
1664   if (S.IsQualificationConversion(FromType, ToType, CStyle,
1665                                   ObjCLifetimeConversion)) {
1666     SCS.Third = ICK_Qualification;
1667     SCS.QualificationIncludesObjCLifetime = ObjCLifetimeConversion;
1668     FromType = ToType;
1669     CanonFrom = S.Context.getCanonicalType(FromType);
1670     CanonTo = S.Context.getCanonicalType(ToType);
1671   } else {
1672     // No conversion required
1673     SCS.Third = ICK_Identity;
1674 
1675     // C++ [over.best.ics]p6:
1676     //   [...] Any difference in top-level cv-qualification is
1677     //   subsumed by the initialization itself and does not constitute
1678     //   a conversion. [...]
1679     CanonFrom = S.Context.getCanonicalType(FromType);
1680     CanonTo = S.Context.getCanonicalType(ToType);
1681     if (CanonFrom.getLocalUnqualifiedType()
1682                                        == CanonTo.getLocalUnqualifiedType() &&
1683         CanonFrom.getLocalQualifiers() != CanonTo.getLocalQualifiers()) {
1684       FromType = ToType;
1685       CanonFrom = CanonTo;
1686     }
1687   }
1688   SCS.setToType(2, FromType);
1689 
1690   // If we have not converted the argument type to the parameter type,
1691   // this is a bad conversion sequence.
1692   if (CanonFrom != CanonTo)
1693     return false;
1694 
1695   return true;
1696 }
1697 
1698 static bool
1699 IsTransparentUnionStandardConversion(Sema &S, Expr* From,
1700                                      QualType &ToType,
1701                                      bool InOverloadResolution,
1702                                      StandardConversionSequence &SCS,
1703                                      bool CStyle) {
1704 
1705   const RecordType *UT = ToType->getAsUnionType();
1706   if (!UT || !UT->getDecl()->hasAttr<TransparentUnionAttr>())
1707     return false;
1708   // The field to initialize within the transparent union.
1709   RecordDecl *UD = UT->getDecl();
1710   // It's compatible if the expression matches any of the fields.
1711   for (const auto *it : UD->fields()) {
1712     if (IsStandardConversion(S, From, it->getType(), InOverloadResolution, SCS,
1713                              CStyle, /*ObjCWritebackConversion=*/false)) {
1714       ToType = it->getType();
1715       return true;
1716     }
1717   }
1718   return false;
1719 }
1720 
1721 /// IsIntegralPromotion - Determines whether the conversion from the
1722 /// expression From (whose potentially-adjusted type is FromType) to
1723 /// ToType is an integral promotion (C++ 4.5). If so, returns true and
1724 /// sets PromotedType to the promoted type.
1725 bool Sema::IsIntegralPromotion(Expr *From, QualType FromType, QualType ToType) {
1726   const BuiltinType *To = ToType->getAs<BuiltinType>();
1727   // All integers are built-in.
1728   if (!To) {
1729     return false;
1730   }
1731 
1732   // An rvalue of type char, signed char, unsigned char, short int, or
1733   // unsigned short int can be converted to an rvalue of type int if
1734   // int can represent all the values of the source type; otherwise,
1735   // the source rvalue can be converted to an rvalue of type unsigned
1736   // int (C++ 4.5p1).
1737   if (FromType->isPromotableIntegerType() && !FromType->isBooleanType() &&
1738       !FromType->isEnumeralType()) {
1739     if (// We can promote any signed, promotable integer type to an int
1740         (FromType->isSignedIntegerType() ||
1741          // We can promote any unsigned integer type whose size is
1742          // less than int to an int.
1743          (!FromType->isSignedIntegerType() &&
1744           Context.getTypeSize(FromType) < Context.getTypeSize(ToType)))) {
1745       return To->getKind() == BuiltinType::Int;
1746     }
1747 
1748     return To->getKind() == BuiltinType::UInt;
1749   }
1750 
1751   // C++11 [conv.prom]p3:
1752   //   A prvalue of an unscoped enumeration type whose underlying type is not
1753   //   fixed (7.2) can be converted to an rvalue a prvalue of the first of the
1754   //   following types that can represent all the values of the enumeration
1755   //   (i.e., the values in the range bmin to bmax as described in 7.2): int,
1756   //   unsigned int, long int, unsigned long int, long long int, or unsigned
1757   //   long long int. If none of the types in that list can represent all the
1758   //   values of the enumeration, an rvalue a prvalue of an unscoped enumeration
1759   //   type can be converted to an rvalue a prvalue of the extended integer type
1760   //   with lowest integer conversion rank (4.13) greater than the rank of long
1761   //   long in which all the values of the enumeration can be represented. If
1762   //   there are two such extended types, the signed one is chosen.
1763   // C++11 [conv.prom]p4:
1764   //   A prvalue of an unscoped enumeration type whose underlying type is fixed
1765   //   can be converted to a prvalue of its underlying type. Moreover, if
1766   //   integral promotion can be applied to its underlying type, a prvalue of an
1767   //   unscoped enumeration type whose underlying type is fixed can also be
1768   //   converted to a prvalue of the promoted underlying type.
1769   if (const EnumType *FromEnumType = FromType->getAs<EnumType>()) {
1770     // C++0x 7.2p9: Note that this implicit enum to int conversion is not
1771     // provided for a scoped enumeration.
1772     if (FromEnumType->getDecl()->isScoped())
1773       return false;
1774 
1775     // We can perform an integral promotion to the underlying type of the enum,
1776     // even if that's not the promoted type.
1777     if (FromEnumType->getDecl()->isFixed()) {
1778       QualType Underlying = FromEnumType->getDecl()->getIntegerType();
1779       return Context.hasSameUnqualifiedType(Underlying, ToType) ||
1780              IsIntegralPromotion(From, Underlying, ToType);
1781     }
1782 
1783     // We have already pre-calculated the promotion type, so this is trivial.
1784     if (ToType->isIntegerType() &&
1785         !RequireCompleteType(From->getLocStart(), FromType, 0))
1786       return Context.hasSameUnqualifiedType(ToType,
1787                                 FromEnumType->getDecl()->getPromotionType());
1788   }
1789 
1790   // C++0x [conv.prom]p2:
1791   //   A prvalue of type char16_t, char32_t, or wchar_t (3.9.1) can be converted
1792   //   to an rvalue a prvalue of the first of the following types that can
1793   //   represent all the values of its underlying type: int, unsigned int,
1794   //   long int, unsigned long int, long long int, or unsigned long long int.
1795   //   If none of the types in that list can represent all the values of its
1796   //   underlying type, an rvalue a prvalue of type char16_t, char32_t,
1797   //   or wchar_t can be converted to an rvalue a prvalue of its underlying
1798   //   type.
1799   if (FromType->isAnyCharacterType() && !FromType->isCharType() &&
1800       ToType->isIntegerType()) {
1801     // Determine whether the type we're converting from is signed or
1802     // unsigned.
1803     bool FromIsSigned = FromType->isSignedIntegerType();
1804     uint64_t FromSize = Context.getTypeSize(FromType);
1805 
1806     // The types we'll try to promote to, in the appropriate
1807     // order. Try each of these types.
1808     QualType PromoteTypes[6] = {
1809       Context.IntTy, Context.UnsignedIntTy,
1810       Context.LongTy, Context.UnsignedLongTy ,
1811       Context.LongLongTy, Context.UnsignedLongLongTy
1812     };
1813     for (int Idx = 0; Idx < 6; ++Idx) {
1814       uint64_t ToSize = Context.getTypeSize(PromoteTypes[Idx]);
1815       if (FromSize < ToSize ||
1816           (FromSize == ToSize &&
1817            FromIsSigned == PromoteTypes[Idx]->isSignedIntegerType())) {
1818         // We found the type that we can promote to. If this is the
1819         // type we wanted, we have a promotion. Otherwise, no
1820         // promotion.
1821         return Context.hasSameUnqualifiedType(ToType, PromoteTypes[Idx]);
1822       }
1823     }
1824   }
1825 
1826   // An rvalue for an integral bit-field (9.6) can be converted to an
1827   // rvalue of type int if int can represent all the values of the
1828   // bit-field; otherwise, it can be converted to unsigned int if
1829   // unsigned int can represent all the values of the bit-field. If
1830   // the bit-field is larger yet, no integral promotion applies to
1831   // it. If the bit-field has an enumerated type, it is treated as any
1832   // other value of that type for promotion purposes (C++ 4.5p3).
1833   // FIXME: We should delay checking of bit-fields until we actually perform the
1834   // conversion.
1835   using llvm::APSInt;
1836   if (From)
1837     if (FieldDecl *MemberDecl = From->getSourceBitField()) {
1838       APSInt BitWidth;
1839       if (FromType->isIntegralType(Context) &&
1840           MemberDecl->getBitWidth()->isIntegerConstantExpr(BitWidth, Context)) {
1841         APSInt ToSize(BitWidth.getBitWidth(), BitWidth.isUnsigned());
1842         ToSize = Context.getTypeSize(ToType);
1843 
1844         // Are we promoting to an int from a bitfield that fits in an int?
1845         if (BitWidth < ToSize ||
1846             (FromType->isSignedIntegerType() && BitWidth <= ToSize)) {
1847           return To->getKind() == BuiltinType::Int;
1848         }
1849 
1850         // Are we promoting to an unsigned int from an unsigned bitfield
1851         // that fits into an unsigned int?
1852         if (FromType->isUnsignedIntegerType() && BitWidth <= ToSize) {
1853           return To->getKind() == BuiltinType::UInt;
1854         }
1855 
1856         return false;
1857       }
1858     }
1859 
1860   // An rvalue of type bool can be converted to an rvalue of type int,
1861   // with false becoming zero and true becoming one (C++ 4.5p4).
1862   if (FromType->isBooleanType() && To->getKind() == BuiltinType::Int) {
1863     return true;
1864   }
1865 
1866   return false;
1867 }
1868 
1869 /// IsFloatingPointPromotion - Determines whether the conversion from
1870 /// FromType to ToType is a floating point promotion (C++ 4.6). If so,
1871 /// returns true and sets PromotedType to the promoted type.
1872 bool Sema::IsFloatingPointPromotion(QualType FromType, QualType ToType) {
1873   if (const BuiltinType *FromBuiltin = FromType->getAs<BuiltinType>())
1874     if (const BuiltinType *ToBuiltin = ToType->getAs<BuiltinType>()) {
1875       /// An rvalue of type float can be converted to an rvalue of type
1876       /// double. (C++ 4.6p1).
1877       if (FromBuiltin->getKind() == BuiltinType::Float &&
1878           ToBuiltin->getKind() == BuiltinType::Double)
1879         return true;
1880 
1881       // C99 6.3.1.5p1:
1882       //   When a float is promoted to double or long double, or a
1883       //   double is promoted to long double [...].
1884       if (!getLangOpts().CPlusPlus &&
1885           (FromBuiltin->getKind() == BuiltinType::Float ||
1886            FromBuiltin->getKind() == BuiltinType::Double) &&
1887           (ToBuiltin->getKind() == BuiltinType::LongDouble))
1888         return true;
1889 
1890       // Half can be promoted to float.
1891       if (!getLangOpts().NativeHalfType &&
1892            FromBuiltin->getKind() == BuiltinType::Half &&
1893           ToBuiltin->getKind() == BuiltinType::Float)
1894         return true;
1895     }
1896 
1897   return false;
1898 }
1899 
1900 /// \brief Determine if a conversion is a complex promotion.
1901 ///
1902 /// A complex promotion is defined as a complex -> complex conversion
1903 /// where the conversion between the underlying real types is a
1904 /// floating-point or integral promotion.
1905 bool Sema::IsComplexPromotion(QualType FromType, QualType ToType) {
1906   const ComplexType *FromComplex = FromType->getAs<ComplexType>();
1907   if (!FromComplex)
1908     return false;
1909 
1910   const ComplexType *ToComplex = ToType->getAs<ComplexType>();
1911   if (!ToComplex)
1912     return false;
1913 
1914   return IsFloatingPointPromotion(FromComplex->getElementType(),
1915                                   ToComplex->getElementType()) ||
1916     IsIntegralPromotion(nullptr, FromComplex->getElementType(),
1917                         ToComplex->getElementType());
1918 }
1919 
1920 /// BuildSimilarlyQualifiedPointerType - In a pointer conversion from
1921 /// the pointer type FromPtr to a pointer to type ToPointee, with the
1922 /// same type qualifiers as FromPtr has on its pointee type. ToType,
1923 /// if non-empty, will be a pointer to ToType that may or may not have
1924 /// the right set of qualifiers on its pointee.
1925 ///
1926 static QualType
1927 BuildSimilarlyQualifiedPointerType(const Type *FromPtr,
1928                                    QualType ToPointee, QualType ToType,
1929                                    ASTContext &Context,
1930                                    bool StripObjCLifetime = false) {
1931   assert((FromPtr->getTypeClass() == Type::Pointer ||
1932           FromPtr->getTypeClass() == Type::ObjCObjectPointer) &&
1933          "Invalid similarly-qualified pointer type");
1934 
1935   /// Conversions to 'id' subsume cv-qualifier conversions.
1936   if (ToType->isObjCIdType() || ToType->isObjCQualifiedIdType())
1937     return ToType.getUnqualifiedType();
1938 
1939   QualType CanonFromPointee
1940     = Context.getCanonicalType(FromPtr->getPointeeType());
1941   QualType CanonToPointee = Context.getCanonicalType(ToPointee);
1942   Qualifiers Quals = CanonFromPointee.getQualifiers();
1943 
1944   if (StripObjCLifetime)
1945     Quals.removeObjCLifetime();
1946 
1947   // Exact qualifier match -> return the pointer type we're converting to.
1948   if (CanonToPointee.getLocalQualifiers() == Quals) {
1949     // ToType is exactly what we need. Return it.
1950     if (!ToType.isNull())
1951       return ToType.getUnqualifiedType();
1952 
1953     // Build a pointer to ToPointee. It has the right qualifiers
1954     // already.
1955     if (isa<ObjCObjectPointerType>(ToType))
1956       return Context.getObjCObjectPointerType(ToPointee);
1957     return Context.getPointerType(ToPointee);
1958   }
1959 
1960   // Just build a canonical type that has the right qualifiers.
1961   QualType QualifiedCanonToPointee
1962     = Context.getQualifiedType(CanonToPointee.getLocalUnqualifiedType(), Quals);
1963 
1964   if (isa<ObjCObjectPointerType>(ToType))
1965     return Context.getObjCObjectPointerType(QualifiedCanonToPointee);
1966   return Context.getPointerType(QualifiedCanonToPointee);
1967 }
1968 
1969 static bool isNullPointerConstantForConversion(Expr *Expr,
1970                                                bool InOverloadResolution,
1971                                                ASTContext &Context) {
1972   // Handle value-dependent integral null pointer constants correctly.
1973   // http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_active.html#903
1974   if (Expr->isValueDependent() && !Expr->isTypeDependent() &&
1975       Expr->getType()->isIntegerType() && !Expr->getType()->isEnumeralType())
1976     return !InOverloadResolution;
1977 
1978   return Expr->isNullPointerConstant(Context,
1979                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
1980                                         : Expr::NPC_ValueDependentIsNull);
1981 }
1982 
1983 /// IsPointerConversion - Determines whether the conversion of the
1984 /// expression From, which has the (possibly adjusted) type FromType,
1985 /// can be converted to the type ToType via a pointer conversion (C++
1986 /// 4.10). If so, returns true and places the converted type (that
1987 /// might differ from ToType in its cv-qualifiers at some level) into
1988 /// ConvertedType.
1989 ///
1990 /// This routine also supports conversions to and from block pointers
1991 /// and conversions with Objective-C's 'id', 'id<protocols...>', and
1992 /// pointers to interfaces. FIXME: Once we've determined the
1993 /// appropriate overloading rules for Objective-C, we may want to
1994 /// split the Objective-C checks into a different routine; however,
1995 /// GCC seems to consider all of these conversions to be pointer
1996 /// conversions, so for now they live here. IncompatibleObjC will be
1997 /// set if the conversion is an allowed Objective-C conversion that
1998 /// should result in a warning.
1999 bool Sema::IsPointerConversion(Expr *From, QualType FromType, QualType ToType,
2000                                bool InOverloadResolution,
2001                                QualType& ConvertedType,
2002                                bool &IncompatibleObjC) {
2003   IncompatibleObjC = false;
2004   if (isObjCPointerConversion(FromType, ToType, ConvertedType,
2005                               IncompatibleObjC))
2006     return true;
2007 
2008   // Conversion from a null pointer constant to any Objective-C pointer type.
2009   if (ToType->isObjCObjectPointerType() &&
2010       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2011     ConvertedType = ToType;
2012     return true;
2013   }
2014 
2015   // Blocks: Block pointers can be converted to void*.
2016   if (FromType->isBlockPointerType() && ToType->isPointerType() &&
2017       ToType->getAs<PointerType>()->getPointeeType()->isVoidType()) {
2018     ConvertedType = ToType;
2019     return true;
2020   }
2021   // Blocks: A null pointer constant can be converted to a block
2022   // pointer type.
2023   if (ToType->isBlockPointerType() &&
2024       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2025     ConvertedType = ToType;
2026     return true;
2027   }
2028 
2029   // If the left-hand-side is nullptr_t, the right side can be a null
2030   // pointer constant.
2031   if (ToType->isNullPtrType() &&
2032       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2033     ConvertedType = ToType;
2034     return true;
2035   }
2036 
2037   const PointerType* ToTypePtr = ToType->getAs<PointerType>();
2038   if (!ToTypePtr)
2039     return false;
2040 
2041   // A null pointer constant can be converted to a pointer type (C++ 4.10p1).
2042   if (isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2043     ConvertedType = ToType;
2044     return true;
2045   }
2046 
2047   // Beyond this point, both types need to be pointers
2048   // , including objective-c pointers.
2049   QualType ToPointeeType = ToTypePtr->getPointeeType();
2050   if (FromType->isObjCObjectPointerType() && ToPointeeType->isVoidType() &&
2051       !getLangOpts().ObjCAutoRefCount) {
2052     ConvertedType = BuildSimilarlyQualifiedPointerType(
2053                                       FromType->getAs<ObjCObjectPointerType>(),
2054                                                        ToPointeeType,
2055                                                        ToType, Context);
2056     return true;
2057   }
2058   const PointerType *FromTypePtr = FromType->getAs<PointerType>();
2059   if (!FromTypePtr)
2060     return false;
2061 
2062   QualType FromPointeeType = FromTypePtr->getPointeeType();
2063 
2064   // If the unqualified pointee types are the same, this can't be a
2065   // pointer conversion, so don't do all of the work below.
2066   if (Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType))
2067     return false;
2068 
2069   // An rvalue of type "pointer to cv T," where T is an object type,
2070   // can be converted to an rvalue of type "pointer to cv void" (C++
2071   // 4.10p2).
2072   if (FromPointeeType->isIncompleteOrObjectType() &&
2073       ToPointeeType->isVoidType()) {
2074     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2075                                                        ToPointeeType,
2076                                                        ToType, Context,
2077                                                    /*StripObjCLifetime=*/true);
2078     return true;
2079   }
2080 
2081   // MSVC allows implicit function to void* type conversion.
2082   if (getLangOpts().MicrosoftExt && FromPointeeType->isFunctionType() &&
2083       ToPointeeType->isVoidType()) {
2084     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2085                                                        ToPointeeType,
2086                                                        ToType, Context);
2087     return true;
2088   }
2089 
2090   // When we're overloading in C, we allow a special kind of pointer
2091   // conversion for compatible-but-not-identical pointee types.
2092   if (!getLangOpts().CPlusPlus &&
2093       Context.typesAreCompatible(FromPointeeType, ToPointeeType)) {
2094     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2095                                                        ToPointeeType,
2096                                                        ToType, Context);
2097     return true;
2098   }
2099 
2100   // C++ [conv.ptr]p3:
2101   //
2102   //   An rvalue of type "pointer to cv D," where D is a class type,
2103   //   can be converted to an rvalue of type "pointer to cv B," where
2104   //   B is a base class (clause 10) of D. If B is an inaccessible
2105   //   (clause 11) or ambiguous (10.2) base class of D, a program that
2106   //   necessitates this conversion is ill-formed. The result of the
2107   //   conversion is a pointer to the base class sub-object of the
2108   //   derived class object. The null pointer value is converted to
2109   //   the null pointer value of the destination type.
2110   //
2111   // Note that we do not check for ambiguity or inaccessibility
2112   // here. That is handled by CheckPointerConversion.
2113   if (getLangOpts().CPlusPlus &&
2114       FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2115       !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType) &&
2116       !RequireCompleteType(From->getLocStart(), FromPointeeType, 0) &&
2117       IsDerivedFrom(FromPointeeType, ToPointeeType)) {
2118     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2119                                                        ToPointeeType,
2120                                                        ToType, Context);
2121     return true;
2122   }
2123 
2124   if (FromPointeeType->isVectorType() && ToPointeeType->isVectorType() &&
2125       Context.areCompatibleVectorTypes(FromPointeeType, ToPointeeType)) {
2126     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2127                                                        ToPointeeType,
2128                                                        ToType, Context);
2129     return true;
2130   }
2131 
2132   return false;
2133 }
2134 
2135 /// \brief Adopt the given qualifiers for the given type.
2136 static QualType AdoptQualifiers(ASTContext &Context, QualType T, Qualifiers Qs){
2137   Qualifiers TQs = T.getQualifiers();
2138 
2139   // Check whether qualifiers already match.
2140   if (TQs == Qs)
2141     return T;
2142 
2143   if (Qs.compatiblyIncludes(TQs))
2144     return Context.getQualifiedType(T, Qs);
2145 
2146   return Context.getQualifiedType(T.getUnqualifiedType(), Qs);
2147 }
2148 
2149 /// isObjCPointerConversion - Determines whether this is an
2150 /// Objective-C pointer conversion. Subroutine of IsPointerConversion,
2151 /// with the same arguments and return values.
2152 bool Sema::isObjCPointerConversion(QualType FromType, QualType ToType,
2153                                    QualType& ConvertedType,
2154                                    bool &IncompatibleObjC) {
2155   if (!getLangOpts().ObjC1)
2156     return false;
2157 
2158   // The set of qualifiers on the type we're converting from.
2159   Qualifiers FromQualifiers = FromType.getQualifiers();
2160 
2161   // First, we handle all conversions on ObjC object pointer types.
2162   const ObjCObjectPointerType* ToObjCPtr =
2163     ToType->getAs<ObjCObjectPointerType>();
2164   const ObjCObjectPointerType *FromObjCPtr =
2165     FromType->getAs<ObjCObjectPointerType>();
2166 
2167   if (ToObjCPtr && FromObjCPtr) {
2168     // If the pointee types are the same (ignoring qualifications),
2169     // then this is not a pointer conversion.
2170     if (Context.hasSameUnqualifiedType(ToObjCPtr->getPointeeType(),
2171                                        FromObjCPtr->getPointeeType()))
2172       return false;
2173 
2174     // Check for compatible
2175     // Objective C++: We're able to convert between "id" or "Class" and a
2176     // pointer to any interface (in both directions).
2177     if (ToObjCPtr->isObjCBuiltinType() && FromObjCPtr->isObjCBuiltinType()) {
2178       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2179       return true;
2180     }
2181     // Conversions with Objective-C's id<...>.
2182     if ((FromObjCPtr->isObjCQualifiedIdType() ||
2183          ToObjCPtr->isObjCQualifiedIdType()) &&
2184         Context.ObjCQualifiedIdTypesAreCompatible(ToType, FromType,
2185                                                   /*compare=*/false)) {
2186       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2187       return true;
2188     }
2189     // Objective C++: We're able to convert from a pointer to an
2190     // interface to a pointer to a different interface.
2191     if (Context.canAssignObjCInterfaces(ToObjCPtr, FromObjCPtr)) {
2192       const ObjCInterfaceType* LHS = ToObjCPtr->getInterfaceType();
2193       const ObjCInterfaceType* RHS = FromObjCPtr->getInterfaceType();
2194       if (getLangOpts().CPlusPlus && LHS && RHS &&
2195           !ToObjCPtr->getPointeeType().isAtLeastAsQualifiedAs(
2196                                                 FromObjCPtr->getPointeeType()))
2197         return false;
2198       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2199                                                    ToObjCPtr->getPointeeType(),
2200                                                          ToType, Context);
2201       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2202       return true;
2203     }
2204 
2205     if (Context.canAssignObjCInterfaces(FromObjCPtr, ToObjCPtr)) {
2206       // Okay: this is some kind of implicit downcast of Objective-C
2207       // interfaces, which is permitted. However, we're going to
2208       // complain about it.
2209       IncompatibleObjC = true;
2210       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2211                                                    ToObjCPtr->getPointeeType(),
2212                                                          ToType, Context);
2213       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2214       return true;
2215     }
2216   }
2217   // Beyond this point, both types need to be C pointers or block pointers.
2218   QualType ToPointeeType;
2219   if (const PointerType *ToCPtr = ToType->getAs<PointerType>())
2220     ToPointeeType = ToCPtr->getPointeeType();
2221   else if (const BlockPointerType *ToBlockPtr =
2222             ToType->getAs<BlockPointerType>()) {
2223     // Objective C++: We're able to convert from a pointer to any object
2224     // to a block pointer type.
2225     if (FromObjCPtr && FromObjCPtr->isObjCBuiltinType()) {
2226       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2227       return true;
2228     }
2229     ToPointeeType = ToBlockPtr->getPointeeType();
2230   }
2231   else if (FromType->getAs<BlockPointerType>() &&
2232            ToObjCPtr && ToObjCPtr->isObjCBuiltinType()) {
2233     // Objective C++: We're able to convert from a block pointer type to a
2234     // pointer to any object.
2235     ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2236     return true;
2237   }
2238   else
2239     return false;
2240 
2241   QualType FromPointeeType;
2242   if (const PointerType *FromCPtr = FromType->getAs<PointerType>())
2243     FromPointeeType = FromCPtr->getPointeeType();
2244   else if (const BlockPointerType *FromBlockPtr =
2245            FromType->getAs<BlockPointerType>())
2246     FromPointeeType = FromBlockPtr->getPointeeType();
2247   else
2248     return false;
2249 
2250   // If we have pointers to pointers, recursively check whether this
2251   // is an Objective-C conversion.
2252   if (FromPointeeType->isPointerType() && ToPointeeType->isPointerType() &&
2253       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2254                               IncompatibleObjC)) {
2255     // We always complain about this conversion.
2256     IncompatibleObjC = true;
2257     ConvertedType = Context.getPointerType(ConvertedType);
2258     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2259     return true;
2260   }
2261   // Allow conversion of pointee being objective-c pointer to another one;
2262   // as in I* to id.
2263   if (FromPointeeType->getAs<ObjCObjectPointerType>() &&
2264       ToPointeeType->getAs<ObjCObjectPointerType>() &&
2265       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2266                               IncompatibleObjC)) {
2267 
2268     ConvertedType = Context.getPointerType(ConvertedType);
2269     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2270     return true;
2271   }
2272 
2273   // If we have pointers to functions or blocks, check whether the only
2274   // differences in the argument and result types are in Objective-C
2275   // pointer conversions. If so, we permit the conversion (but
2276   // complain about it).
2277   const FunctionProtoType *FromFunctionType
2278     = FromPointeeType->getAs<FunctionProtoType>();
2279   const FunctionProtoType *ToFunctionType
2280     = ToPointeeType->getAs<FunctionProtoType>();
2281   if (FromFunctionType && ToFunctionType) {
2282     // If the function types are exactly the same, this isn't an
2283     // Objective-C pointer conversion.
2284     if (Context.getCanonicalType(FromPointeeType)
2285           == Context.getCanonicalType(ToPointeeType))
2286       return false;
2287 
2288     // Perform the quick checks that will tell us whether these
2289     // function types are obviously different.
2290     if (FromFunctionType->getNumParams() != ToFunctionType->getNumParams() ||
2291         FromFunctionType->isVariadic() != ToFunctionType->isVariadic() ||
2292         FromFunctionType->getTypeQuals() != ToFunctionType->getTypeQuals())
2293       return false;
2294 
2295     bool HasObjCConversion = false;
2296     if (Context.getCanonicalType(FromFunctionType->getReturnType()) ==
2297         Context.getCanonicalType(ToFunctionType->getReturnType())) {
2298       // Okay, the types match exactly. Nothing to do.
2299     } else if (isObjCPointerConversion(FromFunctionType->getReturnType(),
2300                                        ToFunctionType->getReturnType(),
2301                                        ConvertedType, IncompatibleObjC)) {
2302       // Okay, we have an Objective-C pointer conversion.
2303       HasObjCConversion = true;
2304     } else {
2305       // Function types are too different. Abort.
2306       return false;
2307     }
2308 
2309     // Check argument types.
2310     for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumParams();
2311          ArgIdx != NumArgs; ++ArgIdx) {
2312       QualType FromArgType = FromFunctionType->getParamType(ArgIdx);
2313       QualType ToArgType = ToFunctionType->getParamType(ArgIdx);
2314       if (Context.getCanonicalType(FromArgType)
2315             == Context.getCanonicalType(ToArgType)) {
2316         // Okay, the types match exactly. Nothing to do.
2317       } else if (isObjCPointerConversion(FromArgType, ToArgType,
2318                                          ConvertedType, IncompatibleObjC)) {
2319         // Okay, we have an Objective-C pointer conversion.
2320         HasObjCConversion = true;
2321       } else {
2322         // Argument types are too different. Abort.
2323         return false;
2324       }
2325     }
2326 
2327     if (HasObjCConversion) {
2328       // We had an Objective-C conversion. Allow this pointer
2329       // conversion, but complain about it.
2330       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2331       IncompatibleObjC = true;
2332       return true;
2333     }
2334   }
2335 
2336   return false;
2337 }
2338 
2339 /// \brief Determine whether this is an Objective-C writeback conversion,
2340 /// used for parameter passing when performing automatic reference counting.
2341 ///
2342 /// \param FromType The type we're converting form.
2343 ///
2344 /// \param ToType The type we're converting to.
2345 ///
2346 /// \param ConvertedType The type that will be produced after applying
2347 /// this conversion.
2348 bool Sema::isObjCWritebackConversion(QualType FromType, QualType ToType,
2349                                      QualType &ConvertedType) {
2350   if (!getLangOpts().ObjCAutoRefCount ||
2351       Context.hasSameUnqualifiedType(FromType, ToType))
2352     return false;
2353 
2354   // Parameter must be a pointer to __autoreleasing (with no other qualifiers).
2355   QualType ToPointee;
2356   if (const PointerType *ToPointer = ToType->getAs<PointerType>())
2357     ToPointee = ToPointer->getPointeeType();
2358   else
2359     return false;
2360 
2361   Qualifiers ToQuals = ToPointee.getQualifiers();
2362   if (!ToPointee->isObjCLifetimeType() ||
2363       ToQuals.getObjCLifetime() != Qualifiers::OCL_Autoreleasing ||
2364       !ToQuals.withoutObjCLifetime().empty())
2365     return false;
2366 
2367   // Argument must be a pointer to __strong to __weak.
2368   QualType FromPointee;
2369   if (const PointerType *FromPointer = FromType->getAs<PointerType>())
2370     FromPointee = FromPointer->getPointeeType();
2371   else
2372     return false;
2373 
2374   Qualifiers FromQuals = FromPointee.getQualifiers();
2375   if (!FromPointee->isObjCLifetimeType() ||
2376       (FromQuals.getObjCLifetime() != Qualifiers::OCL_Strong &&
2377        FromQuals.getObjCLifetime() != Qualifiers::OCL_Weak))
2378     return false;
2379 
2380   // Make sure that we have compatible qualifiers.
2381   FromQuals.setObjCLifetime(Qualifiers::OCL_Autoreleasing);
2382   if (!ToQuals.compatiblyIncludes(FromQuals))
2383     return false;
2384 
2385   // Remove qualifiers from the pointee type we're converting from; they
2386   // aren't used in the compatibility check belong, and we'll be adding back
2387   // qualifiers (with __autoreleasing) if the compatibility check succeeds.
2388   FromPointee = FromPointee.getUnqualifiedType();
2389 
2390   // The unqualified form of the pointee types must be compatible.
2391   ToPointee = ToPointee.getUnqualifiedType();
2392   bool IncompatibleObjC;
2393   if (Context.typesAreCompatible(FromPointee, ToPointee))
2394     FromPointee = ToPointee;
2395   else if (!isObjCPointerConversion(FromPointee, ToPointee, FromPointee,
2396                                     IncompatibleObjC))
2397     return false;
2398 
2399   /// \brief Construct the type we're converting to, which is a pointer to
2400   /// __autoreleasing pointee.
2401   FromPointee = Context.getQualifiedType(FromPointee, FromQuals);
2402   ConvertedType = Context.getPointerType(FromPointee);
2403   return true;
2404 }
2405 
2406 bool Sema::IsBlockPointerConversion(QualType FromType, QualType ToType,
2407                                     QualType& ConvertedType) {
2408   QualType ToPointeeType;
2409   if (const BlockPointerType *ToBlockPtr =
2410         ToType->getAs<BlockPointerType>())
2411     ToPointeeType = ToBlockPtr->getPointeeType();
2412   else
2413     return false;
2414 
2415   QualType FromPointeeType;
2416   if (const BlockPointerType *FromBlockPtr =
2417       FromType->getAs<BlockPointerType>())
2418     FromPointeeType = FromBlockPtr->getPointeeType();
2419   else
2420     return false;
2421   // We have pointer to blocks, check whether the only
2422   // differences in the argument and result types are in Objective-C
2423   // pointer conversions. If so, we permit the conversion.
2424 
2425   const FunctionProtoType *FromFunctionType
2426     = FromPointeeType->getAs<FunctionProtoType>();
2427   const FunctionProtoType *ToFunctionType
2428     = ToPointeeType->getAs<FunctionProtoType>();
2429 
2430   if (!FromFunctionType || !ToFunctionType)
2431     return false;
2432 
2433   if (Context.hasSameType(FromPointeeType, ToPointeeType))
2434     return true;
2435 
2436   // Perform the quick checks that will tell us whether these
2437   // function types are obviously different.
2438   if (FromFunctionType->getNumParams() != ToFunctionType->getNumParams() ||
2439       FromFunctionType->isVariadic() != ToFunctionType->isVariadic())
2440     return false;
2441 
2442   FunctionType::ExtInfo FromEInfo = FromFunctionType->getExtInfo();
2443   FunctionType::ExtInfo ToEInfo = ToFunctionType->getExtInfo();
2444   if (FromEInfo != ToEInfo)
2445     return false;
2446 
2447   bool IncompatibleObjC = false;
2448   if (Context.hasSameType(FromFunctionType->getReturnType(),
2449                           ToFunctionType->getReturnType())) {
2450     // Okay, the types match exactly. Nothing to do.
2451   } else {
2452     QualType RHS = FromFunctionType->getReturnType();
2453     QualType LHS = ToFunctionType->getReturnType();
2454     if ((!getLangOpts().CPlusPlus || !RHS->isRecordType()) &&
2455         !RHS.hasQualifiers() && LHS.hasQualifiers())
2456        LHS = LHS.getUnqualifiedType();
2457 
2458      if (Context.hasSameType(RHS,LHS)) {
2459        // OK exact match.
2460      } else if (isObjCPointerConversion(RHS, LHS,
2461                                         ConvertedType, IncompatibleObjC)) {
2462      if (IncompatibleObjC)
2463        return false;
2464      // Okay, we have an Objective-C pointer conversion.
2465      }
2466      else
2467        return false;
2468    }
2469 
2470    // Check argument types.
2471    for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumParams();
2472         ArgIdx != NumArgs; ++ArgIdx) {
2473      IncompatibleObjC = false;
2474      QualType FromArgType = FromFunctionType->getParamType(ArgIdx);
2475      QualType ToArgType = ToFunctionType->getParamType(ArgIdx);
2476      if (Context.hasSameType(FromArgType, ToArgType)) {
2477        // Okay, the types match exactly. Nothing to do.
2478      } else if (isObjCPointerConversion(ToArgType, FromArgType,
2479                                         ConvertedType, IncompatibleObjC)) {
2480        if (IncompatibleObjC)
2481          return false;
2482        // Okay, we have an Objective-C pointer conversion.
2483      } else
2484        // Argument types are too different. Abort.
2485        return false;
2486    }
2487    if (LangOpts.ObjCAutoRefCount &&
2488        !Context.FunctionTypesMatchOnNSConsumedAttrs(FromFunctionType,
2489                                                     ToFunctionType))
2490      return false;
2491 
2492    ConvertedType = ToType;
2493    return true;
2494 }
2495 
2496 enum {
2497   ft_default,
2498   ft_different_class,
2499   ft_parameter_arity,
2500   ft_parameter_mismatch,
2501   ft_return_type,
2502   ft_qualifer_mismatch
2503 };
2504 
2505 /// HandleFunctionTypeMismatch - Gives diagnostic information for differeing
2506 /// function types.  Catches different number of parameter, mismatch in
2507 /// parameter types, and different return types.
2508 void Sema::HandleFunctionTypeMismatch(PartialDiagnostic &PDiag,
2509                                       QualType FromType, QualType ToType) {
2510   // If either type is not valid, include no extra info.
2511   if (FromType.isNull() || ToType.isNull()) {
2512     PDiag << ft_default;
2513     return;
2514   }
2515 
2516   // Get the function type from the pointers.
2517   if (FromType->isMemberPointerType() && ToType->isMemberPointerType()) {
2518     const MemberPointerType *FromMember = FromType->getAs<MemberPointerType>(),
2519                             *ToMember = ToType->getAs<MemberPointerType>();
2520     if (!Context.hasSameType(FromMember->getClass(), ToMember->getClass())) {
2521       PDiag << ft_different_class << QualType(ToMember->getClass(), 0)
2522             << QualType(FromMember->getClass(), 0);
2523       return;
2524     }
2525     FromType = FromMember->getPointeeType();
2526     ToType = ToMember->getPointeeType();
2527   }
2528 
2529   if (FromType->isPointerType())
2530     FromType = FromType->getPointeeType();
2531   if (ToType->isPointerType())
2532     ToType = ToType->getPointeeType();
2533 
2534   // Remove references.
2535   FromType = FromType.getNonReferenceType();
2536   ToType = ToType.getNonReferenceType();
2537 
2538   // Don't print extra info for non-specialized template functions.
2539   if (FromType->isInstantiationDependentType() &&
2540       !FromType->getAs<TemplateSpecializationType>()) {
2541     PDiag << ft_default;
2542     return;
2543   }
2544 
2545   // No extra info for same types.
2546   if (Context.hasSameType(FromType, ToType)) {
2547     PDiag << ft_default;
2548     return;
2549   }
2550 
2551   const FunctionProtoType *FromFunction = FromType->getAs<FunctionProtoType>(),
2552                           *ToFunction = ToType->getAs<FunctionProtoType>();
2553 
2554   // Both types need to be function types.
2555   if (!FromFunction || !ToFunction) {
2556     PDiag << ft_default;
2557     return;
2558   }
2559 
2560   if (FromFunction->getNumParams() != ToFunction->getNumParams()) {
2561     PDiag << ft_parameter_arity << ToFunction->getNumParams()
2562           << FromFunction->getNumParams();
2563     return;
2564   }
2565 
2566   // Handle different parameter types.
2567   unsigned ArgPos;
2568   if (!FunctionParamTypesAreEqual(FromFunction, ToFunction, &ArgPos)) {
2569     PDiag << ft_parameter_mismatch << ArgPos + 1
2570           << ToFunction->getParamType(ArgPos)
2571           << FromFunction->getParamType(ArgPos);
2572     return;
2573   }
2574 
2575   // Handle different return type.
2576   if (!Context.hasSameType(FromFunction->getReturnType(),
2577                            ToFunction->getReturnType())) {
2578     PDiag << ft_return_type << ToFunction->getReturnType()
2579           << FromFunction->getReturnType();
2580     return;
2581   }
2582 
2583   unsigned FromQuals = FromFunction->getTypeQuals(),
2584            ToQuals = ToFunction->getTypeQuals();
2585   if (FromQuals != ToQuals) {
2586     PDiag << ft_qualifer_mismatch << ToQuals << FromQuals;
2587     return;
2588   }
2589 
2590   // Unable to find a difference, so add no extra info.
2591   PDiag << ft_default;
2592 }
2593 
2594 /// FunctionParamTypesAreEqual - This routine checks two function proto types
2595 /// for equality of their argument types. Caller has already checked that
2596 /// they have same number of arguments.  If the parameters are different,
2597 /// ArgPos will have the parameter index of the first different parameter.
2598 bool Sema::FunctionParamTypesAreEqual(const FunctionProtoType *OldType,
2599                                       const FunctionProtoType *NewType,
2600                                       unsigned *ArgPos) {
2601   for (FunctionProtoType::param_type_iterator O = OldType->param_type_begin(),
2602                                               N = NewType->param_type_begin(),
2603                                               E = OldType->param_type_end();
2604        O && (O != E); ++O, ++N) {
2605     if (!Context.hasSameType(O->getUnqualifiedType(),
2606                              N->getUnqualifiedType())) {
2607       if (ArgPos)
2608         *ArgPos = O - OldType->param_type_begin();
2609       return false;
2610     }
2611   }
2612   return true;
2613 }
2614 
2615 /// CheckPointerConversion - Check the pointer conversion from the
2616 /// expression From to the type ToType. This routine checks for
2617 /// ambiguous or inaccessible derived-to-base pointer
2618 /// conversions for which IsPointerConversion has already returned
2619 /// true. It returns true and produces a diagnostic if there was an
2620 /// error, or returns false otherwise.
2621 bool Sema::CheckPointerConversion(Expr *From, QualType ToType,
2622                                   CastKind &Kind,
2623                                   CXXCastPath& BasePath,
2624                                   bool IgnoreBaseAccess) {
2625   QualType FromType = From->getType();
2626   bool IsCStyleOrFunctionalCast = IgnoreBaseAccess;
2627 
2628   Kind = CK_BitCast;
2629 
2630   if (!IsCStyleOrFunctionalCast && !FromType->isAnyPointerType() &&
2631       From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNotNull) ==
2632       Expr::NPCK_ZeroExpression) {
2633     if (Context.hasSameUnqualifiedType(From->getType(), Context.BoolTy))
2634       DiagRuntimeBehavior(From->getExprLoc(), From,
2635                           PDiag(diag::warn_impcast_bool_to_null_pointer)
2636                             << ToType << From->getSourceRange());
2637     else if (!isUnevaluatedContext())
2638       Diag(From->getExprLoc(), diag::warn_non_literal_null_pointer)
2639         << ToType << From->getSourceRange();
2640   }
2641   if (const PointerType *ToPtrType = ToType->getAs<PointerType>()) {
2642     if (const PointerType *FromPtrType = FromType->getAs<PointerType>()) {
2643       QualType FromPointeeType = FromPtrType->getPointeeType(),
2644                ToPointeeType   = ToPtrType->getPointeeType();
2645 
2646       if (FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2647           !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType)) {
2648         // We must have a derived-to-base conversion. Check an
2649         // ambiguous or inaccessible conversion.
2650         if (CheckDerivedToBaseConversion(FromPointeeType, ToPointeeType,
2651                                          From->getExprLoc(),
2652                                          From->getSourceRange(), &BasePath,
2653                                          IgnoreBaseAccess))
2654           return true;
2655 
2656         // The conversion was successful.
2657         Kind = CK_DerivedToBase;
2658       }
2659     }
2660   } else if (const ObjCObjectPointerType *ToPtrType =
2661                ToType->getAs<ObjCObjectPointerType>()) {
2662     if (const ObjCObjectPointerType *FromPtrType =
2663           FromType->getAs<ObjCObjectPointerType>()) {
2664       // Objective-C++ conversions are always okay.
2665       // FIXME: We should have a different class of conversions for the
2666       // Objective-C++ implicit conversions.
2667       if (FromPtrType->isObjCBuiltinType() || ToPtrType->isObjCBuiltinType())
2668         return false;
2669     } else if (FromType->isBlockPointerType()) {
2670       Kind = CK_BlockPointerToObjCPointerCast;
2671     } else {
2672       Kind = CK_CPointerToObjCPointerCast;
2673     }
2674   } else if (ToType->isBlockPointerType()) {
2675     if (!FromType->isBlockPointerType())
2676       Kind = CK_AnyPointerToBlockPointerCast;
2677   }
2678 
2679   // We shouldn't fall into this case unless it's valid for other
2680   // reasons.
2681   if (From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNull))
2682     Kind = CK_NullToPointer;
2683 
2684   return false;
2685 }
2686 
2687 /// IsMemberPointerConversion - Determines whether the conversion of the
2688 /// expression From, which has the (possibly adjusted) type FromType, can be
2689 /// converted to the type ToType via a member pointer conversion (C++ 4.11).
2690 /// If so, returns true and places the converted type (that might differ from
2691 /// ToType in its cv-qualifiers at some level) into ConvertedType.
2692 bool Sema::IsMemberPointerConversion(Expr *From, QualType FromType,
2693                                      QualType ToType,
2694                                      bool InOverloadResolution,
2695                                      QualType &ConvertedType) {
2696   const MemberPointerType *ToTypePtr = ToType->getAs<MemberPointerType>();
2697   if (!ToTypePtr)
2698     return false;
2699 
2700   // A null pointer constant can be converted to a member pointer (C++ 4.11p1)
2701   if (From->isNullPointerConstant(Context,
2702                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
2703                                         : Expr::NPC_ValueDependentIsNull)) {
2704     ConvertedType = ToType;
2705     return true;
2706   }
2707 
2708   // Otherwise, both types have to be member pointers.
2709   const MemberPointerType *FromTypePtr = FromType->getAs<MemberPointerType>();
2710   if (!FromTypePtr)
2711     return false;
2712 
2713   // A pointer to member of B can be converted to a pointer to member of D,
2714   // where D is derived from B (C++ 4.11p2).
2715   QualType FromClass(FromTypePtr->getClass(), 0);
2716   QualType ToClass(ToTypePtr->getClass(), 0);
2717 
2718   if (!Context.hasSameUnqualifiedType(FromClass, ToClass) &&
2719       !RequireCompleteType(From->getLocStart(), ToClass, 0) &&
2720       IsDerivedFrom(ToClass, FromClass)) {
2721     ConvertedType = Context.getMemberPointerType(FromTypePtr->getPointeeType(),
2722                                                  ToClass.getTypePtr());
2723     return true;
2724   }
2725 
2726   return false;
2727 }
2728 
2729 /// CheckMemberPointerConversion - Check the member pointer conversion from the
2730 /// expression From to the type ToType. This routine checks for ambiguous or
2731 /// virtual or inaccessible base-to-derived member pointer conversions
2732 /// for which IsMemberPointerConversion has already returned true. It returns
2733 /// true and produces a diagnostic if there was an error, or returns false
2734 /// otherwise.
2735 bool Sema::CheckMemberPointerConversion(Expr *From, QualType ToType,
2736                                         CastKind &Kind,
2737                                         CXXCastPath &BasePath,
2738                                         bool IgnoreBaseAccess) {
2739   QualType FromType = From->getType();
2740   const MemberPointerType *FromPtrType = FromType->getAs<MemberPointerType>();
2741   if (!FromPtrType) {
2742     // This must be a null pointer to member pointer conversion
2743     assert(From->isNullPointerConstant(Context,
2744                                        Expr::NPC_ValueDependentIsNull) &&
2745            "Expr must be null pointer constant!");
2746     Kind = CK_NullToMemberPointer;
2747     return false;
2748   }
2749 
2750   const MemberPointerType *ToPtrType = ToType->getAs<MemberPointerType>();
2751   assert(ToPtrType && "No member pointer cast has a target type "
2752                       "that is not a member pointer.");
2753 
2754   QualType FromClass = QualType(FromPtrType->getClass(), 0);
2755   QualType ToClass   = QualType(ToPtrType->getClass(), 0);
2756 
2757   // FIXME: What about dependent types?
2758   assert(FromClass->isRecordType() && "Pointer into non-class.");
2759   assert(ToClass->isRecordType() && "Pointer into non-class.");
2760 
2761   CXXBasePaths Paths(/*FindAmbiguities=*/true, /*RecordPaths=*/true,
2762                      /*DetectVirtual=*/true);
2763   bool DerivationOkay = IsDerivedFrom(ToClass, FromClass, Paths);
2764   assert(DerivationOkay &&
2765          "Should not have been called if derivation isn't OK.");
2766   (void)DerivationOkay;
2767 
2768   if (Paths.isAmbiguous(Context.getCanonicalType(FromClass).
2769                                   getUnqualifiedType())) {
2770     std::string PathDisplayStr = getAmbiguousPathsDisplayString(Paths);
2771     Diag(From->getExprLoc(), diag::err_ambiguous_memptr_conv)
2772       << 0 << FromClass << ToClass << PathDisplayStr << From->getSourceRange();
2773     return true;
2774   }
2775 
2776   if (const RecordType *VBase = Paths.getDetectedVirtual()) {
2777     Diag(From->getExprLoc(), diag::err_memptr_conv_via_virtual)
2778       << FromClass << ToClass << QualType(VBase, 0)
2779       << From->getSourceRange();
2780     return true;
2781   }
2782 
2783   if (!IgnoreBaseAccess)
2784     CheckBaseClassAccess(From->getExprLoc(), FromClass, ToClass,
2785                          Paths.front(),
2786                          diag::err_downcast_from_inaccessible_base);
2787 
2788   // Must be a base to derived member conversion.
2789   BuildBasePathArray(Paths, BasePath);
2790   Kind = CK_BaseToDerivedMemberPointer;
2791   return false;
2792 }
2793 
2794 /// Determine whether the lifetime conversion between the two given
2795 /// qualifiers sets is nontrivial.
2796 static bool isNonTrivialObjCLifetimeConversion(Qualifiers FromQuals,
2797                                                Qualifiers ToQuals) {
2798   // Converting anything to const __unsafe_unretained is trivial.
2799   if (ToQuals.hasConst() &&
2800       ToQuals.getObjCLifetime() == Qualifiers::OCL_ExplicitNone)
2801     return false;
2802 
2803   return true;
2804 }
2805 
2806 /// IsQualificationConversion - Determines whether the conversion from
2807 /// an rvalue of type FromType to ToType is a qualification conversion
2808 /// (C++ 4.4).
2809 ///
2810 /// \param ObjCLifetimeConversion Output parameter that will be set to indicate
2811 /// when the qualification conversion involves a change in the Objective-C
2812 /// object lifetime.
2813 bool
2814 Sema::IsQualificationConversion(QualType FromType, QualType ToType,
2815                                 bool CStyle, bool &ObjCLifetimeConversion) {
2816   FromType = Context.getCanonicalType(FromType);
2817   ToType = Context.getCanonicalType(ToType);
2818   ObjCLifetimeConversion = false;
2819 
2820   // If FromType and ToType are the same type, this is not a
2821   // qualification conversion.
2822   if (FromType.getUnqualifiedType() == ToType.getUnqualifiedType())
2823     return false;
2824 
2825   // (C++ 4.4p4):
2826   //   A conversion can add cv-qualifiers at levels other than the first
2827   //   in multi-level pointers, subject to the following rules: [...]
2828   bool PreviousToQualsIncludeConst = true;
2829   bool UnwrappedAnyPointer = false;
2830   while (Context.UnwrapSimilarPointerTypes(FromType, ToType)) {
2831     // Within each iteration of the loop, we check the qualifiers to
2832     // determine if this still looks like a qualification
2833     // conversion. Then, if all is well, we unwrap one more level of
2834     // pointers or pointers-to-members and do it all again
2835     // until there are no more pointers or pointers-to-members left to
2836     // unwrap.
2837     UnwrappedAnyPointer = true;
2838 
2839     Qualifiers FromQuals = FromType.getQualifiers();
2840     Qualifiers ToQuals = ToType.getQualifiers();
2841 
2842     // Objective-C ARC:
2843     //   Check Objective-C lifetime conversions.
2844     if (FromQuals.getObjCLifetime() != ToQuals.getObjCLifetime() &&
2845         UnwrappedAnyPointer) {
2846       if (ToQuals.compatiblyIncludesObjCLifetime(FromQuals)) {
2847         if (isNonTrivialObjCLifetimeConversion(FromQuals, ToQuals))
2848           ObjCLifetimeConversion = true;
2849         FromQuals.removeObjCLifetime();
2850         ToQuals.removeObjCLifetime();
2851       } else {
2852         // Qualification conversions cannot cast between different
2853         // Objective-C lifetime qualifiers.
2854         return false;
2855       }
2856     }
2857 
2858     // Allow addition/removal of GC attributes but not changing GC attributes.
2859     if (FromQuals.getObjCGCAttr() != ToQuals.getObjCGCAttr() &&
2860         (!FromQuals.hasObjCGCAttr() || !ToQuals.hasObjCGCAttr())) {
2861       FromQuals.removeObjCGCAttr();
2862       ToQuals.removeObjCGCAttr();
2863     }
2864 
2865     //   -- for every j > 0, if const is in cv 1,j then const is in cv
2866     //      2,j, and similarly for volatile.
2867     if (!CStyle && !ToQuals.compatiblyIncludes(FromQuals))
2868       return false;
2869 
2870     //   -- if the cv 1,j and cv 2,j are different, then const is in
2871     //      every cv for 0 < k < j.
2872     if (!CStyle && FromQuals.getCVRQualifiers() != ToQuals.getCVRQualifiers()
2873         && !PreviousToQualsIncludeConst)
2874       return false;
2875 
2876     // Keep track of whether all prior cv-qualifiers in the "to" type
2877     // include const.
2878     PreviousToQualsIncludeConst
2879       = PreviousToQualsIncludeConst && ToQuals.hasConst();
2880   }
2881 
2882   // We are left with FromType and ToType being the pointee types
2883   // after unwrapping the original FromType and ToType the same number
2884   // of types. If we unwrapped any pointers, and if FromType and
2885   // ToType have the same unqualified type (since we checked
2886   // qualifiers above), then this is a qualification conversion.
2887   return UnwrappedAnyPointer && Context.hasSameUnqualifiedType(FromType,ToType);
2888 }
2889 
2890 /// \brief - Determine whether this is a conversion from a scalar type to an
2891 /// atomic type.
2892 ///
2893 /// If successful, updates \c SCS's second and third steps in the conversion
2894 /// sequence to finish the conversion.
2895 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
2896                                 bool InOverloadResolution,
2897                                 StandardConversionSequence &SCS,
2898                                 bool CStyle) {
2899   const AtomicType *ToAtomic = ToType->getAs<AtomicType>();
2900   if (!ToAtomic)
2901     return false;
2902 
2903   StandardConversionSequence InnerSCS;
2904   if (!IsStandardConversion(S, From, ToAtomic->getValueType(),
2905                             InOverloadResolution, InnerSCS,
2906                             CStyle, /*AllowObjCWritebackConversion=*/false))
2907     return false;
2908 
2909   SCS.Second = InnerSCS.Second;
2910   SCS.setToType(1, InnerSCS.getToType(1));
2911   SCS.Third = InnerSCS.Third;
2912   SCS.QualificationIncludesObjCLifetime
2913     = InnerSCS.QualificationIncludesObjCLifetime;
2914   SCS.setToType(2, InnerSCS.getToType(2));
2915   return true;
2916 }
2917 
2918 static bool isFirstArgumentCompatibleWithType(ASTContext &Context,
2919                                               CXXConstructorDecl *Constructor,
2920                                               QualType Type) {
2921   const FunctionProtoType *CtorType =
2922       Constructor->getType()->getAs<FunctionProtoType>();
2923   if (CtorType->getNumParams() > 0) {
2924     QualType FirstArg = CtorType->getParamType(0);
2925     if (Context.hasSameUnqualifiedType(Type, FirstArg.getNonReferenceType()))
2926       return true;
2927   }
2928   return false;
2929 }
2930 
2931 static OverloadingResult
2932 IsInitializerListConstructorConversion(Sema &S, Expr *From, QualType ToType,
2933                                        CXXRecordDecl *To,
2934                                        UserDefinedConversionSequence &User,
2935                                        OverloadCandidateSet &CandidateSet,
2936                                        bool AllowExplicit) {
2937   DeclContext::lookup_result R = S.LookupConstructors(To);
2938   for (DeclContext::lookup_iterator Con = R.begin(), ConEnd = R.end();
2939        Con != ConEnd; ++Con) {
2940     NamedDecl *D = *Con;
2941     DeclAccessPair FoundDecl = DeclAccessPair::make(D, D->getAccess());
2942 
2943     // Find the constructor (which may be a template).
2944     CXXConstructorDecl *Constructor = nullptr;
2945     FunctionTemplateDecl *ConstructorTmpl
2946       = dyn_cast<FunctionTemplateDecl>(D);
2947     if (ConstructorTmpl)
2948       Constructor
2949         = cast<CXXConstructorDecl>(ConstructorTmpl->getTemplatedDecl());
2950     else
2951       Constructor = cast<CXXConstructorDecl>(D);
2952 
2953     bool Usable = !Constructor->isInvalidDecl() &&
2954                   S.isInitListConstructor(Constructor) &&
2955                   (AllowExplicit || !Constructor->isExplicit());
2956     if (Usable) {
2957       // If the first argument is (a reference to) the target type,
2958       // suppress conversions.
2959       bool SuppressUserConversions =
2960           isFirstArgumentCompatibleWithType(S.Context, Constructor, ToType);
2961       if (ConstructorTmpl)
2962         S.AddTemplateOverloadCandidate(ConstructorTmpl, FoundDecl,
2963                                        /*ExplicitArgs*/ nullptr,
2964                                        From, CandidateSet,
2965                                        SuppressUserConversions);
2966       else
2967         S.AddOverloadCandidate(Constructor, FoundDecl,
2968                                From, CandidateSet,
2969                                SuppressUserConversions);
2970     }
2971   }
2972 
2973   bool HadMultipleCandidates = (CandidateSet.size() > 1);
2974 
2975   OverloadCandidateSet::iterator Best;
2976   switch (CandidateSet.BestViableFunction(S, From->getLocStart(), Best, true)) {
2977   case OR_Success: {
2978     // Record the standard conversion we used and the conversion function.
2979     CXXConstructorDecl *Constructor = cast<CXXConstructorDecl>(Best->Function);
2980     QualType ThisType = Constructor->getThisType(S.Context);
2981     // Initializer lists don't have conversions as such.
2982     User.Before.setAsIdentityConversion();
2983     User.HadMultipleCandidates = HadMultipleCandidates;
2984     User.ConversionFunction = Constructor;
2985     User.FoundConversionFunction = Best->FoundDecl;
2986     User.After.setAsIdentityConversion();
2987     User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
2988     User.After.setAllToTypes(ToType);
2989     return OR_Success;
2990   }
2991 
2992   case OR_No_Viable_Function:
2993     return OR_No_Viable_Function;
2994   case OR_Deleted:
2995     return OR_Deleted;
2996   case OR_Ambiguous:
2997     return OR_Ambiguous;
2998   }
2999 
3000   llvm_unreachable("Invalid OverloadResult!");
3001 }
3002 
3003 /// Determines whether there is a user-defined conversion sequence
3004 /// (C++ [over.ics.user]) that converts expression From to the type
3005 /// ToType. If such a conversion exists, User will contain the
3006 /// user-defined conversion sequence that performs such a conversion
3007 /// and this routine will return true. Otherwise, this routine returns
3008 /// false and User is unspecified.
3009 ///
3010 /// \param AllowExplicit  true if the conversion should consider C++0x
3011 /// "explicit" conversion functions as well as non-explicit conversion
3012 /// functions (C++0x [class.conv.fct]p2).
3013 ///
3014 /// \param AllowObjCConversionOnExplicit true if the conversion should
3015 /// allow an extra Objective-C pointer conversion on uses of explicit
3016 /// constructors. Requires \c AllowExplicit to also be set.
3017 static OverloadingResult
3018 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
3019                         UserDefinedConversionSequence &User,
3020                         OverloadCandidateSet &CandidateSet,
3021                         bool AllowExplicit,
3022                         bool AllowObjCConversionOnExplicit) {
3023   assert(AllowExplicit || !AllowObjCConversionOnExplicit);
3024 
3025   // Whether we will only visit constructors.
3026   bool ConstructorsOnly = false;
3027 
3028   // If the type we are conversion to is a class type, enumerate its
3029   // constructors.
3030   if (const RecordType *ToRecordType = ToType->getAs<RecordType>()) {
3031     // C++ [over.match.ctor]p1:
3032     //   When objects of class type are direct-initialized (8.5), or
3033     //   copy-initialized from an expression of the same or a
3034     //   derived class type (8.5), overload resolution selects the
3035     //   constructor. [...] For copy-initialization, the candidate
3036     //   functions are all the converting constructors (12.3.1) of
3037     //   that class. The argument list is the expression-list within
3038     //   the parentheses of the initializer.
3039     if (S.Context.hasSameUnqualifiedType(ToType, From->getType()) ||
3040         (From->getType()->getAs<RecordType>() &&
3041          S.IsDerivedFrom(From->getType(), ToType)))
3042       ConstructorsOnly = true;
3043 
3044     S.RequireCompleteType(From->getExprLoc(), ToType, 0);
3045     // RequireCompleteType may have returned true due to some invalid decl
3046     // during template instantiation, but ToType may be complete enough now
3047     // to try to recover.
3048     if (ToType->isIncompleteType()) {
3049       // We're not going to find any constructors.
3050     } else if (CXXRecordDecl *ToRecordDecl
3051                  = dyn_cast<CXXRecordDecl>(ToRecordType->getDecl())) {
3052 
3053       Expr **Args = &From;
3054       unsigned NumArgs = 1;
3055       bool ListInitializing = false;
3056       if (InitListExpr *InitList = dyn_cast<InitListExpr>(From)) {
3057         // But first, see if there is an init-list-constructor that will work.
3058         OverloadingResult Result = IsInitializerListConstructorConversion(
3059             S, From, ToType, ToRecordDecl, User, CandidateSet, AllowExplicit);
3060         if (Result != OR_No_Viable_Function)
3061           return Result;
3062         // Never mind.
3063         CandidateSet.clear();
3064 
3065         // If we're list-initializing, we pass the individual elements as
3066         // arguments, not the entire list.
3067         Args = InitList->getInits();
3068         NumArgs = InitList->getNumInits();
3069         ListInitializing = true;
3070       }
3071 
3072       DeclContext::lookup_result R = S.LookupConstructors(ToRecordDecl);
3073       for (DeclContext::lookup_iterator Con = R.begin(), ConEnd = R.end();
3074            Con != ConEnd; ++Con) {
3075         NamedDecl *D = *Con;
3076         DeclAccessPair FoundDecl = DeclAccessPair::make(D, D->getAccess());
3077 
3078         // Find the constructor (which may be a template).
3079         CXXConstructorDecl *Constructor = nullptr;
3080         FunctionTemplateDecl *ConstructorTmpl
3081           = dyn_cast<FunctionTemplateDecl>(D);
3082         if (ConstructorTmpl)
3083           Constructor
3084             = cast<CXXConstructorDecl>(ConstructorTmpl->getTemplatedDecl());
3085         else
3086           Constructor = cast<CXXConstructorDecl>(D);
3087 
3088         bool Usable = !Constructor->isInvalidDecl();
3089         if (ListInitializing)
3090           Usable = Usable && (AllowExplicit || !Constructor->isExplicit());
3091         else
3092           Usable = Usable &&Constructor->isConvertingConstructor(AllowExplicit);
3093         if (Usable) {
3094           bool SuppressUserConversions = !ConstructorsOnly;
3095           if (SuppressUserConversions && ListInitializing) {
3096             SuppressUserConversions = false;
3097             if (NumArgs == 1) {
3098               // If the first argument is (a reference to) the target type,
3099               // suppress conversions.
3100               SuppressUserConversions = isFirstArgumentCompatibleWithType(
3101                                                 S.Context, Constructor, ToType);
3102             }
3103           }
3104           if (ConstructorTmpl)
3105             S.AddTemplateOverloadCandidate(ConstructorTmpl, FoundDecl,
3106                                            /*ExplicitArgs*/ nullptr,
3107                                            llvm::makeArrayRef(Args, NumArgs),
3108                                            CandidateSet, SuppressUserConversions);
3109           else
3110             // Allow one user-defined conversion when user specifies a
3111             // From->ToType conversion via an static cast (c-style, etc).
3112             S.AddOverloadCandidate(Constructor, FoundDecl,
3113                                    llvm::makeArrayRef(Args, NumArgs),
3114                                    CandidateSet, SuppressUserConversions);
3115         }
3116       }
3117     }
3118   }
3119 
3120   // Enumerate conversion functions, if we're allowed to.
3121   if (ConstructorsOnly || isa<InitListExpr>(From)) {
3122   } else if (S.RequireCompleteType(From->getLocStart(), From->getType(), 0)) {
3123     // No conversion functions from incomplete types.
3124   } else if (const RecordType *FromRecordType
3125                                    = From->getType()->getAs<RecordType>()) {
3126     if (CXXRecordDecl *FromRecordDecl
3127          = dyn_cast<CXXRecordDecl>(FromRecordType->getDecl())) {
3128       // Add all of the conversion functions as candidates.
3129       std::pair<CXXRecordDecl::conversion_iterator,
3130                 CXXRecordDecl::conversion_iterator>
3131         Conversions = FromRecordDecl->getVisibleConversionFunctions();
3132       for (CXXRecordDecl::conversion_iterator
3133              I = Conversions.first, E = Conversions.second; I != E; ++I) {
3134         DeclAccessPair FoundDecl = I.getPair();
3135         NamedDecl *D = FoundDecl.getDecl();
3136         CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
3137         if (isa<UsingShadowDecl>(D))
3138           D = cast<UsingShadowDecl>(D)->getTargetDecl();
3139 
3140         CXXConversionDecl *Conv;
3141         FunctionTemplateDecl *ConvTemplate;
3142         if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
3143           Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
3144         else
3145           Conv = cast<CXXConversionDecl>(D);
3146 
3147         if (AllowExplicit || !Conv->isExplicit()) {
3148           if (ConvTemplate)
3149             S.AddTemplateConversionCandidate(ConvTemplate, FoundDecl,
3150                                              ActingContext, From, ToType,
3151                                              CandidateSet,
3152                                              AllowObjCConversionOnExplicit);
3153           else
3154             S.AddConversionCandidate(Conv, FoundDecl, ActingContext,
3155                                      From, ToType, CandidateSet,
3156                                      AllowObjCConversionOnExplicit);
3157         }
3158       }
3159     }
3160   }
3161 
3162   bool HadMultipleCandidates = (CandidateSet.size() > 1);
3163 
3164   OverloadCandidateSet::iterator Best;
3165   switch (CandidateSet.BestViableFunction(S, From->getLocStart(), Best, true)) {
3166   case OR_Success:
3167     // Record the standard conversion we used and the conversion function.
3168     if (CXXConstructorDecl *Constructor
3169           = dyn_cast<CXXConstructorDecl>(Best->Function)) {
3170       // C++ [over.ics.user]p1:
3171       //   If the user-defined conversion is specified by a
3172       //   constructor (12.3.1), the initial standard conversion
3173       //   sequence converts the source type to the type required by
3174       //   the argument of the constructor.
3175       //
3176       QualType ThisType = Constructor->getThisType(S.Context);
3177       if (isa<InitListExpr>(From)) {
3178         // Initializer lists don't have conversions as such.
3179         User.Before.setAsIdentityConversion();
3180       } else {
3181         if (Best->Conversions[0].isEllipsis())
3182           User.EllipsisConversion = true;
3183         else {
3184           User.Before = Best->Conversions[0].Standard;
3185           User.EllipsisConversion = false;
3186         }
3187       }
3188       User.HadMultipleCandidates = HadMultipleCandidates;
3189       User.ConversionFunction = Constructor;
3190       User.FoundConversionFunction = Best->FoundDecl;
3191       User.After.setAsIdentityConversion();
3192       User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
3193       User.After.setAllToTypes(ToType);
3194       return OR_Success;
3195     }
3196     if (CXXConversionDecl *Conversion
3197                  = dyn_cast<CXXConversionDecl>(Best->Function)) {
3198       // C++ [over.ics.user]p1:
3199       //
3200       //   [...] If the user-defined conversion is specified by a
3201       //   conversion function (12.3.2), the initial standard
3202       //   conversion sequence converts the source type to the
3203       //   implicit object parameter of the conversion function.
3204       User.Before = Best->Conversions[0].Standard;
3205       User.HadMultipleCandidates = HadMultipleCandidates;
3206       User.ConversionFunction = Conversion;
3207       User.FoundConversionFunction = Best->FoundDecl;
3208       User.EllipsisConversion = false;
3209 
3210       // C++ [over.ics.user]p2:
3211       //   The second standard conversion sequence converts the
3212       //   result of the user-defined conversion to the target type
3213       //   for the sequence. Since an implicit conversion sequence
3214       //   is an initialization, the special rules for
3215       //   initialization by user-defined conversion apply when
3216       //   selecting the best user-defined conversion for a
3217       //   user-defined conversion sequence (see 13.3.3 and
3218       //   13.3.3.1).
3219       User.After = Best->FinalConversion;
3220       return OR_Success;
3221     }
3222     llvm_unreachable("Not a constructor or conversion function?");
3223 
3224   case OR_No_Viable_Function:
3225     return OR_No_Viable_Function;
3226   case OR_Deleted:
3227     // No conversion here! We're done.
3228     return OR_Deleted;
3229 
3230   case OR_Ambiguous:
3231     return OR_Ambiguous;
3232   }
3233 
3234   llvm_unreachable("Invalid OverloadResult!");
3235 }
3236 
3237 bool
3238 Sema::DiagnoseMultipleUserDefinedConversion(Expr *From, QualType ToType) {
3239   ImplicitConversionSequence ICS;
3240   OverloadCandidateSet CandidateSet(From->getExprLoc(),
3241                                     OverloadCandidateSet::CSK_Normal);
3242   OverloadingResult OvResult =
3243     IsUserDefinedConversion(*this, From, ToType, ICS.UserDefined,
3244                             CandidateSet, false, false);
3245   if (OvResult == OR_Ambiguous)
3246     Diag(From->getLocStart(), diag::err_typecheck_ambiguous_condition)
3247         << From->getType() << ToType << From->getSourceRange();
3248   else if (OvResult == OR_No_Viable_Function && !CandidateSet.empty()) {
3249     if (!RequireCompleteType(From->getLocStart(), ToType,
3250                              diag::err_typecheck_nonviable_condition_incomplete,
3251                              From->getType(), From->getSourceRange()))
3252       Diag(From->getLocStart(), diag::err_typecheck_nonviable_condition)
3253           << From->getType() << From->getSourceRange() << ToType;
3254   } else
3255     return false;
3256   CandidateSet.NoteCandidates(*this, OCD_AllCandidates, From);
3257   return true;
3258 }
3259 
3260 /// \brief Compare the user-defined conversion functions or constructors
3261 /// of two user-defined conversion sequences to determine whether any ordering
3262 /// is possible.
3263 static ImplicitConversionSequence::CompareKind
3264 compareConversionFunctions(Sema &S, FunctionDecl *Function1,
3265                            FunctionDecl *Function2) {
3266   if (!S.getLangOpts().ObjC1 || !S.getLangOpts().CPlusPlus11)
3267     return ImplicitConversionSequence::Indistinguishable;
3268 
3269   // Objective-C++:
3270   //   If both conversion functions are implicitly-declared conversions from
3271   //   a lambda closure type to a function pointer and a block pointer,
3272   //   respectively, always prefer the conversion to a function pointer,
3273   //   because the function pointer is more lightweight and is more likely
3274   //   to keep code working.
3275   CXXConversionDecl *Conv1 = dyn_cast_or_null<CXXConversionDecl>(Function1);
3276   if (!Conv1)
3277     return ImplicitConversionSequence::Indistinguishable;
3278 
3279   CXXConversionDecl *Conv2 = dyn_cast<CXXConversionDecl>(Function2);
3280   if (!Conv2)
3281     return ImplicitConversionSequence::Indistinguishable;
3282 
3283   if (Conv1->getParent()->isLambda() && Conv2->getParent()->isLambda()) {
3284     bool Block1 = Conv1->getConversionType()->isBlockPointerType();
3285     bool Block2 = Conv2->getConversionType()->isBlockPointerType();
3286     if (Block1 != Block2)
3287       return Block1 ? ImplicitConversionSequence::Worse
3288                     : ImplicitConversionSequence::Better;
3289   }
3290 
3291   return ImplicitConversionSequence::Indistinguishable;
3292 }
3293 
3294 static bool hasDeprecatedStringLiteralToCharPtrConversion(
3295     const ImplicitConversionSequence &ICS) {
3296   return (ICS.isStandard() && ICS.Standard.DeprecatedStringLiteralToCharPtr) ||
3297          (ICS.isUserDefined() &&
3298           ICS.UserDefined.Before.DeprecatedStringLiteralToCharPtr);
3299 }
3300 
3301 /// CompareImplicitConversionSequences - Compare two implicit
3302 /// conversion sequences to determine whether one is better than the
3303 /// other or if they are indistinguishable (C++ 13.3.3.2).
3304 static ImplicitConversionSequence::CompareKind
3305 CompareImplicitConversionSequences(Sema &S,
3306                                    const ImplicitConversionSequence& ICS1,
3307                                    const ImplicitConversionSequence& ICS2)
3308 {
3309   // (C++ 13.3.3.2p2): When comparing the basic forms of implicit
3310   // conversion sequences (as defined in 13.3.3.1)
3311   //   -- a standard conversion sequence (13.3.3.1.1) is a better
3312   //      conversion sequence than a user-defined conversion sequence or
3313   //      an ellipsis conversion sequence, and
3314   //   -- a user-defined conversion sequence (13.3.3.1.2) is a better
3315   //      conversion sequence than an ellipsis conversion sequence
3316   //      (13.3.3.1.3).
3317   //
3318   // C++0x [over.best.ics]p10:
3319   //   For the purpose of ranking implicit conversion sequences as
3320   //   described in 13.3.3.2, the ambiguous conversion sequence is
3321   //   treated as a user-defined sequence that is indistinguishable
3322   //   from any other user-defined conversion sequence.
3323 
3324   // String literal to 'char *' conversion has been deprecated in C++03. It has
3325   // been removed from C++11. We still accept this conversion, if it happens at
3326   // the best viable function. Otherwise, this conversion is considered worse
3327   // than ellipsis conversion. Consider this as an extension; this is not in the
3328   // standard. For example:
3329   //
3330   // int &f(...);    // #1
3331   // void f(char*);  // #2
3332   // void g() { int &r = f("foo"); }
3333   //
3334   // In C++03, we pick #2 as the best viable function.
3335   // In C++11, we pick #1 as the best viable function, because ellipsis
3336   // conversion is better than string-literal to char* conversion (since there
3337   // is no such conversion in C++11). If there was no #1 at all or #1 couldn't
3338   // convert arguments, #2 would be the best viable function in C++11.
3339   // If the best viable function has this conversion, a warning will be issued
3340   // in C++03, or an ExtWarn (+SFINAE failure) will be issued in C++11.
3341 
3342   if (S.getLangOpts().CPlusPlus11 && !S.getLangOpts().WritableStrings &&
3343       hasDeprecatedStringLiteralToCharPtrConversion(ICS1) !=
3344       hasDeprecatedStringLiteralToCharPtrConversion(ICS2))
3345     return hasDeprecatedStringLiteralToCharPtrConversion(ICS1)
3346                ? ImplicitConversionSequence::Worse
3347                : ImplicitConversionSequence::Better;
3348 
3349   if (ICS1.getKindRank() < ICS2.getKindRank())
3350     return ImplicitConversionSequence::Better;
3351   if (ICS2.getKindRank() < ICS1.getKindRank())
3352     return ImplicitConversionSequence::Worse;
3353 
3354   // The following checks require both conversion sequences to be of
3355   // the same kind.
3356   if (ICS1.getKind() != ICS2.getKind())
3357     return ImplicitConversionSequence::Indistinguishable;
3358 
3359   ImplicitConversionSequence::CompareKind Result =
3360       ImplicitConversionSequence::Indistinguishable;
3361 
3362   // Two implicit conversion sequences of the same form are
3363   // indistinguishable conversion sequences unless one of the
3364   // following rules apply: (C++ 13.3.3.2p3):
3365   if (ICS1.isStandard())
3366     Result = CompareStandardConversionSequences(S,
3367                                                 ICS1.Standard, ICS2.Standard);
3368   else if (ICS1.isUserDefined()) {
3369     // User-defined conversion sequence U1 is a better conversion
3370     // sequence than another user-defined conversion sequence U2 if
3371     // they contain the same user-defined conversion function or
3372     // constructor and if the second standard conversion sequence of
3373     // U1 is better than the second standard conversion sequence of
3374     // U2 (C++ 13.3.3.2p3).
3375     if (ICS1.UserDefined.ConversionFunction ==
3376           ICS2.UserDefined.ConversionFunction)
3377       Result = CompareStandardConversionSequences(S,
3378                                                   ICS1.UserDefined.After,
3379                                                   ICS2.UserDefined.After);
3380     else
3381       Result = compareConversionFunctions(S,
3382                                           ICS1.UserDefined.ConversionFunction,
3383                                           ICS2.UserDefined.ConversionFunction);
3384   }
3385 
3386   // List-initialization sequence L1 is a better conversion sequence than
3387   // list-initialization sequence L2 if L1 converts to std::initializer_list<X>
3388   // for some X and L2 does not.
3389   if (Result == ImplicitConversionSequence::Indistinguishable &&
3390       !ICS1.isBad()) {
3391     if (ICS1.isStdInitializerListElement() &&
3392         !ICS2.isStdInitializerListElement())
3393       return ImplicitConversionSequence::Better;
3394     if (!ICS1.isStdInitializerListElement() &&
3395         ICS2.isStdInitializerListElement())
3396       return ImplicitConversionSequence::Worse;
3397   }
3398 
3399   return Result;
3400 }
3401 
3402 static bool hasSimilarType(ASTContext &Context, QualType T1, QualType T2) {
3403   while (Context.UnwrapSimilarPointerTypes(T1, T2)) {
3404     Qualifiers Quals;
3405     T1 = Context.getUnqualifiedArrayType(T1, Quals);
3406     T2 = Context.getUnqualifiedArrayType(T2, Quals);
3407   }
3408 
3409   return Context.hasSameUnqualifiedType(T1, T2);
3410 }
3411 
3412 // Per 13.3.3.2p3, compare the given standard conversion sequences to
3413 // determine if one is a proper subset of the other.
3414 static ImplicitConversionSequence::CompareKind
3415 compareStandardConversionSubsets(ASTContext &Context,
3416                                  const StandardConversionSequence& SCS1,
3417                                  const StandardConversionSequence& SCS2) {
3418   ImplicitConversionSequence::CompareKind Result
3419     = ImplicitConversionSequence::Indistinguishable;
3420 
3421   // the identity conversion sequence is considered to be a subsequence of
3422   // any non-identity conversion sequence
3423   if (SCS1.isIdentityConversion() && !SCS2.isIdentityConversion())
3424     return ImplicitConversionSequence::Better;
3425   else if (!SCS1.isIdentityConversion() && SCS2.isIdentityConversion())
3426     return ImplicitConversionSequence::Worse;
3427 
3428   if (SCS1.Second != SCS2.Second) {
3429     if (SCS1.Second == ICK_Identity)
3430       Result = ImplicitConversionSequence::Better;
3431     else if (SCS2.Second == ICK_Identity)
3432       Result = ImplicitConversionSequence::Worse;
3433     else
3434       return ImplicitConversionSequence::Indistinguishable;
3435   } else if (!hasSimilarType(Context, SCS1.getToType(1), SCS2.getToType(1)))
3436     return ImplicitConversionSequence::Indistinguishable;
3437 
3438   if (SCS1.Third == SCS2.Third) {
3439     return Context.hasSameType(SCS1.getToType(2), SCS2.getToType(2))? Result
3440                              : ImplicitConversionSequence::Indistinguishable;
3441   }
3442 
3443   if (SCS1.Third == ICK_Identity)
3444     return Result == ImplicitConversionSequence::Worse
3445              ? ImplicitConversionSequence::Indistinguishable
3446              : ImplicitConversionSequence::Better;
3447 
3448   if (SCS2.Third == ICK_Identity)
3449     return Result == ImplicitConversionSequence::Better
3450              ? ImplicitConversionSequence::Indistinguishable
3451              : ImplicitConversionSequence::Worse;
3452 
3453   return ImplicitConversionSequence::Indistinguishable;
3454 }
3455 
3456 /// \brief Determine whether one of the given reference bindings is better
3457 /// than the other based on what kind of bindings they are.
3458 static bool
3459 isBetterReferenceBindingKind(const StandardConversionSequence &SCS1,
3460                              const StandardConversionSequence &SCS2) {
3461   // C++0x [over.ics.rank]p3b4:
3462   //   -- S1 and S2 are reference bindings (8.5.3) and neither refers to an
3463   //      implicit object parameter of a non-static member function declared
3464   //      without a ref-qualifier, and *either* S1 binds an rvalue reference
3465   //      to an rvalue and S2 binds an lvalue reference *or S1 binds an
3466   //      lvalue reference to a function lvalue and S2 binds an rvalue
3467   //      reference*.
3468   //
3469   // FIXME: Rvalue references. We're going rogue with the above edits,
3470   // because the semantics in the current C++0x working paper (N3225 at the
3471   // time of this writing) break the standard definition of std::forward
3472   // and std::reference_wrapper when dealing with references to functions.
3473   // Proposed wording changes submitted to CWG for consideration.
3474   if (SCS1.BindsImplicitObjectArgumentWithoutRefQualifier ||
3475       SCS2.BindsImplicitObjectArgumentWithoutRefQualifier)
3476     return false;
3477 
3478   return (!SCS1.IsLvalueReference && SCS1.BindsToRvalue &&
3479           SCS2.IsLvalueReference) ||
3480          (SCS1.IsLvalueReference && SCS1.BindsToFunctionLvalue &&
3481           !SCS2.IsLvalueReference && SCS2.BindsToFunctionLvalue);
3482 }
3483 
3484 /// CompareStandardConversionSequences - Compare two standard
3485 /// conversion sequences to determine whether one is better than the
3486 /// other or if they are indistinguishable (C++ 13.3.3.2p3).
3487 static ImplicitConversionSequence::CompareKind
3488 CompareStandardConversionSequences(Sema &S,
3489                                    const StandardConversionSequence& SCS1,
3490                                    const StandardConversionSequence& SCS2)
3491 {
3492   // Standard conversion sequence S1 is a better conversion sequence
3493   // than standard conversion sequence S2 if (C++ 13.3.3.2p3):
3494 
3495   //  -- S1 is a proper subsequence of S2 (comparing the conversion
3496   //     sequences in the canonical form defined by 13.3.3.1.1,
3497   //     excluding any Lvalue Transformation; the identity conversion
3498   //     sequence is considered to be a subsequence of any
3499   //     non-identity conversion sequence) or, if not that,
3500   if (ImplicitConversionSequence::CompareKind CK
3501         = compareStandardConversionSubsets(S.Context, SCS1, SCS2))
3502     return CK;
3503 
3504   //  -- the rank of S1 is better than the rank of S2 (by the rules
3505   //     defined below), or, if not that,
3506   ImplicitConversionRank Rank1 = SCS1.getRank();
3507   ImplicitConversionRank Rank2 = SCS2.getRank();
3508   if (Rank1 < Rank2)
3509     return ImplicitConversionSequence::Better;
3510   else if (Rank2 < Rank1)
3511     return ImplicitConversionSequence::Worse;
3512 
3513   // (C++ 13.3.3.2p4): Two conversion sequences with the same rank
3514   // are indistinguishable unless one of the following rules
3515   // applies:
3516 
3517   //   A conversion that is not a conversion of a pointer, or
3518   //   pointer to member, to bool is better than another conversion
3519   //   that is such a conversion.
3520   if (SCS1.isPointerConversionToBool() != SCS2.isPointerConversionToBool())
3521     return SCS2.isPointerConversionToBool()
3522              ? ImplicitConversionSequence::Better
3523              : ImplicitConversionSequence::Worse;
3524 
3525   // C++ [over.ics.rank]p4b2:
3526   //
3527   //   If class B is derived directly or indirectly from class A,
3528   //   conversion of B* to A* is better than conversion of B* to
3529   //   void*, and conversion of A* to void* is better than conversion
3530   //   of B* to void*.
3531   bool SCS1ConvertsToVoid
3532     = SCS1.isPointerConversionToVoidPointer(S.Context);
3533   bool SCS2ConvertsToVoid
3534     = SCS2.isPointerConversionToVoidPointer(S.Context);
3535   if (SCS1ConvertsToVoid != SCS2ConvertsToVoid) {
3536     // Exactly one of the conversion sequences is a conversion to
3537     // a void pointer; it's the worse conversion.
3538     return SCS2ConvertsToVoid ? ImplicitConversionSequence::Better
3539                               : ImplicitConversionSequence::Worse;
3540   } else if (!SCS1ConvertsToVoid && !SCS2ConvertsToVoid) {
3541     // Neither conversion sequence converts to a void pointer; compare
3542     // their derived-to-base conversions.
3543     if (ImplicitConversionSequence::CompareKind DerivedCK
3544           = CompareDerivedToBaseConversions(S, SCS1, SCS2))
3545       return DerivedCK;
3546   } else if (SCS1ConvertsToVoid && SCS2ConvertsToVoid &&
3547              !S.Context.hasSameType(SCS1.getFromType(), SCS2.getFromType())) {
3548     // Both conversion sequences are conversions to void
3549     // pointers. Compare the source types to determine if there's an
3550     // inheritance relationship in their sources.
3551     QualType FromType1 = SCS1.getFromType();
3552     QualType FromType2 = SCS2.getFromType();
3553 
3554     // Adjust the types we're converting from via the array-to-pointer
3555     // conversion, if we need to.
3556     if (SCS1.First == ICK_Array_To_Pointer)
3557       FromType1 = S.Context.getArrayDecayedType(FromType1);
3558     if (SCS2.First == ICK_Array_To_Pointer)
3559       FromType2 = S.Context.getArrayDecayedType(FromType2);
3560 
3561     QualType FromPointee1 = FromType1->getPointeeType().getUnqualifiedType();
3562     QualType FromPointee2 = FromType2->getPointeeType().getUnqualifiedType();
3563 
3564     if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3565       return ImplicitConversionSequence::Better;
3566     else if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3567       return ImplicitConversionSequence::Worse;
3568 
3569     // Objective-C++: If one interface is more specific than the
3570     // other, it is the better one.
3571     const ObjCObjectPointerType* FromObjCPtr1
3572       = FromType1->getAs<ObjCObjectPointerType>();
3573     const ObjCObjectPointerType* FromObjCPtr2
3574       = FromType2->getAs<ObjCObjectPointerType>();
3575     if (FromObjCPtr1 && FromObjCPtr2) {
3576       bool AssignLeft = S.Context.canAssignObjCInterfaces(FromObjCPtr1,
3577                                                           FromObjCPtr2);
3578       bool AssignRight = S.Context.canAssignObjCInterfaces(FromObjCPtr2,
3579                                                            FromObjCPtr1);
3580       if (AssignLeft != AssignRight) {
3581         return AssignLeft? ImplicitConversionSequence::Better
3582                          : ImplicitConversionSequence::Worse;
3583       }
3584     }
3585   }
3586 
3587   // Compare based on qualification conversions (C++ 13.3.3.2p3,
3588   // bullet 3).
3589   if (ImplicitConversionSequence::CompareKind QualCK
3590         = CompareQualificationConversions(S, SCS1, SCS2))
3591     return QualCK;
3592 
3593   if (SCS1.ReferenceBinding && SCS2.ReferenceBinding) {
3594     // Check for a better reference binding based on the kind of bindings.
3595     if (isBetterReferenceBindingKind(SCS1, SCS2))
3596       return ImplicitConversionSequence::Better;
3597     else if (isBetterReferenceBindingKind(SCS2, SCS1))
3598       return ImplicitConversionSequence::Worse;
3599 
3600     // C++ [over.ics.rank]p3b4:
3601     //   -- S1 and S2 are reference bindings (8.5.3), and the types to
3602     //      which the references refer are the same type except for
3603     //      top-level cv-qualifiers, and the type to which the reference
3604     //      initialized by S2 refers is more cv-qualified than the type
3605     //      to which the reference initialized by S1 refers.
3606     QualType T1 = SCS1.getToType(2);
3607     QualType T2 = SCS2.getToType(2);
3608     T1 = S.Context.getCanonicalType(T1);
3609     T2 = S.Context.getCanonicalType(T2);
3610     Qualifiers T1Quals, T2Quals;
3611     QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3612     QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3613     if (UnqualT1 == UnqualT2) {
3614       // Objective-C++ ARC: If the references refer to objects with different
3615       // lifetimes, prefer bindings that don't change lifetime.
3616       if (SCS1.ObjCLifetimeConversionBinding !=
3617                                           SCS2.ObjCLifetimeConversionBinding) {
3618         return SCS1.ObjCLifetimeConversionBinding
3619                                            ? ImplicitConversionSequence::Worse
3620                                            : ImplicitConversionSequence::Better;
3621       }
3622 
3623       // If the type is an array type, promote the element qualifiers to the
3624       // type for comparison.
3625       if (isa<ArrayType>(T1) && T1Quals)
3626         T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3627       if (isa<ArrayType>(T2) && T2Quals)
3628         T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3629       if (T2.isMoreQualifiedThan(T1))
3630         return ImplicitConversionSequence::Better;
3631       else if (T1.isMoreQualifiedThan(T2))
3632         return ImplicitConversionSequence::Worse;
3633     }
3634   }
3635 
3636   // In Microsoft mode, prefer an integral conversion to a
3637   // floating-to-integral conversion if the integral conversion
3638   // is between types of the same size.
3639   // For example:
3640   // void f(float);
3641   // void f(int);
3642   // int main {
3643   //    long a;
3644   //    f(a);
3645   // }
3646   // Here, MSVC will call f(int) instead of generating a compile error
3647   // as clang will do in standard mode.
3648   if (S.getLangOpts().MSVCCompat && SCS1.Second == ICK_Integral_Conversion &&
3649       SCS2.Second == ICK_Floating_Integral &&
3650       S.Context.getTypeSize(SCS1.getFromType()) ==
3651           S.Context.getTypeSize(SCS1.getToType(2)))
3652     return ImplicitConversionSequence::Better;
3653 
3654   return ImplicitConversionSequence::Indistinguishable;
3655 }
3656 
3657 /// CompareQualificationConversions - Compares two standard conversion
3658 /// sequences to determine whether they can be ranked based on their
3659 /// qualification conversions (C++ 13.3.3.2p3 bullet 3).
3660 ImplicitConversionSequence::CompareKind
3661 CompareQualificationConversions(Sema &S,
3662                                 const StandardConversionSequence& SCS1,
3663                                 const StandardConversionSequence& SCS2) {
3664   // C++ 13.3.3.2p3:
3665   //  -- S1 and S2 differ only in their qualification conversion and
3666   //     yield similar types T1 and T2 (C++ 4.4), respectively, and the
3667   //     cv-qualification signature of type T1 is a proper subset of
3668   //     the cv-qualification signature of type T2, and S1 is not the
3669   //     deprecated string literal array-to-pointer conversion (4.2).
3670   if (SCS1.First != SCS2.First || SCS1.Second != SCS2.Second ||
3671       SCS1.Third != SCS2.Third || SCS1.Third != ICK_Qualification)
3672     return ImplicitConversionSequence::Indistinguishable;
3673 
3674   // FIXME: the example in the standard doesn't use a qualification
3675   // conversion (!)
3676   QualType T1 = SCS1.getToType(2);
3677   QualType T2 = SCS2.getToType(2);
3678   T1 = S.Context.getCanonicalType(T1);
3679   T2 = S.Context.getCanonicalType(T2);
3680   Qualifiers T1Quals, T2Quals;
3681   QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3682   QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3683 
3684   // If the types are the same, we won't learn anything by unwrapped
3685   // them.
3686   if (UnqualT1 == UnqualT2)
3687     return ImplicitConversionSequence::Indistinguishable;
3688 
3689   // If the type is an array type, promote the element qualifiers to the type
3690   // for comparison.
3691   if (isa<ArrayType>(T1) && T1Quals)
3692     T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3693   if (isa<ArrayType>(T2) && T2Quals)
3694     T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3695 
3696   ImplicitConversionSequence::CompareKind Result
3697     = ImplicitConversionSequence::Indistinguishable;
3698 
3699   // Objective-C++ ARC:
3700   //   Prefer qualification conversions not involving a change in lifetime
3701   //   to qualification conversions that do not change lifetime.
3702   if (SCS1.QualificationIncludesObjCLifetime !=
3703                                       SCS2.QualificationIncludesObjCLifetime) {
3704     Result = SCS1.QualificationIncludesObjCLifetime
3705                ? ImplicitConversionSequence::Worse
3706                : ImplicitConversionSequence::Better;
3707   }
3708 
3709   while (S.Context.UnwrapSimilarPointerTypes(T1, T2)) {
3710     // Within each iteration of the loop, we check the qualifiers to
3711     // determine if this still looks like a qualification
3712     // conversion. Then, if all is well, we unwrap one more level of
3713     // pointers or pointers-to-members and do it all again
3714     // until there are no more pointers or pointers-to-members left
3715     // to unwrap. This essentially mimics what
3716     // IsQualificationConversion does, but here we're checking for a
3717     // strict subset of qualifiers.
3718     if (T1.getCVRQualifiers() == T2.getCVRQualifiers())
3719       // The qualifiers are the same, so this doesn't tell us anything
3720       // about how the sequences rank.
3721       ;
3722     else if (T2.isMoreQualifiedThan(T1)) {
3723       // T1 has fewer qualifiers, so it could be the better sequence.
3724       if (Result == ImplicitConversionSequence::Worse)
3725         // Neither has qualifiers that are a subset of the other's
3726         // qualifiers.
3727         return ImplicitConversionSequence::Indistinguishable;
3728 
3729       Result = ImplicitConversionSequence::Better;
3730     } else if (T1.isMoreQualifiedThan(T2)) {
3731       // T2 has fewer qualifiers, so it could be the better sequence.
3732       if (Result == ImplicitConversionSequence::Better)
3733         // Neither has qualifiers that are a subset of the other's
3734         // qualifiers.
3735         return ImplicitConversionSequence::Indistinguishable;
3736 
3737       Result = ImplicitConversionSequence::Worse;
3738     } else {
3739       // Qualifiers are disjoint.
3740       return ImplicitConversionSequence::Indistinguishable;
3741     }
3742 
3743     // If the types after this point are equivalent, we're done.
3744     if (S.Context.hasSameUnqualifiedType(T1, T2))
3745       break;
3746   }
3747 
3748   // Check that the winning standard conversion sequence isn't using
3749   // the deprecated string literal array to pointer conversion.
3750   switch (Result) {
3751   case ImplicitConversionSequence::Better:
3752     if (SCS1.DeprecatedStringLiteralToCharPtr)
3753       Result = ImplicitConversionSequence::Indistinguishable;
3754     break;
3755 
3756   case ImplicitConversionSequence::Indistinguishable:
3757     break;
3758 
3759   case ImplicitConversionSequence::Worse:
3760     if (SCS2.DeprecatedStringLiteralToCharPtr)
3761       Result = ImplicitConversionSequence::Indistinguishable;
3762     break;
3763   }
3764 
3765   return Result;
3766 }
3767 
3768 /// CompareDerivedToBaseConversions - Compares two standard conversion
3769 /// sequences to determine whether they can be ranked based on their
3770 /// various kinds of derived-to-base conversions (C++
3771 /// [over.ics.rank]p4b3).  As part of these checks, we also look at
3772 /// conversions between Objective-C interface types.
3773 ImplicitConversionSequence::CompareKind
3774 CompareDerivedToBaseConversions(Sema &S,
3775                                 const StandardConversionSequence& SCS1,
3776                                 const StandardConversionSequence& SCS2) {
3777   QualType FromType1 = SCS1.getFromType();
3778   QualType ToType1 = SCS1.getToType(1);
3779   QualType FromType2 = SCS2.getFromType();
3780   QualType ToType2 = SCS2.getToType(1);
3781 
3782   // Adjust the types we're converting from via the array-to-pointer
3783   // conversion, if we need to.
3784   if (SCS1.First == ICK_Array_To_Pointer)
3785     FromType1 = S.Context.getArrayDecayedType(FromType1);
3786   if (SCS2.First == ICK_Array_To_Pointer)
3787     FromType2 = S.Context.getArrayDecayedType(FromType2);
3788 
3789   // Canonicalize all of the types.
3790   FromType1 = S.Context.getCanonicalType(FromType1);
3791   ToType1 = S.Context.getCanonicalType(ToType1);
3792   FromType2 = S.Context.getCanonicalType(FromType2);
3793   ToType2 = S.Context.getCanonicalType(ToType2);
3794 
3795   // C++ [over.ics.rank]p4b3:
3796   //
3797   //   If class B is derived directly or indirectly from class A and
3798   //   class C is derived directly or indirectly from B,
3799   //
3800   // Compare based on pointer conversions.
3801   if (SCS1.Second == ICK_Pointer_Conversion &&
3802       SCS2.Second == ICK_Pointer_Conversion &&
3803       /*FIXME: Remove if Objective-C id conversions get their own rank*/
3804       FromType1->isPointerType() && FromType2->isPointerType() &&
3805       ToType1->isPointerType() && ToType2->isPointerType()) {
3806     QualType FromPointee1
3807       = FromType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3808     QualType ToPointee1
3809       = ToType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3810     QualType FromPointee2
3811       = FromType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3812     QualType ToPointee2
3813       = ToType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3814 
3815     //   -- conversion of C* to B* is better than conversion of C* to A*,
3816     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
3817       if (S.IsDerivedFrom(ToPointee1, ToPointee2))
3818         return ImplicitConversionSequence::Better;
3819       else if (S.IsDerivedFrom(ToPointee2, ToPointee1))
3820         return ImplicitConversionSequence::Worse;
3821     }
3822 
3823     //   -- conversion of B* to A* is better than conversion of C* to A*,
3824     if (FromPointee1 != FromPointee2 && ToPointee1 == ToPointee2) {
3825       if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3826         return ImplicitConversionSequence::Better;
3827       else if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3828         return ImplicitConversionSequence::Worse;
3829     }
3830   } else if (SCS1.Second == ICK_Pointer_Conversion &&
3831              SCS2.Second == ICK_Pointer_Conversion) {
3832     const ObjCObjectPointerType *FromPtr1
3833       = FromType1->getAs<ObjCObjectPointerType>();
3834     const ObjCObjectPointerType *FromPtr2
3835       = FromType2->getAs<ObjCObjectPointerType>();
3836     const ObjCObjectPointerType *ToPtr1
3837       = ToType1->getAs<ObjCObjectPointerType>();
3838     const ObjCObjectPointerType *ToPtr2
3839       = ToType2->getAs<ObjCObjectPointerType>();
3840 
3841     if (FromPtr1 && FromPtr2 && ToPtr1 && ToPtr2) {
3842       // Apply the same conversion ranking rules for Objective-C pointer types
3843       // that we do for C++ pointers to class types. However, we employ the
3844       // Objective-C pseudo-subtyping relationship used for assignment of
3845       // Objective-C pointer types.
3846       bool FromAssignLeft
3847         = S.Context.canAssignObjCInterfaces(FromPtr1, FromPtr2);
3848       bool FromAssignRight
3849         = S.Context.canAssignObjCInterfaces(FromPtr2, FromPtr1);
3850       bool ToAssignLeft
3851         = S.Context.canAssignObjCInterfaces(ToPtr1, ToPtr2);
3852       bool ToAssignRight
3853         = S.Context.canAssignObjCInterfaces(ToPtr2, ToPtr1);
3854 
3855       // A conversion to an a non-id object pointer type or qualified 'id'
3856       // type is better than a conversion to 'id'.
3857       if (ToPtr1->isObjCIdType() &&
3858           (ToPtr2->isObjCQualifiedIdType() || ToPtr2->getInterfaceDecl()))
3859         return ImplicitConversionSequence::Worse;
3860       if (ToPtr2->isObjCIdType() &&
3861           (ToPtr1->isObjCQualifiedIdType() || ToPtr1->getInterfaceDecl()))
3862         return ImplicitConversionSequence::Better;
3863 
3864       // A conversion to a non-id object pointer type is better than a
3865       // conversion to a qualified 'id' type
3866       if (ToPtr1->isObjCQualifiedIdType() && ToPtr2->getInterfaceDecl())
3867         return ImplicitConversionSequence::Worse;
3868       if (ToPtr2->isObjCQualifiedIdType() && ToPtr1->getInterfaceDecl())
3869         return ImplicitConversionSequence::Better;
3870 
3871       // A conversion to an a non-Class object pointer type or qualified 'Class'
3872       // type is better than a conversion to 'Class'.
3873       if (ToPtr1->isObjCClassType() &&
3874           (ToPtr2->isObjCQualifiedClassType() || ToPtr2->getInterfaceDecl()))
3875         return ImplicitConversionSequence::Worse;
3876       if (ToPtr2->isObjCClassType() &&
3877           (ToPtr1->isObjCQualifiedClassType() || ToPtr1->getInterfaceDecl()))
3878         return ImplicitConversionSequence::Better;
3879 
3880       // A conversion to a non-Class object pointer type is better than a
3881       // conversion to a qualified 'Class' type.
3882       if (ToPtr1->isObjCQualifiedClassType() && ToPtr2->getInterfaceDecl())
3883         return ImplicitConversionSequence::Worse;
3884       if (ToPtr2->isObjCQualifiedClassType() && ToPtr1->getInterfaceDecl())
3885         return ImplicitConversionSequence::Better;
3886 
3887       //   -- "conversion of C* to B* is better than conversion of C* to A*,"
3888       if (S.Context.hasSameType(FromType1, FromType2) &&
3889           !FromPtr1->isObjCIdType() && !FromPtr1->isObjCClassType() &&
3890           (ToAssignLeft != ToAssignRight))
3891         return ToAssignLeft? ImplicitConversionSequence::Worse
3892                            : ImplicitConversionSequence::Better;
3893 
3894       //   -- "conversion of B* to A* is better than conversion of C* to A*,"
3895       if (S.Context.hasSameUnqualifiedType(ToType1, ToType2) &&
3896           (FromAssignLeft != FromAssignRight))
3897         return FromAssignLeft? ImplicitConversionSequence::Better
3898         : ImplicitConversionSequence::Worse;
3899     }
3900   }
3901 
3902   // Ranking of member-pointer types.
3903   if (SCS1.Second == ICK_Pointer_Member && SCS2.Second == ICK_Pointer_Member &&
3904       FromType1->isMemberPointerType() && FromType2->isMemberPointerType() &&
3905       ToType1->isMemberPointerType() && ToType2->isMemberPointerType()) {
3906     const MemberPointerType * FromMemPointer1 =
3907                                         FromType1->getAs<MemberPointerType>();
3908     const MemberPointerType * ToMemPointer1 =
3909                                           ToType1->getAs<MemberPointerType>();
3910     const MemberPointerType * FromMemPointer2 =
3911                                           FromType2->getAs<MemberPointerType>();
3912     const MemberPointerType * ToMemPointer2 =
3913                                           ToType2->getAs<MemberPointerType>();
3914     const Type *FromPointeeType1 = FromMemPointer1->getClass();
3915     const Type *ToPointeeType1 = ToMemPointer1->getClass();
3916     const Type *FromPointeeType2 = FromMemPointer2->getClass();
3917     const Type *ToPointeeType2 = ToMemPointer2->getClass();
3918     QualType FromPointee1 = QualType(FromPointeeType1, 0).getUnqualifiedType();
3919     QualType ToPointee1 = QualType(ToPointeeType1, 0).getUnqualifiedType();
3920     QualType FromPointee2 = QualType(FromPointeeType2, 0).getUnqualifiedType();
3921     QualType ToPointee2 = QualType(ToPointeeType2, 0).getUnqualifiedType();
3922     // conversion of A::* to B::* is better than conversion of A::* to C::*,
3923     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
3924       if (S.IsDerivedFrom(ToPointee1, ToPointee2))
3925         return ImplicitConversionSequence::Worse;
3926       else if (S.IsDerivedFrom(ToPointee2, ToPointee1))
3927         return ImplicitConversionSequence::Better;
3928     }
3929     // conversion of B::* to C::* is better than conversion of A::* to C::*
3930     if (ToPointee1 == ToPointee2 && FromPointee1 != FromPointee2) {
3931       if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3932         return ImplicitConversionSequence::Better;
3933       else if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3934         return ImplicitConversionSequence::Worse;
3935     }
3936   }
3937 
3938   if (SCS1.Second == ICK_Derived_To_Base) {
3939     //   -- conversion of C to B is better than conversion of C to A,
3940     //   -- binding of an expression of type C to a reference of type
3941     //      B& is better than binding an expression of type C to a
3942     //      reference of type A&,
3943     if (S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
3944         !S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
3945       if (S.IsDerivedFrom(ToType1, ToType2))
3946         return ImplicitConversionSequence::Better;
3947       else if (S.IsDerivedFrom(ToType2, ToType1))
3948         return ImplicitConversionSequence::Worse;
3949     }
3950 
3951     //   -- conversion of B to A is better than conversion of C to A.
3952     //   -- binding of an expression of type B to a reference of type
3953     //      A& is better than binding an expression of type C to a
3954     //      reference of type A&,
3955     if (!S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
3956         S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
3957       if (S.IsDerivedFrom(FromType2, FromType1))
3958         return ImplicitConversionSequence::Better;
3959       else if (S.IsDerivedFrom(FromType1, FromType2))
3960         return ImplicitConversionSequence::Worse;
3961     }
3962   }
3963 
3964   return ImplicitConversionSequence::Indistinguishable;
3965 }
3966 
3967 /// \brief Determine whether the given type is valid, e.g., it is not an invalid
3968 /// C++ class.
3969 static bool isTypeValid(QualType T) {
3970   if (CXXRecordDecl *Record = T->getAsCXXRecordDecl())
3971     return !Record->isInvalidDecl();
3972 
3973   return true;
3974 }
3975 
3976 /// CompareReferenceRelationship - Compare the two types T1 and T2 to
3977 /// determine whether they are reference-related,
3978 /// reference-compatible, reference-compatible with added
3979 /// qualification, or incompatible, for use in C++ initialization by
3980 /// reference (C++ [dcl.ref.init]p4). Neither type can be a reference
3981 /// type, and the first type (T1) is the pointee type of the reference
3982 /// type being initialized.
3983 Sema::ReferenceCompareResult
3984 Sema::CompareReferenceRelationship(SourceLocation Loc,
3985                                    QualType OrigT1, QualType OrigT2,
3986                                    bool &DerivedToBase,
3987                                    bool &ObjCConversion,
3988                                    bool &ObjCLifetimeConversion) {
3989   assert(!OrigT1->isReferenceType() &&
3990     "T1 must be the pointee type of the reference type");
3991   assert(!OrigT2->isReferenceType() && "T2 cannot be a reference type");
3992 
3993   QualType T1 = Context.getCanonicalType(OrigT1);
3994   QualType T2 = Context.getCanonicalType(OrigT2);
3995   Qualifiers T1Quals, T2Quals;
3996   QualType UnqualT1 = Context.getUnqualifiedArrayType(T1, T1Quals);
3997   QualType UnqualT2 = Context.getUnqualifiedArrayType(T2, T2Quals);
3998 
3999   // C++ [dcl.init.ref]p4:
4000   //   Given types "cv1 T1" and "cv2 T2," "cv1 T1" is
4001   //   reference-related to "cv2 T2" if T1 is the same type as T2, or
4002   //   T1 is a base class of T2.
4003   DerivedToBase = false;
4004   ObjCConversion = false;
4005   ObjCLifetimeConversion = false;
4006   if (UnqualT1 == UnqualT2) {
4007     // Nothing to do.
4008   } else if (!RequireCompleteType(Loc, OrigT2, 0) &&
4009              isTypeValid(UnqualT1) && isTypeValid(UnqualT2) &&
4010              IsDerivedFrom(UnqualT2, UnqualT1))
4011     DerivedToBase = true;
4012   else if (UnqualT1->isObjCObjectOrInterfaceType() &&
4013            UnqualT2->isObjCObjectOrInterfaceType() &&
4014            Context.canBindObjCObjectType(UnqualT1, UnqualT2))
4015     ObjCConversion = true;
4016   else
4017     return Ref_Incompatible;
4018 
4019   // At this point, we know that T1 and T2 are reference-related (at
4020   // least).
4021 
4022   // If the type is an array type, promote the element qualifiers to the type
4023   // for comparison.
4024   if (isa<ArrayType>(T1) && T1Quals)
4025     T1 = Context.getQualifiedType(UnqualT1, T1Quals);
4026   if (isa<ArrayType>(T2) && T2Quals)
4027     T2 = Context.getQualifiedType(UnqualT2, T2Quals);
4028 
4029   // C++ [dcl.init.ref]p4:
4030   //   "cv1 T1" is reference-compatible with "cv2 T2" if T1 is
4031   //   reference-related to T2 and cv1 is the same cv-qualification
4032   //   as, or greater cv-qualification than, cv2. For purposes of
4033   //   overload resolution, cases for which cv1 is greater
4034   //   cv-qualification than cv2 are identified as
4035   //   reference-compatible with added qualification (see 13.3.3.2).
4036   //
4037   // Note that we also require equivalence of Objective-C GC and address-space
4038   // qualifiers when performing these computations, so that e.g., an int in
4039   // address space 1 is not reference-compatible with an int in address
4040   // space 2.
4041   if (T1Quals.getObjCLifetime() != T2Quals.getObjCLifetime() &&
4042       T1Quals.compatiblyIncludesObjCLifetime(T2Quals)) {
4043     if (isNonTrivialObjCLifetimeConversion(T2Quals, T1Quals))
4044       ObjCLifetimeConversion = true;
4045 
4046     T1Quals.removeObjCLifetime();
4047     T2Quals.removeObjCLifetime();
4048   }
4049 
4050   if (T1Quals == T2Quals)
4051     return Ref_Compatible;
4052   else if (T1Quals.compatiblyIncludes(T2Quals))
4053     return Ref_Compatible_With_Added_Qualification;
4054   else
4055     return Ref_Related;
4056 }
4057 
4058 /// \brief Look for a user-defined conversion to an value reference-compatible
4059 ///        with DeclType. Return true if something definite is found.
4060 static bool
4061 FindConversionForRefInit(Sema &S, ImplicitConversionSequence &ICS,
4062                          QualType DeclType, SourceLocation DeclLoc,
4063                          Expr *Init, QualType T2, bool AllowRvalues,
4064                          bool AllowExplicit) {
4065   assert(T2->isRecordType() && "Can only find conversions of record types.");
4066   CXXRecordDecl *T2RecordDecl
4067     = dyn_cast<CXXRecordDecl>(T2->getAs<RecordType>()->getDecl());
4068 
4069   OverloadCandidateSet CandidateSet(DeclLoc, OverloadCandidateSet::CSK_Normal);
4070   std::pair<CXXRecordDecl::conversion_iterator,
4071             CXXRecordDecl::conversion_iterator>
4072     Conversions = T2RecordDecl->getVisibleConversionFunctions();
4073   for (CXXRecordDecl::conversion_iterator
4074          I = Conversions.first, E = Conversions.second; I != E; ++I) {
4075     NamedDecl *D = *I;
4076     CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(D->getDeclContext());
4077     if (isa<UsingShadowDecl>(D))
4078       D = cast<UsingShadowDecl>(D)->getTargetDecl();
4079 
4080     FunctionTemplateDecl *ConvTemplate
4081       = dyn_cast<FunctionTemplateDecl>(D);
4082     CXXConversionDecl *Conv;
4083     if (ConvTemplate)
4084       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
4085     else
4086       Conv = cast<CXXConversionDecl>(D);
4087 
4088     // If this is an explicit conversion, and we're not allowed to consider
4089     // explicit conversions, skip it.
4090     if (!AllowExplicit && Conv->isExplicit())
4091       continue;
4092 
4093     if (AllowRvalues) {
4094       bool DerivedToBase = false;
4095       bool ObjCConversion = false;
4096       bool ObjCLifetimeConversion = false;
4097 
4098       // If we are initializing an rvalue reference, don't permit conversion
4099       // functions that return lvalues.
4100       if (!ConvTemplate && DeclType->isRValueReferenceType()) {
4101         const ReferenceType *RefType
4102           = Conv->getConversionType()->getAs<LValueReferenceType>();
4103         if (RefType && !RefType->getPointeeType()->isFunctionType())
4104           continue;
4105       }
4106 
4107       if (!ConvTemplate &&
4108           S.CompareReferenceRelationship(
4109             DeclLoc,
4110             Conv->getConversionType().getNonReferenceType()
4111               .getUnqualifiedType(),
4112             DeclType.getNonReferenceType().getUnqualifiedType(),
4113             DerivedToBase, ObjCConversion, ObjCLifetimeConversion) ==
4114           Sema::Ref_Incompatible)
4115         continue;
4116     } else {
4117       // If the conversion function doesn't return a reference type,
4118       // it can't be considered for this conversion. An rvalue reference
4119       // is only acceptable if its referencee is a function type.
4120 
4121       const ReferenceType *RefType =
4122         Conv->getConversionType()->getAs<ReferenceType>();
4123       if (!RefType ||
4124           (!RefType->isLValueReferenceType() &&
4125            !RefType->getPointeeType()->isFunctionType()))
4126         continue;
4127     }
4128 
4129     if (ConvTemplate)
4130       S.AddTemplateConversionCandidate(ConvTemplate, I.getPair(), ActingDC,
4131                                        Init, DeclType, CandidateSet,
4132                                        /*AllowObjCConversionOnExplicit=*/false);
4133     else
4134       S.AddConversionCandidate(Conv, I.getPair(), ActingDC, Init,
4135                                DeclType, CandidateSet,
4136                                /*AllowObjCConversionOnExplicit=*/false);
4137   }
4138 
4139   bool HadMultipleCandidates = (CandidateSet.size() > 1);
4140 
4141   OverloadCandidateSet::iterator Best;
4142   switch (CandidateSet.BestViableFunction(S, DeclLoc, Best, true)) {
4143   case OR_Success:
4144     // C++ [over.ics.ref]p1:
4145     //
4146     //   [...] If the parameter binds directly to the result of
4147     //   applying a conversion function to the argument
4148     //   expression, the implicit conversion sequence is a
4149     //   user-defined conversion sequence (13.3.3.1.2), with the
4150     //   second standard conversion sequence either an identity
4151     //   conversion or, if the conversion function returns an
4152     //   entity of a type that is a derived class of the parameter
4153     //   type, a derived-to-base Conversion.
4154     if (!Best->FinalConversion.DirectBinding)
4155       return false;
4156 
4157     ICS.setUserDefined();
4158     ICS.UserDefined.Before = Best->Conversions[0].Standard;
4159     ICS.UserDefined.After = Best->FinalConversion;
4160     ICS.UserDefined.HadMultipleCandidates = HadMultipleCandidates;
4161     ICS.UserDefined.ConversionFunction = Best->Function;
4162     ICS.UserDefined.FoundConversionFunction = Best->FoundDecl;
4163     ICS.UserDefined.EllipsisConversion = false;
4164     assert(ICS.UserDefined.After.ReferenceBinding &&
4165            ICS.UserDefined.After.DirectBinding &&
4166            "Expected a direct reference binding!");
4167     return true;
4168 
4169   case OR_Ambiguous:
4170     ICS.setAmbiguous();
4171     for (OverloadCandidateSet::iterator Cand = CandidateSet.begin();
4172          Cand != CandidateSet.end(); ++Cand)
4173       if (Cand->Viable)
4174         ICS.Ambiguous.addConversion(Cand->Function);
4175     return true;
4176 
4177   case OR_No_Viable_Function:
4178   case OR_Deleted:
4179     // There was no suitable conversion, or we found a deleted
4180     // conversion; continue with other checks.
4181     return false;
4182   }
4183 
4184   llvm_unreachable("Invalid OverloadResult!");
4185 }
4186 
4187 /// \brief Compute an implicit conversion sequence for reference
4188 /// initialization.
4189 static ImplicitConversionSequence
4190 TryReferenceInit(Sema &S, Expr *Init, QualType DeclType,
4191                  SourceLocation DeclLoc,
4192                  bool SuppressUserConversions,
4193                  bool AllowExplicit) {
4194   assert(DeclType->isReferenceType() && "Reference init needs a reference");
4195 
4196   // Most paths end in a failed conversion.
4197   ImplicitConversionSequence ICS;
4198   ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4199 
4200   QualType T1 = DeclType->getAs<ReferenceType>()->getPointeeType();
4201   QualType T2 = Init->getType();
4202 
4203   // If the initializer is the address of an overloaded function, try
4204   // to resolve the overloaded function. If all goes well, T2 is the
4205   // type of the resulting function.
4206   if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4207     DeclAccessPair Found;
4208     if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(Init, DeclType,
4209                                                                 false, Found))
4210       T2 = Fn->getType();
4211   }
4212 
4213   // Compute some basic properties of the types and the initializer.
4214   bool isRValRef = DeclType->isRValueReferenceType();
4215   bool DerivedToBase = false;
4216   bool ObjCConversion = false;
4217   bool ObjCLifetimeConversion = false;
4218   Expr::Classification InitCategory = Init->Classify(S.Context);
4219   Sema::ReferenceCompareResult RefRelationship
4220     = S.CompareReferenceRelationship(DeclLoc, T1, T2, DerivedToBase,
4221                                      ObjCConversion, ObjCLifetimeConversion);
4222 
4223 
4224   // C++0x [dcl.init.ref]p5:
4225   //   A reference to type "cv1 T1" is initialized by an expression
4226   //   of type "cv2 T2" as follows:
4227 
4228   //     -- If reference is an lvalue reference and the initializer expression
4229   if (!isRValRef) {
4230     //     -- is an lvalue (but is not a bit-field), and "cv1 T1" is
4231     //        reference-compatible with "cv2 T2," or
4232     //
4233     // Per C++ [over.ics.ref]p4, we don't check the bit-field property here.
4234     if (InitCategory.isLValue() &&
4235         RefRelationship >= Sema::Ref_Compatible_With_Added_Qualification) {
4236       // C++ [over.ics.ref]p1:
4237       //   When a parameter of reference type binds directly (8.5.3)
4238       //   to an argument expression, the implicit conversion sequence
4239       //   is the identity conversion, unless the argument expression
4240       //   has a type that is a derived class of the parameter type,
4241       //   in which case the implicit conversion sequence is a
4242       //   derived-to-base Conversion (13.3.3.1).
4243       ICS.setStandard();
4244       ICS.Standard.First = ICK_Identity;
4245       ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4246                          : ObjCConversion? ICK_Compatible_Conversion
4247                          : ICK_Identity;
4248       ICS.Standard.Third = ICK_Identity;
4249       ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4250       ICS.Standard.setToType(0, T2);
4251       ICS.Standard.setToType(1, T1);
4252       ICS.Standard.setToType(2, T1);
4253       ICS.Standard.ReferenceBinding = true;
4254       ICS.Standard.DirectBinding = true;
4255       ICS.Standard.IsLvalueReference = !isRValRef;
4256       ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4257       ICS.Standard.BindsToRvalue = false;
4258       ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4259       ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4260       ICS.Standard.CopyConstructor = nullptr;
4261       ICS.Standard.DeprecatedStringLiteralToCharPtr = false;
4262 
4263       // Nothing more to do: the inaccessibility/ambiguity check for
4264       // derived-to-base conversions is suppressed when we're
4265       // computing the implicit conversion sequence (C++
4266       // [over.best.ics]p2).
4267       return ICS;
4268     }
4269 
4270     //       -- has a class type (i.e., T2 is a class type), where T1 is
4271     //          not reference-related to T2, and can be implicitly
4272     //          converted to an lvalue of type "cv3 T3," where "cv1 T1"
4273     //          is reference-compatible with "cv3 T3" 92) (this
4274     //          conversion is selected by enumerating the applicable
4275     //          conversion functions (13.3.1.6) and choosing the best
4276     //          one through overload resolution (13.3)),
4277     if (!SuppressUserConversions && T2->isRecordType() &&
4278         !S.RequireCompleteType(DeclLoc, T2, 0) &&
4279         RefRelationship == Sema::Ref_Incompatible) {
4280       if (FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4281                                    Init, T2, /*AllowRvalues=*/false,
4282                                    AllowExplicit))
4283         return ICS;
4284     }
4285   }
4286 
4287   //     -- Otherwise, the reference shall be an lvalue reference to a
4288   //        non-volatile const type (i.e., cv1 shall be const), or the reference
4289   //        shall be an rvalue reference.
4290   //
4291   // We actually handle one oddity of C++ [over.ics.ref] at this
4292   // point, which is that, due to p2 (which short-circuits reference
4293   // binding by only attempting a simple conversion for non-direct
4294   // bindings) and p3's strange wording, we allow a const volatile
4295   // reference to bind to an rvalue. Hence the check for the presence
4296   // of "const" rather than checking for "const" being the only
4297   // qualifier.
4298   // This is also the point where rvalue references and lvalue inits no longer
4299   // go together.
4300   if (!isRValRef && (!T1.isConstQualified() || T1.isVolatileQualified()))
4301     return ICS;
4302 
4303   //       -- If the initializer expression
4304   //
4305   //            -- is an xvalue, class prvalue, array prvalue or function
4306   //               lvalue and "cv1 T1" is reference-compatible with "cv2 T2", or
4307   if (RefRelationship >= Sema::Ref_Compatible_With_Added_Qualification &&
4308       (InitCategory.isXValue() ||
4309       (InitCategory.isPRValue() && (T2->isRecordType() || T2->isArrayType())) ||
4310       (InitCategory.isLValue() && T2->isFunctionType()))) {
4311     ICS.setStandard();
4312     ICS.Standard.First = ICK_Identity;
4313     ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4314                       : ObjCConversion? ICK_Compatible_Conversion
4315                       : ICK_Identity;
4316     ICS.Standard.Third = ICK_Identity;
4317     ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4318     ICS.Standard.setToType(0, T2);
4319     ICS.Standard.setToType(1, T1);
4320     ICS.Standard.setToType(2, T1);
4321     ICS.Standard.ReferenceBinding = true;
4322     // In C++0x, this is always a direct binding. In C++98/03, it's a direct
4323     // binding unless we're binding to a class prvalue.
4324     // Note: Although xvalues wouldn't normally show up in C++98/03 code, we
4325     // allow the use of rvalue references in C++98/03 for the benefit of
4326     // standard library implementors; therefore, we need the xvalue check here.
4327     ICS.Standard.DirectBinding =
4328       S.getLangOpts().CPlusPlus11 ||
4329       !(InitCategory.isPRValue() || T2->isRecordType());
4330     ICS.Standard.IsLvalueReference = !isRValRef;
4331     ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4332     ICS.Standard.BindsToRvalue = InitCategory.isRValue();
4333     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4334     ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4335     ICS.Standard.CopyConstructor = nullptr;
4336     ICS.Standard.DeprecatedStringLiteralToCharPtr = false;
4337     return ICS;
4338   }
4339 
4340   //            -- has a class type (i.e., T2 is a class type), where T1 is not
4341   //               reference-related to T2, and can be implicitly converted to
4342   //               an xvalue, class prvalue, or function lvalue of type
4343   //               "cv3 T3", where "cv1 T1" is reference-compatible with
4344   //               "cv3 T3",
4345   //
4346   //          then the reference is bound to the value of the initializer
4347   //          expression in the first case and to the result of the conversion
4348   //          in the second case (or, in either case, to an appropriate base
4349   //          class subobject).
4350   if (!SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4351       T2->isRecordType() && !S.RequireCompleteType(DeclLoc, T2, 0) &&
4352       FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4353                                Init, T2, /*AllowRvalues=*/true,
4354                                AllowExplicit)) {
4355     // In the second case, if the reference is an rvalue reference
4356     // and the second standard conversion sequence of the
4357     // user-defined conversion sequence includes an lvalue-to-rvalue
4358     // conversion, the program is ill-formed.
4359     if (ICS.isUserDefined() && isRValRef &&
4360         ICS.UserDefined.After.First == ICK_Lvalue_To_Rvalue)
4361       ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4362 
4363     return ICS;
4364   }
4365 
4366   // A temporary of function type cannot be created; don't even try.
4367   if (T1->isFunctionType())
4368     return ICS;
4369 
4370   //       -- Otherwise, a temporary of type "cv1 T1" is created and
4371   //          initialized from the initializer expression using the
4372   //          rules for a non-reference copy initialization (8.5). The
4373   //          reference is then bound to the temporary. If T1 is
4374   //          reference-related to T2, cv1 must be the same
4375   //          cv-qualification as, or greater cv-qualification than,
4376   //          cv2; otherwise, the program is ill-formed.
4377   if (RefRelationship == Sema::Ref_Related) {
4378     // If cv1 == cv2 or cv1 is a greater cv-qualified than cv2, then
4379     // we would be reference-compatible or reference-compatible with
4380     // added qualification. But that wasn't the case, so the reference
4381     // initialization fails.
4382     //
4383     // Note that we only want to check address spaces and cvr-qualifiers here.
4384     // ObjC GC and lifetime qualifiers aren't important.
4385     Qualifiers T1Quals = T1.getQualifiers();
4386     Qualifiers T2Quals = T2.getQualifiers();
4387     T1Quals.removeObjCGCAttr();
4388     T1Quals.removeObjCLifetime();
4389     T2Quals.removeObjCGCAttr();
4390     T2Quals.removeObjCLifetime();
4391     if (!T1Quals.compatiblyIncludes(T2Quals))
4392       return ICS;
4393   }
4394 
4395   // If at least one of the types is a class type, the types are not
4396   // related, and we aren't allowed any user conversions, the
4397   // reference binding fails. This case is important for breaking
4398   // recursion, since TryImplicitConversion below will attempt to
4399   // create a temporary through the use of a copy constructor.
4400   if (SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4401       (T1->isRecordType() || T2->isRecordType()))
4402     return ICS;
4403 
4404   // If T1 is reference-related to T2 and the reference is an rvalue
4405   // reference, the initializer expression shall not be an lvalue.
4406   if (RefRelationship >= Sema::Ref_Related &&
4407       isRValRef && Init->Classify(S.Context).isLValue())
4408     return ICS;
4409 
4410   // C++ [over.ics.ref]p2:
4411   //   When a parameter of reference type is not bound directly to
4412   //   an argument expression, the conversion sequence is the one
4413   //   required to convert the argument expression to the
4414   //   underlying type of the reference according to
4415   //   13.3.3.1. Conceptually, this conversion sequence corresponds
4416   //   to copy-initializing a temporary of the underlying type with
4417   //   the argument expression. Any difference in top-level
4418   //   cv-qualification is subsumed by the initialization itself
4419   //   and does not constitute a conversion.
4420   ICS = TryImplicitConversion(S, Init, T1, SuppressUserConversions,
4421                               /*AllowExplicit=*/false,
4422                               /*InOverloadResolution=*/false,
4423                               /*CStyle=*/false,
4424                               /*AllowObjCWritebackConversion=*/false,
4425                               /*AllowObjCConversionOnExplicit=*/false);
4426 
4427   // Of course, that's still a reference binding.
4428   if (ICS.isStandard()) {
4429     ICS.Standard.ReferenceBinding = true;
4430     ICS.Standard.IsLvalueReference = !isRValRef;
4431     ICS.Standard.BindsToFunctionLvalue = false;
4432     ICS.Standard.BindsToRvalue = true;
4433     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4434     ICS.Standard.ObjCLifetimeConversionBinding = false;
4435   } else if (ICS.isUserDefined()) {
4436     const ReferenceType *LValRefType =
4437         ICS.UserDefined.ConversionFunction->getReturnType()
4438             ->getAs<LValueReferenceType>();
4439 
4440     // C++ [over.ics.ref]p3:
4441     //   Except for an implicit object parameter, for which see 13.3.1, a
4442     //   standard conversion sequence cannot be formed if it requires [...]
4443     //   binding an rvalue reference to an lvalue other than a function
4444     //   lvalue.
4445     // Note that the function case is not possible here.
4446     if (DeclType->isRValueReferenceType() && LValRefType) {
4447       // FIXME: This is the wrong BadConversionSequence. The problem is binding
4448       // an rvalue reference to a (non-function) lvalue, not binding an lvalue
4449       // reference to an rvalue!
4450       ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, Init, DeclType);
4451       return ICS;
4452     }
4453 
4454     ICS.UserDefined.Before.setAsIdentityConversion();
4455     ICS.UserDefined.After.ReferenceBinding = true;
4456     ICS.UserDefined.After.IsLvalueReference = !isRValRef;
4457     ICS.UserDefined.After.BindsToFunctionLvalue = false;
4458     ICS.UserDefined.After.BindsToRvalue = !LValRefType;
4459     ICS.UserDefined.After.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4460     ICS.UserDefined.After.ObjCLifetimeConversionBinding = false;
4461   }
4462 
4463   return ICS;
4464 }
4465 
4466 static ImplicitConversionSequence
4467 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4468                       bool SuppressUserConversions,
4469                       bool InOverloadResolution,
4470                       bool AllowObjCWritebackConversion,
4471                       bool AllowExplicit = false);
4472 
4473 /// TryListConversion - Try to copy-initialize a value of type ToType from the
4474 /// initializer list From.
4475 static ImplicitConversionSequence
4476 TryListConversion(Sema &S, InitListExpr *From, QualType ToType,
4477                   bool SuppressUserConversions,
4478                   bool InOverloadResolution,
4479                   bool AllowObjCWritebackConversion) {
4480   // C++11 [over.ics.list]p1:
4481   //   When an argument is an initializer list, it is not an expression and
4482   //   special rules apply for converting it to a parameter type.
4483 
4484   ImplicitConversionSequence Result;
4485   Result.setBad(BadConversionSequence::no_conversion, From, ToType);
4486 
4487   // We need a complete type for what follows. Incomplete types can never be
4488   // initialized from init lists.
4489   if (S.RequireCompleteType(From->getLocStart(), ToType, 0))
4490     return Result;
4491 
4492   // C++11 [over.ics.list]p2:
4493   //   If the parameter type is std::initializer_list<X> or "array of X" and
4494   //   all the elements can be implicitly converted to X, the implicit
4495   //   conversion sequence is the worst conversion necessary to convert an
4496   //   element of the list to X.
4497   bool toStdInitializerList = false;
4498   QualType X;
4499   if (ToType->isArrayType())
4500     X = S.Context.getAsArrayType(ToType)->getElementType();
4501   else
4502     toStdInitializerList = S.isStdInitializerList(ToType, &X);
4503   if (!X.isNull()) {
4504     for (unsigned i = 0, e = From->getNumInits(); i < e; ++i) {
4505       Expr *Init = From->getInit(i);
4506       ImplicitConversionSequence ICS =
4507           TryCopyInitialization(S, Init, X, SuppressUserConversions,
4508                                 InOverloadResolution,
4509                                 AllowObjCWritebackConversion);
4510       // If a single element isn't convertible, fail.
4511       if (ICS.isBad()) {
4512         Result = ICS;
4513         break;
4514       }
4515       // Otherwise, look for the worst conversion.
4516       if (Result.isBad() ||
4517           CompareImplicitConversionSequences(S, ICS, Result) ==
4518               ImplicitConversionSequence::Worse)
4519         Result = ICS;
4520     }
4521 
4522     // For an empty list, we won't have computed any conversion sequence.
4523     // Introduce the identity conversion sequence.
4524     if (From->getNumInits() == 0) {
4525       Result.setStandard();
4526       Result.Standard.setAsIdentityConversion();
4527       Result.Standard.setFromType(ToType);
4528       Result.Standard.setAllToTypes(ToType);
4529     }
4530 
4531     Result.setStdInitializerListElement(toStdInitializerList);
4532     return Result;
4533   }
4534 
4535   // C++11 [over.ics.list]p3:
4536   //   Otherwise, if the parameter is a non-aggregate class X and overload
4537   //   resolution chooses a single best constructor [...] the implicit
4538   //   conversion sequence is a user-defined conversion sequence. If multiple
4539   //   constructors are viable but none is better than the others, the
4540   //   implicit conversion sequence is a user-defined conversion sequence.
4541   if (ToType->isRecordType() && !ToType->isAggregateType()) {
4542     // This function can deal with initializer lists.
4543     return TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
4544                                     /*AllowExplicit=*/false,
4545                                     InOverloadResolution, /*CStyle=*/false,
4546                                     AllowObjCWritebackConversion,
4547                                     /*AllowObjCConversionOnExplicit=*/false);
4548   }
4549 
4550   // C++11 [over.ics.list]p4:
4551   //   Otherwise, if the parameter has an aggregate type which can be
4552   //   initialized from the initializer list [...] the implicit conversion
4553   //   sequence is a user-defined conversion sequence.
4554   if (ToType->isAggregateType()) {
4555     // Type is an aggregate, argument is an init list. At this point it comes
4556     // down to checking whether the initialization works.
4557     // FIXME: Find out whether this parameter is consumed or not.
4558     InitializedEntity Entity =
4559         InitializedEntity::InitializeParameter(S.Context, ToType,
4560                                                /*Consumed=*/false);
4561     if (S.CanPerformCopyInitialization(Entity, From)) {
4562       Result.setUserDefined();
4563       Result.UserDefined.Before.setAsIdentityConversion();
4564       // Initializer lists don't have a type.
4565       Result.UserDefined.Before.setFromType(QualType());
4566       Result.UserDefined.Before.setAllToTypes(QualType());
4567 
4568       Result.UserDefined.After.setAsIdentityConversion();
4569       Result.UserDefined.After.setFromType(ToType);
4570       Result.UserDefined.After.setAllToTypes(ToType);
4571       Result.UserDefined.ConversionFunction = nullptr;
4572     }
4573     return Result;
4574   }
4575 
4576   // C++11 [over.ics.list]p5:
4577   //   Otherwise, if the parameter is a reference, see 13.3.3.1.4.
4578   if (ToType->isReferenceType()) {
4579     // The standard is notoriously unclear here, since 13.3.3.1.4 doesn't
4580     // mention initializer lists in any way. So we go by what list-
4581     // initialization would do and try to extrapolate from that.
4582 
4583     QualType T1 = ToType->getAs<ReferenceType>()->getPointeeType();
4584 
4585     // If the initializer list has a single element that is reference-related
4586     // to the parameter type, we initialize the reference from that.
4587     if (From->getNumInits() == 1) {
4588       Expr *Init = From->getInit(0);
4589 
4590       QualType T2 = Init->getType();
4591 
4592       // If the initializer is the address of an overloaded function, try
4593       // to resolve the overloaded function. If all goes well, T2 is the
4594       // type of the resulting function.
4595       if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4596         DeclAccessPair Found;
4597         if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(
4598                                    Init, ToType, false, Found))
4599           T2 = Fn->getType();
4600       }
4601 
4602       // Compute some basic properties of the types and the initializer.
4603       bool dummy1 = false;
4604       bool dummy2 = false;
4605       bool dummy3 = false;
4606       Sema::ReferenceCompareResult RefRelationship
4607         = S.CompareReferenceRelationship(From->getLocStart(), T1, T2, dummy1,
4608                                          dummy2, dummy3);
4609 
4610       if (RefRelationship >= Sema::Ref_Related) {
4611         return TryReferenceInit(S, Init, ToType, /*FIXME*/From->getLocStart(),
4612                                 SuppressUserConversions,
4613                                 /*AllowExplicit=*/false);
4614       }
4615     }
4616 
4617     // Otherwise, we bind the reference to a temporary created from the
4618     // initializer list.
4619     Result = TryListConversion(S, From, T1, SuppressUserConversions,
4620                                InOverloadResolution,
4621                                AllowObjCWritebackConversion);
4622     if (Result.isFailure())
4623       return Result;
4624     assert(!Result.isEllipsis() &&
4625            "Sub-initialization cannot result in ellipsis conversion.");
4626 
4627     // Can we even bind to a temporary?
4628     if (ToType->isRValueReferenceType() ||
4629         (T1.isConstQualified() && !T1.isVolatileQualified())) {
4630       StandardConversionSequence &SCS = Result.isStandard() ? Result.Standard :
4631                                             Result.UserDefined.After;
4632       SCS.ReferenceBinding = true;
4633       SCS.IsLvalueReference = ToType->isLValueReferenceType();
4634       SCS.BindsToRvalue = true;
4635       SCS.BindsToFunctionLvalue = false;
4636       SCS.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4637       SCS.ObjCLifetimeConversionBinding = false;
4638     } else
4639       Result.setBad(BadConversionSequence::lvalue_ref_to_rvalue,
4640                     From, ToType);
4641     return Result;
4642   }
4643 
4644   // C++11 [over.ics.list]p6:
4645   //   Otherwise, if the parameter type is not a class:
4646   if (!ToType->isRecordType()) {
4647     //    - if the initializer list has one element, the implicit conversion
4648     //      sequence is the one required to convert the element to the
4649     //      parameter type.
4650     unsigned NumInits = From->getNumInits();
4651     if (NumInits == 1)
4652       Result = TryCopyInitialization(S, From->getInit(0), ToType,
4653                                      SuppressUserConversions,
4654                                      InOverloadResolution,
4655                                      AllowObjCWritebackConversion);
4656     //    - if the initializer list has no elements, the implicit conversion
4657     //      sequence is the identity conversion.
4658     else if (NumInits == 0) {
4659       Result.setStandard();
4660       Result.Standard.setAsIdentityConversion();
4661       Result.Standard.setFromType(ToType);
4662       Result.Standard.setAllToTypes(ToType);
4663     }
4664     return Result;
4665   }
4666 
4667   // C++11 [over.ics.list]p7:
4668   //   In all cases other than those enumerated above, no conversion is possible
4669   return Result;
4670 }
4671 
4672 /// TryCopyInitialization - Try to copy-initialize a value of type
4673 /// ToType from the expression From. Return the implicit conversion
4674 /// sequence required to pass this argument, which may be a bad
4675 /// conversion sequence (meaning that the argument cannot be passed to
4676 /// a parameter of this type). If @p SuppressUserConversions, then we
4677 /// do not permit any user-defined conversion sequences.
4678 static ImplicitConversionSequence
4679 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4680                       bool SuppressUserConversions,
4681                       bool InOverloadResolution,
4682                       bool AllowObjCWritebackConversion,
4683                       bool AllowExplicit) {
4684   if (InitListExpr *FromInitList = dyn_cast<InitListExpr>(From))
4685     return TryListConversion(S, FromInitList, ToType, SuppressUserConversions,
4686                              InOverloadResolution,AllowObjCWritebackConversion);
4687 
4688   if (ToType->isReferenceType())
4689     return TryReferenceInit(S, From, ToType,
4690                             /*FIXME:*/From->getLocStart(),
4691                             SuppressUserConversions,
4692                             AllowExplicit);
4693 
4694   return TryImplicitConversion(S, From, ToType,
4695                                SuppressUserConversions,
4696                                /*AllowExplicit=*/false,
4697                                InOverloadResolution,
4698                                /*CStyle=*/false,
4699                                AllowObjCWritebackConversion,
4700                                /*AllowObjCConversionOnExplicit=*/false);
4701 }
4702 
4703 static bool TryCopyInitialization(const CanQualType FromQTy,
4704                                   const CanQualType ToQTy,
4705                                   Sema &S,
4706                                   SourceLocation Loc,
4707                                   ExprValueKind FromVK) {
4708   OpaqueValueExpr TmpExpr(Loc, FromQTy, FromVK);
4709   ImplicitConversionSequence ICS =
4710     TryCopyInitialization(S, &TmpExpr, ToQTy, true, true, false);
4711 
4712   return !ICS.isBad();
4713 }
4714 
4715 /// TryObjectArgumentInitialization - Try to initialize the object
4716 /// parameter of the given member function (@c Method) from the
4717 /// expression @p From.
4718 static ImplicitConversionSequence
4719 TryObjectArgumentInitialization(Sema &S, QualType FromType,
4720                                 Expr::Classification FromClassification,
4721                                 CXXMethodDecl *Method,
4722                                 CXXRecordDecl *ActingContext) {
4723   QualType ClassType = S.Context.getTypeDeclType(ActingContext);
4724   // [class.dtor]p2: A destructor can be invoked for a const, volatile or
4725   //                 const volatile object.
4726   unsigned Quals = isa<CXXDestructorDecl>(Method) ?
4727     Qualifiers::Const | Qualifiers::Volatile : Method->getTypeQualifiers();
4728   QualType ImplicitParamType =  S.Context.getCVRQualifiedType(ClassType, Quals);
4729 
4730   // Set up the conversion sequence as a "bad" conversion, to allow us
4731   // to exit early.
4732   ImplicitConversionSequence ICS;
4733 
4734   // We need to have an object of class type.
4735   if (const PointerType *PT = FromType->getAs<PointerType>()) {
4736     FromType = PT->getPointeeType();
4737 
4738     // When we had a pointer, it's implicitly dereferenced, so we
4739     // better have an lvalue.
4740     assert(FromClassification.isLValue());
4741   }
4742 
4743   assert(FromType->isRecordType());
4744 
4745   // C++0x [over.match.funcs]p4:
4746   //   For non-static member functions, the type of the implicit object
4747   //   parameter is
4748   //
4749   //     - "lvalue reference to cv X" for functions declared without a
4750   //        ref-qualifier or with the & ref-qualifier
4751   //     - "rvalue reference to cv X" for functions declared with the &&
4752   //        ref-qualifier
4753   //
4754   // where X is the class of which the function is a member and cv is the
4755   // cv-qualification on the member function declaration.
4756   //
4757   // However, when finding an implicit conversion sequence for the argument, we
4758   // are not allowed to create temporaries or perform user-defined conversions
4759   // (C++ [over.match.funcs]p5). We perform a simplified version of
4760   // reference binding here, that allows class rvalues to bind to
4761   // non-constant references.
4762 
4763   // First check the qualifiers.
4764   QualType FromTypeCanon = S.Context.getCanonicalType(FromType);
4765   if (ImplicitParamType.getCVRQualifiers()
4766                                     != FromTypeCanon.getLocalCVRQualifiers() &&
4767       !ImplicitParamType.isAtLeastAsQualifiedAs(FromTypeCanon)) {
4768     ICS.setBad(BadConversionSequence::bad_qualifiers,
4769                FromType, ImplicitParamType);
4770     return ICS;
4771   }
4772 
4773   // Check that we have either the same type or a derived type. It
4774   // affects the conversion rank.
4775   QualType ClassTypeCanon = S.Context.getCanonicalType(ClassType);
4776   ImplicitConversionKind SecondKind;
4777   if (ClassTypeCanon == FromTypeCanon.getLocalUnqualifiedType()) {
4778     SecondKind = ICK_Identity;
4779   } else if (S.IsDerivedFrom(FromType, ClassType))
4780     SecondKind = ICK_Derived_To_Base;
4781   else {
4782     ICS.setBad(BadConversionSequence::unrelated_class,
4783                FromType, ImplicitParamType);
4784     return ICS;
4785   }
4786 
4787   // Check the ref-qualifier.
4788   switch (Method->getRefQualifier()) {
4789   case RQ_None:
4790     // Do nothing; we don't care about lvalueness or rvalueness.
4791     break;
4792 
4793   case RQ_LValue:
4794     if (!FromClassification.isLValue() && Quals != Qualifiers::Const) {
4795       // non-const lvalue reference cannot bind to an rvalue
4796       ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, FromType,
4797                  ImplicitParamType);
4798       return ICS;
4799     }
4800     break;
4801 
4802   case RQ_RValue:
4803     if (!FromClassification.isRValue()) {
4804       // rvalue reference cannot bind to an lvalue
4805       ICS.setBad(BadConversionSequence::rvalue_ref_to_lvalue, FromType,
4806                  ImplicitParamType);
4807       return ICS;
4808     }
4809     break;
4810   }
4811 
4812   // Success. Mark this as a reference binding.
4813   ICS.setStandard();
4814   ICS.Standard.setAsIdentityConversion();
4815   ICS.Standard.Second = SecondKind;
4816   ICS.Standard.setFromType(FromType);
4817   ICS.Standard.setAllToTypes(ImplicitParamType);
4818   ICS.Standard.ReferenceBinding = true;
4819   ICS.Standard.DirectBinding = true;
4820   ICS.Standard.IsLvalueReference = Method->getRefQualifier() != RQ_RValue;
4821   ICS.Standard.BindsToFunctionLvalue = false;
4822   ICS.Standard.BindsToRvalue = FromClassification.isRValue();
4823   ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier
4824     = (Method->getRefQualifier() == RQ_None);
4825   return ICS;
4826 }
4827 
4828 /// PerformObjectArgumentInitialization - Perform initialization of
4829 /// the implicit object parameter for the given Method with the given
4830 /// expression.
4831 ExprResult
4832 Sema::PerformObjectArgumentInitialization(Expr *From,
4833                                           NestedNameSpecifier *Qualifier,
4834                                           NamedDecl *FoundDecl,
4835                                           CXXMethodDecl *Method) {
4836   QualType FromRecordType, DestType;
4837   QualType ImplicitParamRecordType  =
4838     Method->getThisType(Context)->getAs<PointerType>()->getPointeeType();
4839 
4840   Expr::Classification FromClassification;
4841   if (const PointerType *PT = From->getType()->getAs<PointerType>()) {
4842     FromRecordType = PT->getPointeeType();
4843     DestType = Method->getThisType(Context);
4844     FromClassification = Expr::Classification::makeSimpleLValue();
4845   } else {
4846     FromRecordType = From->getType();
4847     DestType = ImplicitParamRecordType;
4848     FromClassification = From->Classify(Context);
4849   }
4850 
4851   // Note that we always use the true parent context when performing
4852   // the actual argument initialization.
4853   ImplicitConversionSequence ICS
4854     = TryObjectArgumentInitialization(*this, From->getType(), FromClassification,
4855                                       Method, Method->getParent());
4856   if (ICS.isBad()) {
4857     if (ICS.Bad.Kind == BadConversionSequence::bad_qualifiers) {
4858       Qualifiers FromQs = FromRecordType.getQualifiers();
4859       Qualifiers ToQs = DestType.getQualifiers();
4860       unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
4861       if (CVR) {
4862         Diag(From->getLocStart(),
4863              diag::err_member_function_call_bad_cvr)
4864           << Method->getDeclName() << FromRecordType << (CVR - 1)
4865           << From->getSourceRange();
4866         Diag(Method->getLocation(), diag::note_previous_decl)
4867           << Method->getDeclName();
4868         return ExprError();
4869       }
4870     }
4871 
4872     return Diag(From->getLocStart(),
4873                 diag::err_implicit_object_parameter_init)
4874        << ImplicitParamRecordType << FromRecordType << From->getSourceRange();
4875   }
4876 
4877   if (ICS.Standard.Second == ICK_Derived_To_Base) {
4878     ExprResult FromRes =
4879       PerformObjectMemberConversion(From, Qualifier, FoundDecl, Method);
4880     if (FromRes.isInvalid())
4881       return ExprError();
4882     From = FromRes.get();
4883   }
4884 
4885   if (!Context.hasSameType(From->getType(), DestType))
4886     From = ImpCastExprToType(From, DestType, CK_NoOp,
4887                              From->getValueKind()).get();
4888   return From;
4889 }
4890 
4891 /// TryContextuallyConvertToBool - Attempt to contextually convert the
4892 /// expression From to bool (C++0x [conv]p3).
4893 static ImplicitConversionSequence
4894 TryContextuallyConvertToBool(Sema &S, Expr *From) {
4895   return TryImplicitConversion(S, From, S.Context.BoolTy,
4896                                /*SuppressUserConversions=*/false,
4897                                /*AllowExplicit=*/true,
4898                                /*InOverloadResolution=*/false,
4899                                /*CStyle=*/false,
4900                                /*AllowObjCWritebackConversion=*/false,
4901                                /*AllowObjCConversionOnExplicit=*/false);
4902 }
4903 
4904 /// PerformContextuallyConvertToBool - Perform a contextual conversion
4905 /// of the expression From to bool (C++0x [conv]p3).
4906 ExprResult Sema::PerformContextuallyConvertToBool(Expr *From) {
4907   if (checkPlaceholderForOverload(*this, From))
4908     return ExprError();
4909 
4910   ImplicitConversionSequence ICS = TryContextuallyConvertToBool(*this, From);
4911   if (!ICS.isBad())
4912     return PerformImplicitConversion(From, Context.BoolTy, ICS, AA_Converting);
4913 
4914   if (!DiagnoseMultipleUserDefinedConversion(From, Context.BoolTy))
4915     return Diag(From->getLocStart(),
4916                 diag::err_typecheck_bool_condition)
4917                   << From->getType() << From->getSourceRange();
4918   return ExprError();
4919 }
4920 
4921 /// Check that the specified conversion is permitted in a converted constant
4922 /// expression, according to C++11 [expr.const]p3. Return true if the conversion
4923 /// is acceptable.
4924 static bool CheckConvertedConstantConversions(Sema &S,
4925                                               StandardConversionSequence &SCS) {
4926   // Since we know that the target type is an integral or unscoped enumeration
4927   // type, most conversion kinds are impossible. All possible First and Third
4928   // conversions are fine.
4929   switch (SCS.Second) {
4930   case ICK_Identity:
4931   case ICK_Integral_Promotion:
4932   case ICK_Integral_Conversion:
4933   case ICK_Zero_Event_Conversion:
4934     return true;
4935 
4936   case ICK_Boolean_Conversion:
4937     // Conversion from an integral or unscoped enumeration type to bool is
4938     // classified as ICK_Boolean_Conversion, but it's also an integral
4939     // conversion, so it's permitted in a converted constant expression.
4940     return SCS.getFromType()->isIntegralOrUnscopedEnumerationType() &&
4941            SCS.getToType(2)->isBooleanType();
4942 
4943   case ICK_Floating_Integral:
4944   case ICK_Complex_Real:
4945     return false;
4946 
4947   case ICK_Lvalue_To_Rvalue:
4948   case ICK_Array_To_Pointer:
4949   case ICK_Function_To_Pointer:
4950   case ICK_NoReturn_Adjustment:
4951   case ICK_Qualification:
4952   case ICK_Compatible_Conversion:
4953   case ICK_Vector_Conversion:
4954   case ICK_Vector_Splat:
4955   case ICK_Derived_To_Base:
4956   case ICK_Pointer_Conversion:
4957   case ICK_Pointer_Member:
4958   case ICK_Block_Pointer_Conversion:
4959   case ICK_Writeback_Conversion:
4960   case ICK_Floating_Promotion:
4961   case ICK_Complex_Promotion:
4962   case ICK_Complex_Conversion:
4963   case ICK_Floating_Conversion:
4964   case ICK_TransparentUnionConversion:
4965     llvm_unreachable("unexpected second conversion kind");
4966 
4967   case ICK_Num_Conversion_Kinds:
4968     break;
4969   }
4970 
4971   llvm_unreachable("unknown conversion kind");
4972 }
4973 
4974 /// CheckConvertedConstantExpression - Check that the expression From is a
4975 /// converted constant expression of type T, perform the conversion and produce
4976 /// the converted expression, per C++11 [expr.const]p3.
4977 ExprResult Sema::CheckConvertedConstantExpression(Expr *From, QualType T,
4978                                                   llvm::APSInt &Value,
4979                                                   CCEKind CCE) {
4980   assert(LangOpts.CPlusPlus11 && "converted constant expression outside C++11");
4981   assert(T->isIntegralOrEnumerationType() && "unexpected converted const type");
4982 
4983   if (checkPlaceholderForOverload(*this, From))
4984     return ExprError();
4985 
4986   // C++11 [expr.const]p3 with proposed wording fixes:
4987   //  A converted constant expression of type T is a core constant expression,
4988   //  implicitly converted to a prvalue of type T, where the converted
4989   //  expression is a literal constant expression and the implicit conversion
4990   //  sequence contains only user-defined conversions, lvalue-to-rvalue
4991   //  conversions, integral promotions, and integral conversions other than
4992   //  narrowing conversions.
4993   ImplicitConversionSequence ICS =
4994     TryImplicitConversion(From, T,
4995                           /*SuppressUserConversions=*/false,
4996                           /*AllowExplicit=*/false,
4997                           /*InOverloadResolution=*/false,
4998                           /*CStyle=*/false,
4999                           /*AllowObjcWritebackConversion=*/false);
5000   StandardConversionSequence *SCS = nullptr;
5001   switch (ICS.getKind()) {
5002   case ImplicitConversionSequence::StandardConversion:
5003     if (!CheckConvertedConstantConversions(*this, ICS.Standard))
5004       return Diag(From->getLocStart(),
5005                   diag::err_typecheck_converted_constant_expression_disallowed)
5006                << From->getType() << From->getSourceRange() << T;
5007     SCS = &ICS.Standard;
5008     break;
5009   case ImplicitConversionSequence::UserDefinedConversion:
5010     // We are converting from class type to an integral or enumeration type, so
5011     // the Before sequence must be trivial.
5012     if (!CheckConvertedConstantConversions(*this, ICS.UserDefined.After))
5013       return Diag(From->getLocStart(),
5014                   diag::err_typecheck_converted_constant_expression_disallowed)
5015                << From->getType() << From->getSourceRange() << T;
5016     SCS = &ICS.UserDefined.After;
5017     break;
5018   case ImplicitConversionSequence::AmbiguousConversion:
5019   case ImplicitConversionSequence::BadConversion:
5020     if (!DiagnoseMultipleUserDefinedConversion(From, T))
5021       return Diag(From->getLocStart(),
5022                   diag::err_typecheck_converted_constant_expression)
5023                     << From->getType() << From->getSourceRange() << T;
5024     return ExprError();
5025 
5026   case ImplicitConversionSequence::EllipsisConversion:
5027     llvm_unreachable("ellipsis conversion in converted constant expression");
5028   }
5029 
5030   ExprResult Result = PerformImplicitConversion(From, T, ICS, AA_Converting);
5031   if (Result.isInvalid())
5032     return Result;
5033 
5034   // Check for a narrowing implicit conversion.
5035   APValue PreNarrowingValue;
5036   QualType PreNarrowingType;
5037   switch (SCS->getNarrowingKind(Context, Result.get(), PreNarrowingValue,
5038                                 PreNarrowingType)) {
5039   case NK_Variable_Narrowing:
5040     // Implicit conversion to a narrower type, and the value is not a constant
5041     // expression. We'll diagnose this in a moment.
5042   case NK_Not_Narrowing:
5043     break;
5044 
5045   case NK_Constant_Narrowing:
5046     Diag(From->getLocStart(), diag::ext_cce_narrowing)
5047       << CCE << /*Constant*/1
5048       << PreNarrowingValue.getAsString(Context, PreNarrowingType) << T;
5049     break;
5050 
5051   case NK_Type_Narrowing:
5052     Diag(From->getLocStart(), diag::ext_cce_narrowing)
5053       << CCE << /*Constant*/0 << From->getType() << T;
5054     break;
5055   }
5056 
5057   // Check the expression is a constant expression.
5058   SmallVector<PartialDiagnosticAt, 8> Notes;
5059   Expr::EvalResult Eval;
5060   Eval.Diag = &Notes;
5061 
5062   if (!Result.get()->EvaluateAsRValue(Eval, Context) || !Eval.Val.isInt()) {
5063     // The expression can't be folded, so we can't keep it at this position in
5064     // the AST.
5065     Result = ExprError();
5066   } else {
5067     Value = Eval.Val.getInt();
5068 
5069     if (Notes.empty()) {
5070       // It's a constant expression.
5071       return Result;
5072     }
5073   }
5074 
5075   // It's not a constant expression. Produce an appropriate diagnostic.
5076   if (Notes.size() == 1 &&
5077       Notes[0].second.getDiagID() == diag::note_invalid_subexpr_in_const_expr)
5078     Diag(Notes[0].first, diag::err_expr_not_cce) << CCE;
5079   else {
5080     Diag(From->getLocStart(), diag::err_expr_not_cce)
5081       << CCE << From->getSourceRange();
5082     for (unsigned I = 0; I < Notes.size(); ++I)
5083       Diag(Notes[I].first, Notes[I].second);
5084   }
5085   return Result;
5086 }
5087 
5088 /// dropPointerConversions - If the given standard conversion sequence
5089 /// involves any pointer conversions, remove them.  This may change
5090 /// the result type of the conversion sequence.
5091 static void dropPointerConversion(StandardConversionSequence &SCS) {
5092   if (SCS.Second == ICK_Pointer_Conversion) {
5093     SCS.Second = ICK_Identity;
5094     SCS.Third = ICK_Identity;
5095     SCS.ToTypePtrs[2] = SCS.ToTypePtrs[1] = SCS.ToTypePtrs[0];
5096   }
5097 }
5098 
5099 /// TryContextuallyConvertToObjCPointer - Attempt to contextually
5100 /// convert the expression From to an Objective-C pointer type.
5101 static ImplicitConversionSequence
5102 TryContextuallyConvertToObjCPointer(Sema &S, Expr *From) {
5103   // Do an implicit conversion to 'id'.
5104   QualType Ty = S.Context.getObjCIdType();
5105   ImplicitConversionSequence ICS
5106     = TryImplicitConversion(S, From, Ty,
5107                             // FIXME: Are these flags correct?
5108                             /*SuppressUserConversions=*/false,
5109                             /*AllowExplicit=*/true,
5110                             /*InOverloadResolution=*/false,
5111                             /*CStyle=*/false,
5112                             /*AllowObjCWritebackConversion=*/false,
5113                             /*AllowObjCConversionOnExplicit=*/true);
5114 
5115   // Strip off any final conversions to 'id'.
5116   switch (ICS.getKind()) {
5117   case ImplicitConversionSequence::BadConversion:
5118   case ImplicitConversionSequence::AmbiguousConversion:
5119   case ImplicitConversionSequence::EllipsisConversion:
5120     break;
5121 
5122   case ImplicitConversionSequence::UserDefinedConversion:
5123     dropPointerConversion(ICS.UserDefined.After);
5124     break;
5125 
5126   case ImplicitConversionSequence::StandardConversion:
5127     dropPointerConversion(ICS.Standard);
5128     break;
5129   }
5130 
5131   return ICS;
5132 }
5133 
5134 /// PerformContextuallyConvertToObjCPointer - Perform a contextual
5135 /// conversion of the expression From to an Objective-C pointer type.
5136 ExprResult Sema::PerformContextuallyConvertToObjCPointer(Expr *From) {
5137   if (checkPlaceholderForOverload(*this, From))
5138     return ExprError();
5139 
5140   QualType Ty = Context.getObjCIdType();
5141   ImplicitConversionSequence ICS =
5142     TryContextuallyConvertToObjCPointer(*this, From);
5143   if (!ICS.isBad())
5144     return PerformImplicitConversion(From, Ty, ICS, AA_Converting);
5145   return ExprError();
5146 }
5147 
5148 /// Determine whether the provided type is an integral type, or an enumeration
5149 /// type of a permitted flavor.
5150 bool Sema::ICEConvertDiagnoser::match(QualType T) {
5151   return AllowScopedEnumerations ? T->isIntegralOrEnumerationType()
5152                                  : T->isIntegralOrUnscopedEnumerationType();
5153 }
5154 
5155 static ExprResult
5156 diagnoseAmbiguousConversion(Sema &SemaRef, SourceLocation Loc, Expr *From,
5157                             Sema::ContextualImplicitConverter &Converter,
5158                             QualType T, UnresolvedSetImpl &ViableConversions) {
5159 
5160   if (Converter.Suppress)
5161     return ExprError();
5162 
5163   Converter.diagnoseAmbiguous(SemaRef, Loc, T) << From->getSourceRange();
5164   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5165     CXXConversionDecl *Conv =
5166         cast<CXXConversionDecl>(ViableConversions[I]->getUnderlyingDecl());
5167     QualType ConvTy = Conv->getConversionType().getNonReferenceType();
5168     Converter.noteAmbiguous(SemaRef, Conv, ConvTy);
5169   }
5170   return From;
5171 }
5172 
5173 static bool
5174 diagnoseNoViableConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5175                            Sema::ContextualImplicitConverter &Converter,
5176                            QualType T, bool HadMultipleCandidates,
5177                            UnresolvedSetImpl &ExplicitConversions) {
5178   if (ExplicitConversions.size() == 1 && !Converter.Suppress) {
5179     DeclAccessPair Found = ExplicitConversions[0];
5180     CXXConversionDecl *Conversion =
5181         cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5182 
5183     // The user probably meant to invoke the given explicit
5184     // conversion; use it.
5185     QualType ConvTy = Conversion->getConversionType().getNonReferenceType();
5186     std::string TypeStr;
5187     ConvTy.getAsStringInternal(TypeStr, SemaRef.getPrintingPolicy());
5188 
5189     Converter.diagnoseExplicitConv(SemaRef, Loc, T, ConvTy)
5190         << FixItHint::CreateInsertion(From->getLocStart(),
5191                                       "static_cast<" + TypeStr + ">(")
5192         << FixItHint::CreateInsertion(
5193                SemaRef.getLocForEndOfToken(From->getLocEnd()), ")");
5194     Converter.noteExplicitConv(SemaRef, Conversion, ConvTy);
5195 
5196     // If we aren't in a SFINAE context, build a call to the
5197     // explicit conversion function.
5198     if (SemaRef.isSFINAEContext())
5199       return true;
5200 
5201     SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, nullptr, Found);
5202     ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5203                                                        HadMultipleCandidates);
5204     if (Result.isInvalid())
5205       return true;
5206     // Record usage of conversion in an implicit cast.
5207     From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5208                                     CK_UserDefinedConversion, Result.get(),
5209                                     nullptr, Result.get()->getValueKind());
5210   }
5211   return false;
5212 }
5213 
5214 static bool recordConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5215                              Sema::ContextualImplicitConverter &Converter,
5216                              QualType T, bool HadMultipleCandidates,
5217                              DeclAccessPair &Found) {
5218   CXXConversionDecl *Conversion =
5219       cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5220   SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, nullptr, Found);
5221 
5222   QualType ToType = Conversion->getConversionType().getNonReferenceType();
5223   if (!Converter.SuppressConversion) {
5224     if (SemaRef.isSFINAEContext())
5225       return true;
5226 
5227     Converter.diagnoseConversion(SemaRef, Loc, T, ToType)
5228         << From->getSourceRange();
5229   }
5230 
5231   ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5232                                                      HadMultipleCandidates);
5233   if (Result.isInvalid())
5234     return true;
5235   // Record usage of conversion in an implicit cast.
5236   From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5237                                   CK_UserDefinedConversion, Result.get(),
5238                                   nullptr, Result.get()->getValueKind());
5239   return false;
5240 }
5241 
5242 static ExprResult finishContextualImplicitConversion(
5243     Sema &SemaRef, SourceLocation Loc, Expr *From,
5244     Sema::ContextualImplicitConverter &Converter) {
5245   if (!Converter.match(From->getType()) && !Converter.Suppress)
5246     Converter.diagnoseNoMatch(SemaRef, Loc, From->getType())
5247         << From->getSourceRange();
5248 
5249   return SemaRef.DefaultLvalueConversion(From);
5250 }
5251 
5252 static void
5253 collectViableConversionCandidates(Sema &SemaRef, Expr *From, QualType ToType,
5254                                   UnresolvedSetImpl &ViableConversions,
5255                                   OverloadCandidateSet &CandidateSet) {
5256   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5257     DeclAccessPair FoundDecl = ViableConversions[I];
5258     NamedDecl *D = FoundDecl.getDecl();
5259     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
5260     if (isa<UsingShadowDecl>(D))
5261       D = cast<UsingShadowDecl>(D)->getTargetDecl();
5262 
5263     CXXConversionDecl *Conv;
5264     FunctionTemplateDecl *ConvTemplate;
5265     if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
5266       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5267     else
5268       Conv = cast<CXXConversionDecl>(D);
5269 
5270     if (ConvTemplate)
5271       SemaRef.AddTemplateConversionCandidate(
5272         ConvTemplate, FoundDecl, ActingContext, From, ToType, CandidateSet,
5273         /*AllowObjCConversionOnExplicit=*/false);
5274     else
5275       SemaRef.AddConversionCandidate(Conv, FoundDecl, ActingContext, From,
5276                                      ToType, CandidateSet,
5277                                      /*AllowObjCConversionOnExplicit=*/false);
5278   }
5279 }
5280 
5281 /// \brief Attempt to convert the given expression to a type which is accepted
5282 /// by the given converter.
5283 ///
5284 /// This routine will attempt to convert an expression of class type to a
5285 /// type accepted by the specified converter. In C++11 and before, the class
5286 /// must have a single non-explicit conversion function converting to a matching
5287 /// type. In C++1y, there can be multiple such conversion functions, but only
5288 /// one target type.
5289 ///
5290 /// \param Loc The source location of the construct that requires the
5291 /// conversion.
5292 ///
5293 /// \param From The expression we're converting from.
5294 ///
5295 /// \param Converter Used to control and diagnose the conversion process.
5296 ///
5297 /// \returns The expression, converted to an integral or enumeration type if
5298 /// successful.
5299 ExprResult Sema::PerformContextualImplicitConversion(
5300     SourceLocation Loc, Expr *From, ContextualImplicitConverter &Converter) {
5301   // We can't perform any more checking for type-dependent expressions.
5302   if (From->isTypeDependent())
5303     return From;
5304 
5305   // Process placeholders immediately.
5306   if (From->hasPlaceholderType()) {
5307     ExprResult result = CheckPlaceholderExpr(From);
5308     if (result.isInvalid())
5309       return result;
5310     From = result.get();
5311   }
5312 
5313   // If the expression already has a matching type, we're golden.
5314   QualType T = From->getType();
5315   if (Converter.match(T))
5316     return DefaultLvalueConversion(From);
5317 
5318   // FIXME: Check for missing '()' if T is a function type?
5319 
5320   // We can only perform contextual implicit conversions on objects of class
5321   // type.
5322   const RecordType *RecordTy = T->getAs<RecordType>();
5323   if (!RecordTy || !getLangOpts().CPlusPlus) {
5324     if (!Converter.Suppress)
5325       Converter.diagnoseNoMatch(*this, Loc, T) << From->getSourceRange();
5326     return From;
5327   }
5328 
5329   // We must have a complete class type.
5330   struct TypeDiagnoserPartialDiag : TypeDiagnoser {
5331     ContextualImplicitConverter &Converter;
5332     Expr *From;
5333 
5334     TypeDiagnoserPartialDiag(ContextualImplicitConverter &Converter, Expr *From)
5335         : TypeDiagnoser(Converter.Suppress), Converter(Converter), From(From) {}
5336 
5337     void diagnose(Sema &S, SourceLocation Loc, QualType T) override {
5338       Converter.diagnoseIncomplete(S, Loc, T) << From->getSourceRange();
5339     }
5340   } IncompleteDiagnoser(Converter, From);
5341 
5342   if (RequireCompleteType(Loc, T, IncompleteDiagnoser))
5343     return From;
5344 
5345   // Look for a conversion to an integral or enumeration type.
5346   UnresolvedSet<4>
5347       ViableConversions; // These are *potentially* viable in C++1y.
5348   UnresolvedSet<4> ExplicitConversions;
5349   std::pair<CXXRecordDecl::conversion_iterator,
5350             CXXRecordDecl::conversion_iterator> Conversions =
5351       cast<CXXRecordDecl>(RecordTy->getDecl())->getVisibleConversionFunctions();
5352 
5353   bool HadMultipleCandidates =
5354       (std::distance(Conversions.first, Conversions.second) > 1);
5355 
5356   // To check that there is only one target type, in C++1y:
5357   QualType ToType;
5358   bool HasUniqueTargetType = true;
5359 
5360   // Collect explicit or viable (potentially in C++1y) conversions.
5361   for (CXXRecordDecl::conversion_iterator I = Conversions.first,
5362                                           E = Conversions.second;
5363        I != E; ++I) {
5364     NamedDecl *D = (*I)->getUnderlyingDecl();
5365     CXXConversionDecl *Conversion;
5366     FunctionTemplateDecl *ConvTemplate = dyn_cast<FunctionTemplateDecl>(D);
5367     if (ConvTemplate) {
5368       if (getLangOpts().CPlusPlus14)
5369         Conversion = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5370       else
5371         continue; // C++11 does not consider conversion operator templates(?).
5372     } else
5373       Conversion = cast<CXXConversionDecl>(D);
5374 
5375     assert((!ConvTemplate || getLangOpts().CPlusPlus14) &&
5376            "Conversion operator templates are considered potentially "
5377            "viable in C++1y");
5378 
5379     QualType CurToType = Conversion->getConversionType().getNonReferenceType();
5380     if (Converter.match(CurToType) || ConvTemplate) {
5381 
5382       if (Conversion->isExplicit()) {
5383         // FIXME: For C++1y, do we need this restriction?
5384         // cf. diagnoseNoViableConversion()
5385         if (!ConvTemplate)
5386           ExplicitConversions.addDecl(I.getDecl(), I.getAccess());
5387       } else {
5388         if (!ConvTemplate && getLangOpts().CPlusPlus14) {
5389           if (ToType.isNull())
5390             ToType = CurToType.getUnqualifiedType();
5391           else if (HasUniqueTargetType &&
5392                    (CurToType.getUnqualifiedType() != ToType))
5393             HasUniqueTargetType = false;
5394         }
5395         ViableConversions.addDecl(I.getDecl(), I.getAccess());
5396       }
5397     }
5398   }
5399 
5400   if (getLangOpts().CPlusPlus14) {
5401     // C++1y [conv]p6:
5402     // ... An expression e of class type E appearing in such a context
5403     // is said to be contextually implicitly converted to a specified
5404     // type T and is well-formed if and only if e can be implicitly
5405     // converted to a type T that is determined as follows: E is searched
5406     // for conversion functions whose return type is cv T or reference to
5407     // cv T such that T is allowed by the context. There shall be
5408     // exactly one such T.
5409 
5410     // If no unique T is found:
5411     if (ToType.isNull()) {
5412       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5413                                      HadMultipleCandidates,
5414                                      ExplicitConversions))
5415         return ExprError();
5416       return finishContextualImplicitConversion(*this, Loc, From, Converter);
5417     }
5418 
5419     // If more than one unique Ts are found:
5420     if (!HasUniqueTargetType)
5421       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5422                                          ViableConversions);
5423 
5424     // If one unique T is found:
5425     // First, build a candidate set from the previously recorded
5426     // potentially viable conversions.
5427     OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Normal);
5428     collectViableConversionCandidates(*this, From, ToType, ViableConversions,
5429                                       CandidateSet);
5430 
5431     // Then, perform overload resolution over the candidate set.
5432     OverloadCandidateSet::iterator Best;
5433     switch (CandidateSet.BestViableFunction(*this, Loc, Best)) {
5434     case OR_Success: {
5435       // Apply this conversion.
5436       DeclAccessPair Found =
5437           DeclAccessPair::make(Best->Function, Best->FoundDecl.getAccess());
5438       if (recordConversion(*this, Loc, From, Converter, T,
5439                            HadMultipleCandidates, Found))
5440         return ExprError();
5441       break;
5442     }
5443     case OR_Ambiguous:
5444       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5445                                          ViableConversions);
5446     case OR_No_Viable_Function:
5447       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5448                                      HadMultipleCandidates,
5449                                      ExplicitConversions))
5450         return ExprError();
5451     // fall through 'OR_Deleted' case.
5452     case OR_Deleted:
5453       // We'll complain below about a non-integral condition type.
5454       break;
5455     }
5456   } else {
5457     switch (ViableConversions.size()) {
5458     case 0: {
5459       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5460                                      HadMultipleCandidates,
5461                                      ExplicitConversions))
5462         return ExprError();
5463 
5464       // We'll complain below about a non-integral condition type.
5465       break;
5466     }
5467     case 1: {
5468       // Apply this conversion.
5469       DeclAccessPair Found = ViableConversions[0];
5470       if (recordConversion(*this, Loc, From, Converter, T,
5471                            HadMultipleCandidates, Found))
5472         return ExprError();
5473       break;
5474     }
5475     default:
5476       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5477                                          ViableConversions);
5478     }
5479   }
5480 
5481   return finishContextualImplicitConversion(*this, Loc, From, Converter);
5482 }
5483 
5484 /// IsAcceptableNonMemberOperatorCandidate - Determine whether Fn is
5485 /// an acceptable non-member overloaded operator for a call whose
5486 /// arguments have types T1 (and, if non-empty, T2). This routine
5487 /// implements the check in C++ [over.match.oper]p3b2 concerning
5488 /// enumeration types.
5489 static bool IsAcceptableNonMemberOperatorCandidate(ASTContext &Context,
5490                                                    FunctionDecl *Fn,
5491                                                    ArrayRef<Expr *> Args) {
5492   QualType T1 = Args[0]->getType();
5493   QualType T2 = Args.size() > 1 ? Args[1]->getType() : QualType();
5494 
5495   if (T1->isDependentType() || (!T2.isNull() && T2->isDependentType()))
5496     return true;
5497 
5498   if (T1->isRecordType() || (!T2.isNull() && T2->isRecordType()))
5499     return true;
5500 
5501   const FunctionProtoType *Proto = Fn->getType()->getAs<FunctionProtoType>();
5502   if (Proto->getNumParams() < 1)
5503     return false;
5504 
5505   if (T1->isEnumeralType()) {
5506     QualType ArgType = Proto->getParamType(0).getNonReferenceType();
5507     if (Context.hasSameUnqualifiedType(T1, ArgType))
5508       return true;
5509   }
5510 
5511   if (Proto->getNumParams() < 2)
5512     return false;
5513 
5514   if (!T2.isNull() && T2->isEnumeralType()) {
5515     QualType ArgType = Proto->getParamType(1).getNonReferenceType();
5516     if (Context.hasSameUnqualifiedType(T2, ArgType))
5517       return true;
5518   }
5519 
5520   return false;
5521 }
5522 
5523 /// AddOverloadCandidate - Adds the given function to the set of
5524 /// candidate functions, using the given function call arguments.  If
5525 /// @p SuppressUserConversions, then don't allow user-defined
5526 /// conversions via constructors or conversion operators.
5527 ///
5528 /// \param PartialOverloading true if we are performing "partial" overloading
5529 /// based on an incomplete set of function arguments. This feature is used by
5530 /// code completion.
5531 void
5532 Sema::AddOverloadCandidate(FunctionDecl *Function,
5533                            DeclAccessPair FoundDecl,
5534                            ArrayRef<Expr *> Args,
5535                            OverloadCandidateSet &CandidateSet,
5536                            bool SuppressUserConversions,
5537                            bool PartialOverloading,
5538                            bool AllowExplicit) {
5539   const FunctionProtoType *Proto
5540     = dyn_cast<FunctionProtoType>(Function->getType()->getAs<FunctionType>());
5541   assert(Proto && "Functions without a prototype cannot be overloaded");
5542   assert(!Function->getDescribedFunctionTemplate() &&
5543          "Use AddTemplateOverloadCandidate for function templates");
5544 
5545   if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Function)) {
5546     if (!isa<CXXConstructorDecl>(Method)) {
5547       // If we get here, it's because we're calling a member function
5548       // that is named without a member access expression (e.g.,
5549       // "this->f") that was either written explicitly or created
5550       // implicitly. This can happen with a qualified call to a member
5551       // function, e.g., X::f(). We use an empty type for the implied
5552       // object argument (C++ [over.call.func]p3), and the acting context
5553       // is irrelevant.
5554       AddMethodCandidate(Method, FoundDecl, Method->getParent(),
5555                          QualType(), Expr::Classification::makeSimpleLValue(),
5556                          Args, CandidateSet, SuppressUserConversions);
5557       return;
5558     }
5559     // We treat a constructor like a non-member function, since its object
5560     // argument doesn't participate in overload resolution.
5561   }
5562 
5563   if (!CandidateSet.isNewCandidate(Function))
5564     return;
5565 
5566   // C++ [over.match.oper]p3:
5567   //   if no operand has a class type, only those non-member functions in the
5568   //   lookup set that have a first parameter of type T1 or "reference to
5569   //   (possibly cv-qualified) T1", when T1 is an enumeration type, or (if there
5570   //   is a right operand) a second parameter of type T2 or "reference to
5571   //   (possibly cv-qualified) T2", when T2 is an enumeration type, are
5572   //   candidate functions.
5573   if (CandidateSet.getKind() == OverloadCandidateSet::CSK_Operator &&
5574       !IsAcceptableNonMemberOperatorCandidate(Context, Function, Args))
5575     return;
5576 
5577   // C++11 [class.copy]p11: [DR1402]
5578   //   A defaulted move constructor that is defined as deleted is ignored by
5579   //   overload resolution.
5580   CXXConstructorDecl *Constructor = dyn_cast<CXXConstructorDecl>(Function);
5581   if (Constructor && Constructor->isDefaulted() && Constructor->isDeleted() &&
5582       Constructor->isMoveConstructor())
5583     return;
5584 
5585   // Overload resolution is always an unevaluated context.
5586   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
5587 
5588   if (Constructor) {
5589     // C++ [class.copy]p3:
5590     //   A member function template is never instantiated to perform the copy
5591     //   of a class object to an object of its class type.
5592     QualType ClassType = Context.getTypeDeclType(Constructor->getParent());
5593     if (Args.size() == 1 &&
5594         Constructor->isSpecializationCopyingObject() &&
5595         (Context.hasSameUnqualifiedType(ClassType, Args[0]->getType()) ||
5596          IsDerivedFrom(Args[0]->getType(), ClassType)))
5597       return;
5598   }
5599 
5600   // Add this candidate
5601   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size());
5602   Candidate.FoundDecl = FoundDecl;
5603   Candidate.Function = Function;
5604   Candidate.Viable = true;
5605   Candidate.IsSurrogate = false;
5606   Candidate.IgnoreObjectArgument = false;
5607   Candidate.ExplicitCallArguments = Args.size();
5608 
5609   unsigned NumParams = Proto->getNumParams();
5610 
5611   // (C++ 13.3.2p2): A candidate function having fewer than m
5612   // parameters is viable only if it has an ellipsis in its parameter
5613   // list (8.3.5).
5614   if ((Args.size() + (PartialOverloading && Args.size())) > NumParams &&
5615       !Proto->isVariadic()) {
5616     Candidate.Viable = false;
5617     Candidate.FailureKind = ovl_fail_too_many_arguments;
5618     return;
5619   }
5620 
5621   // (C++ 13.3.2p2): A candidate function having more than m parameters
5622   // is viable only if the (m+1)st parameter has a default argument
5623   // (8.3.6). For the purposes of overload resolution, the
5624   // parameter list is truncated on the right, so that there are
5625   // exactly m parameters.
5626   unsigned MinRequiredArgs = Function->getMinRequiredArguments();
5627   if (Args.size() < MinRequiredArgs && !PartialOverloading) {
5628     // Not enough arguments.
5629     Candidate.Viable = false;
5630     Candidate.FailureKind = ovl_fail_too_few_arguments;
5631     return;
5632   }
5633 
5634   // (CUDA B.1): Check for invalid calls between targets.
5635   if (getLangOpts().CUDA)
5636     if (const FunctionDecl *Caller = dyn_cast<FunctionDecl>(CurContext))
5637       if (CheckCUDATarget(Caller, Function)) {
5638         Candidate.Viable = false;
5639         Candidate.FailureKind = ovl_fail_bad_target;
5640         return;
5641       }
5642 
5643   // Determine the implicit conversion sequences for each of the
5644   // arguments.
5645   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
5646     if (ArgIdx < NumParams) {
5647       // (C++ 13.3.2p3): for F to be a viable function, there shall
5648       // exist for each argument an implicit conversion sequence
5649       // (13.3.3.1) that converts that argument to the corresponding
5650       // parameter of F.
5651       QualType ParamType = Proto->getParamType(ArgIdx);
5652       Candidate.Conversions[ArgIdx]
5653         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
5654                                 SuppressUserConversions,
5655                                 /*InOverloadResolution=*/true,
5656                                 /*AllowObjCWritebackConversion=*/
5657                                   getLangOpts().ObjCAutoRefCount,
5658                                 AllowExplicit);
5659       if (Candidate.Conversions[ArgIdx].isBad()) {
5660         Candidate.Viable = false;
5661         Candidate.FailureKind = ovl_fail_bad_conversion;
5662         return;
5663       }
5664     } else {
5665       // (C++ 13.3.2p2): For the purposes of overload resolution, any
5666       // argument for which there is no corresponding parameter is
5667       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
5668       Candidate.Conversions[ArgIdx].setEllipsis();
5669     }
5670   }
5671 
5672   if (EnableIfAttr *FailedAttr = CheckEnableIf(Function, Args)) {
5673     Candidate.Viable = false;
5674     Candidate.FailureKind = ovl_fail_enable_if;
5675     Candidate.DeductionFailure.Data = FailedAttr;
5676     return;
5677   }
5678 }
5679 
5680 ObjCMethodDecl *Sema::SelectBestMethod(Selector Sel, MultiExprArg Args,
5681                                        bool IsInstance) {
5682   SmallVector<ObjCMethodDecl*, 4> Methods;
5683   if (!CollectMultipleMethodsInGlobalPool(Sel, Methods, IsInstance))
5684     return nullptr;
5685 
5686   for (unsigned b = 0, e = Methods.size(); b < e; b++) {
5687     bool Match = true;
5688     ObjCMethodDecl *Method = Methods[b];
5689     unsigned NumNamedArgs = Sel.getNumArgs();
5690     // Method might have more arguments than selector indicates. This is due
5691     // to addition of c-style arguments in method.
5692     if (Method->param_size() > NumNamedArgs)
5693       NumNamedArgs = Method->param_size();
5694     if (Args.size() < NumNamedArgs)
5695       continue;
5696 
5697     for (unsigned i = 0; i < NumNamedArgs; i++) {
5698       // We can't do any type-checking on a type-dependent argument.
5699       if (Args[i]->isTypeDependent()) {
5700         Match = false;
5701         break;
5702       }
5703 
5704       ParmVarDecl *param = Method->parameters()[i];
5705       Expr *argExpr = Args[i];
5706       assert(argExpr && "SelectBestMethod(): missing expression");
5707 
5708       // Strip the unbridged-cast placeholder expression off unless it's
5709       // a consumed argument.
5710       if (argExpr->hasPlaceholderType(BuiltinType::ARCUnbridgedCast) &&
5711           !param->hasAttr<CFConsumedAttr>())
5712         argExpr = stripARCUnbridgedCast(argExpr);
5713 
5714       // If the parameter is __unknown_anytype, move on to the next method.
5715       if (param->getType() == Context.UnknownAnyTy) {
5716         Match = false;
5717         break;
5718       }
5719 
5720       ImplicitConversionSequence ConversionState
5721         = TryCopyInitialization(*this, argExpr, param->getType(),
5722                                 /*SuppressUserConversions*/false,
5723                                 /*InOverloadResolution=*/true,
5724                                 /*AllowObjCWritebackConversion=*/
5725                                 getLangOpts().ObjCAutoRefCount,
5726                                 /*AllowExplicit*/false);
5727         if (ConversionState.isBad()) {
5728           Match = false;
5729           break;
5730         }
5731     }
5732     // Promote additional arguments to variadic methods.
5733     if (Match && Method->isVariadic()) {
5734       for (unsigned i = NumNamedArgs, e = Args.size(); i < e; ++i) {
5735         if (Args[i]->isTypeDependent()) {
5736           Match = false;
5737           break;
5738         }
5739         ExprResult Arg = DefaultVariadicArgumentPromotion(Args[i], VariadicMethod,
5740                                                           nullptr);
5741         if (Arg.isInvalid()) {
5742           Match = false;
5743           break;
5744         }
5745       }
5746     } else {
5747       // Check for extra arguments to non-variadic methods.
5748       if (Args.size() != NumNamedArgs)
5749         Match = false;
5750       else if (Match && NumNamedArgs == 0 && Methods.size() > 1) {
5751         // Special case when selectors have no argument. In this case, select
5752         // one with the most general result type of 'id'.
5753         for (unsigned b = 0, e = Methods.size(); b < e; b++) {
5754           QualType ReturnT = Methods[b]->getReturnType();
5755           if (ReturnT->isObjCIdType())
5756             return Methods[b];
5757         }
5758       }
5759     }
5760 
5761     if (Match)
5762       return Method;
5763   }
5764   return nullptr;
5765 }
5766 
5767 static bool IsNotEnableIfAttr(Attr *A) { return !isa<EnableIfAttr>(A); }
5768 
5769 EnableIfAttr *Sema::CheckEnableIf(FunctionDecl *Function, ArrayRef<Expr *> Args,
5770                                   bool MissingImplicitThis) {
5771   // FIXME: specific_attr_iterator<EnableIfAttr> iterates in reverse order, but
5772   // we need to find the first failing one.
5773   if (!Function->hasAttrs())
5774     return nullptr;
5775   AttrVec Attrs = Function->getAttrs();
5776   AttrVec::iterator E = std::remove_if(Attrs.begin(), Attrs.end(),
5777                                        IsNotEnableIfAttr);
5778   if (Attrs.begin() == E)
5779     return nullptr;
5780   std::reverse(Attrs.begin(), E);
5781 
5782   SFINAETrap Trap(*this);
5783 
5784   // Convert the arguments.
5785   SmallVector<Expr *, 16> ConvertedArgs;
5786   bool InitializationFailed = false;
5787   for (unsigned i = 0, e = Args.size(); i != e; ++i) {
5788     if (i == 0 && !MissingImplicitThis && isa<CXXMethodDecl>(Function) &&
5789         !cast<CXXMethodDecl>(Function)->isStatic() &&
5790         !isa<CXXConstructorDecl>(Function)) {
5791       CXXMethodDecl *Method = cast<CXXMethodDecl>(Function);
5792       ExprResult R =
5793         PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/nullptr,
5794                                             Method, Method);
5795       if (R.isInvalid()) {
5796         InitializationFailed = true;
5797         break;
5798       }
5799       ConvertedArgs.push_back(R.get());
5800     } else {
5801       ExprResult R =
5802         PerformCopyInitialization(InitializedEntity::InitializeParameter(
5803                                                 Context,
5804                                                 Function->getParamDecl(i)),
5805                                   SourceLocation(),
5806                                   Args[i]);
5807       if (R.isInvalid()) {
5808         InitializationFailed = true;
5809         break;
5810       }
5811       ConvertedArgs.push_back(R.get());
5812     }
5813   }
5814 
5815   if (InitializationFailed || Trap.hasErrorOccurred())
5816     return cast<EnableIfAttr>(Attrs[0]);
5817 
5818   for (AttrVec::iterator I = Attrs.begin(); I != E; ++I) {
5819     APValue Result;
5820     EnableIfAttr *EIA = cast<EnableIfAttr>(*I);
5821     if (!EIA->getCond()->EvaluateWithSubstitution(
5822             Result, Context, Function,
5823             ArrayRef<const Expr*>(ConvertedArgs.data(),
5824                                   ConvertedArgs.size())) ||
5825         !Result.isInt() || !Result.getInt().getBoolValue()) {
5826       return EIA;
5827     }
5828   }
5829   return nullptr;
5830 }
5831 
5832 /// \brief Add all of the function declarations in the given function set to
5833 /// the overload candidate set.
5834 void Sema::AddFunctionCandidates(const UnresolvedSetImpl &Fns,
5835                                  ArrayRef<Expr *> Args,
5836                                  OverloadCandidateSet& CandidateSet,
5837                                  bool SuppressUserConversions,
5838                                TemplateArgumentListInfo *ExplicitTemplateArgs) {
5839   for (UnresolvedSetIterator F = Fns.begin(), E = Fns.end(); F != E; ++F) {
5840     NamedDecl *D = F.getDecl()->getUnderlyingDecl();
5841     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
5842       if (isa<CXXMethodDecl>(FD) && !cast<CXXMethodDecl>(FD)->isStatic())
5843         AddMethodCandidate(cast<CXXMethodDecl>(FD), F.getPair(),
5844                            cast<CXXMethodDecl>(FD)->getParent(),
5845                            Args[0]->getType(), Args[0]->Classify(Context),
5846                            Args.slice(1), CandidateSet,
5847                            SuppressUserConversions);
5848       else
5849         AddOverloadCandidate(FD, F.getPair(), Args, CandidateSet,
5850                              SuppressUserConversions);
5851     } else {
5852       FunctionTemplateDecl *FunTmpl = cast<FunctionTemplateDecl>(D);
5853       if (isa<CXXMethodDecl>(FunTmpl->getTemplatedDecl()) &&
5854           !cast<CXXMethodDecl>(FunTmpl->getTemplatedDecl())->isStatic())
5855         AddMethodTemplateCandidate(FunTmpl, F.getPair(),
5856                               cast<CXXRecordDecl>(FunTmpl->getDeclContext()),
5857                                    ExplicitTemplateArgs,
5858                                    Args[0]->getType(),
5859                                    Args[0]->Classify(Context), Args.slice(1),
5860                                    CandidateSet, SuppressUserConversions);
5861       else
5862         AddTemplateOverloadCandidate(FunTmpl, F.getPair(),
5863                                      ExplicitTemplateArgs, Args,
5864                                      CandidateSet, SuppressUserConversions);
5865     }
5866   }
5867 }
5868 
5869 /// AddMethodCandidate - Adds a named decl (which is some kind of
5870 /// method) as a method candidate to the given overload set.
5871 void Sema::AddMethodCandidate(DeclAccessPair FoundDecl,
5872                               QualType ObjectType,
5873                               Expr::Classification ObjectClassification,
5874                               ArrayRef<Expr *> Args,
5875                               OverloadCandidateSet& CandidateSet,
5876                               bool SuppressUserConversions) {
5877   NamedDecl *Decl = FoundDecl.getDecl();
5878   CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(Decl->getDeclContext());
5879 
5880   if (isa<UsingShadowDecl>(Decl))
5881     Decl = cast<UsingShadowDecl>(Decl)->getTargetDecl();
5882 
5883   if (FunctionTemplateDecl *TD = dyn_cast<FunctionTemplateDecl>(Decl)) {
5884     assert(isa<CXXMethodDecl>(TD->getTemplatedDecl()) &&
5885            "Expected a member function template");
5886     AddMethodTemplateCandidate(TD, FoundDecl, ActingContext,
5887                                /*ExplicitArgs*/ nullptr,
5888                                ObjectType, ObjectClassification,
5889                                Args, CandidateSet,
5890                                SuppressUserConversions);
5891   } else {
5892     AddMethodCandidate(cast<CXXMethodDecl>(Decl), FoundDecl, ActingContext,
5893                        ObjectType, ObjectClassification,
5894                        Args,
5895                        CandidateSet, SuppressUserConversions);
5896   }
5897 }
5898 
5899 /// AddMethodCandidate - Adds the given C++ member function to the set
5900 /// of candidate functions, using the given function call arguments
5901 /// and the object argument (@c Object). For example, in a call
5902 /// @c o.f(a1,a2), @c Object will contain @c o and @c Args will contain
5903 /// both @c a1 and @c a2. If @p SuppressUserConversions, then don't
5904 /// allow user-defined conversions via constructors or conversion
5905 /// operators.
5906 void
5907 Sema::AddMethodCandidate(CXXMethodDecl *Method, DeclAccessPair FoundDecl,
5908                          CXXRecordDecl *ActingContext, QualType ObjectType,
5909                          Expr::Classification ObjectClassification,
5910                          ArrayRef<Expr *> Args,
5911                          OverloadCandidateSet &CandidateSet,
5912                          bool SuppressUserConversions) {
5913   const FunctionProtoType *Proto
5914     = dyn_cast<FunctionProtoType>(Method->getType()->getAs<FunctionType>());
5915   assert(Proto && "Methods without a prototype cannot be overloaded");
5916   assert(!isa<CXXConstructorDecl>(Method) &&
5917          "Use AddOverloadCandidate for constructors");
5918 
5919   if (!CandidateSet.isNewCandidate(Method))
5920     return;
5921 
5922   // C++11 [class.copy]p23: [DR1402]
5923   //   A defaulted move assignment operator that is defined as deleted is
5924   //   ignored by overload resolution.
5925   if (Method->isDefaulted() && Method->isDeleted() &&
5926       Method->isMoveAssignmentOperator())
5927     return;
5928 
5929   // Overload resolution is always an unevaluated context.
5930   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
5931 
5932   // Add this candidate
5933   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size() + 1);
5934   Candidate.FoundDecl = FoundDecl;
5935   Candidate.Function = Method;
5936   Candidate.IsSurrogate = false;
5937   Candidate.IgnoreObjectArgument = false;
5938   Candidate.ExplicitCallArguments = Args.size();
5939 
5940   unsigned NumParams = Proto->getNumParams();
5941 
5942   // (C++ 13.3.2p2): A candidate function having fewer than m
5943   // parameters is viable only if it has an ellipsis in its parameter
5944   // list (8.3.5).
5945   if (Args.size() > NumParams && !Proto->isVariadic()) {
5946     Candidate.Viable = false;
5947     Candidate.FailureKind = ovl_fail_too_many_arguments;
5948     return;
5949   }
5950 
5951   // (C++ 13.3.2p2): A candidate function having more than m parameters
5952   // is viable only if the (m+1)st parameter has a default argument
5953   // (8.3.6). For the purposes of overload resolution, the
5954   // parameter list is truncated on the right, so that there are
5955   // exactly m parameters.
5956   unsigned MinRequiredArgs = Method->getMinRequiredArguments();
5957   if (Args.size() < MinRequiredArgs) {
5958     // Not enough arguments.
5959     Candidate.Viable = false;
5960     Candidate.FailureKind = ovl_fail_too_few_arguments;
5961     return;
5962   }
5963 
5964   Candidate.Viable = true;
5965 
5966   if (Method->isStatic() || ObjectType.isNull())
5967     // The implicit object argument is ignored.
5968     Candidate.IgnoreObjectArgument = true;
5969   else {
5970     // Determine the implicit conversion sequence for the object
5971     // parameter.
5972     Candidate.Conversions[0]
5973       = TryObjectArgumentInitialization(*this, ObjectType, ObjectClassification,
5974                                         Method, ActingContext);
5975     if (Candidate.Conversions[0].isBad()) {
5976       Candidate.Viable = false;
5977       Candidate.FailureKind = ovl_fail_bad_conversion;
5978       return;
5979     }
5980   }
5981 
5982   // Determine the implicit conversion sequences for each of the
5983   // arguments.
5984   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
5985     if (ArgIdx < NumParams) {
5986       // (C++ 13.3.2p3): for F to be a viable function, there shall
5987       // exist for each argument an implicit conversion sequence
5988       // (13.3.3.1) that converts that argument to the corresponding
5989       // parameter of F.
5990       QualType ParamType = Proto->getParamType(ArgIdx);
5991       Candidate.Conversions[ArgIdx + 1]
5992         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
5993                                 SuppressUserConversions,
5994                                 /*InOverloadResolution=*/true,
5995                                 /*AllowObjCWritebackConversion=*/
5996                                   getLangOpts().ObjCAutoRefCount);
5997       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
5998         Candidate.Viable = false;
5999         Candidate.FailureKind = ovl_fail_bad_conversion;
6000         return;
6001       }
6002     } else {
6003       // (C++ 13.3.2p2): For the purposes of overload resolution, any
6004       // argument for which there is no corresponding parameter is
6005       // considered to "match the ellipsis" (C+ 13.3.3.1.3).
6006       Candidate.Conversions[ArgIdx + 1].setEllipsis();
6007     }
6008   }
6009 
6010   if (EnableIfAttr *FailedAttr = CheckEnableIf(Method, Args, true)) {
6011     Candidate.Viable = false;
6012     Candidate.FailureKind = ovl_fail_enable_if;
6013     Candidate.DeductionFailure.Data = FailedAttr;
6014     return;
6015   }
6016 }
6017 
6018 /// \brief Add a C++ member function template as a candidate to the candidate
6019 /// set, using template argument deduction to produce an appropriate member
6020 /// function template specialization.
6021 void
6022 Sema::AddMethodTemplateCandidate(FunctionTemplateDecl *MethodTmpl,
6023                                  DeclAccessPair FoundDecl,
6024                                  CXXRecordDecl *ActingContext,
6025                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
6026                                  QualType ObjectType,
6027                                  Expr::Classification ObjectClassification,
6028                                  ArrayRef<Expr *> Args,
6029                                  OverloadCandidateSet& CandidateSet,
6030                                  bool SuppressUserConversions) {
6031   if (!CandidateSet.isNewCandidate(MethodTmpl))
6032     return;
6033 
6034   // C++ [over.match.funcs]p7:
6035   //   In each case where a candidate is a function template, candidate
6036   //   function template specializations are generated using template argument
6037   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
6038   //   candidate functions in the usual way.113) A given name can refer to one
6039   //   or more function templates and also to a set of overloaded non-template
6040   //   functions. In such a case, the candidate functions generated from each
6041   //   function template are combined with the set of non-template candidate
6042   //   functions.
6043   TemplateDeductionInfo Info(CandidateSet.getLocation());
6044   FunctionDecl *Specialization = nullptr;
6045   if (TemplateDeductionResult Result
6046       = DeduceTemplateArguments(MethodTmpl, ExplicitTemplateArgs, Args,
6047                                 Specialization, Info)) {
6048     OverloadCandidate &Candidate = CandidateSet.addCandidate();
6049     Candidate.FoundDecl = FoundDecl;
6050     Candidate.Function = MethodTmpl->getTemplatedDecl();
6051     Candidate.Viable = false;
6052     Candidate.FailureKind = ovl_fail_bad_deduction;
6053     Candidate.IsSurrogate = false;
6054     Candidate.IgnoreObjectArgument = false;
6055     Candidate.ExplicitCallArguments = Args.size();
6056     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6057                                                           Info);
6058     return;
6059   }
6060 
6061   // Add the function template specialization produced by template argument
6062   // deduction as a candidate.
6063   assert(Specialization && "Missing member function template specialization?");
6064   assert(isa<CXXMethodDecl>(Specialization) &&
6065          "Specialization is not a member function?");
6066   AddMethodCandidate(cast<CXXMethodDecl>(Specialization), FoundDecl,
6067                      ActingContext, ObjectType, ObjectClassification, Args,
6068                      CandidateSet, SuppressUserConversions);
6069 }
6070 
6071 /// \brief Add a C++ function template specialization as a candidate
6072 /// in the candidate set, using template argument deduction to produce
6073 /// an appropriate function template specialization.
6074 void
6075 Sema::AddTemplateOverloadCandidate(FunctionTemplateDecl *FunctionTemplate,
6076                                    DeclAccessPair FoundDecl,
6077                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
6078                                    ArrayRef<Expr *> Args,
6079                                    OverloadCandidateSet& CandidateSet,
6080                                    bool SuppressUserConversions) {
6081   if (!CandidateSet.isNewCandidate(FunctionTemplate))
6082     return;
6083 
6084   // C++ [over.match.funcs]p7:
6085   //   In each case where a candidate is a function template, candidate
6086   //   function template specializations are generated using template argument
6087   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
6088   //   candidate functions in the usual way.113) A given name can refer to one
6089   //   or more function templates and also to a set of overloaded non-template
6090   //   functions. In such a case, the candidate functions generated from each
6091   //   function template are combined with the set of non-template candidate
6092   //   functions.
6093   TemplateDeductionInfo Info(CandidateSet.getLocation());
6094   FunctionDecl *Specialization = nullptr;
6095   if (TemplateDeductionResult Result
6096         = DeduceTemplateArguments(FunctionTemplate, ExplicitTemplateArgs, Args,
6097                                   Specialization, Info)) {
6098     OverloadCandidate &Candidate = CandidateSet.addCandidate();
6099     Candidate.FoundDecl = FoundDecl;
6100     Candidate.Function = FunctionTemplate->getTemplatedDecl();
6101     Candidate.Viable = false;
6102     Candidate.FailureKind = ovl_fail_bad_deduction;
6103     Candidate.IsSurrogate = false;
6104     Candidate.IgnoreObjectArgument = false;
6105     Candidate.ExplicitCallArguments = Args.size();
6106     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6107                                                           Info);
6108     return;
6109   }
6110 
6111   // Add the function template specialization produced by template argument
6112   // deduction as a candidate.
6113   assert(Specialization && "Missing function template specialization?");
6114   AddOverloadCandidate(Specialization, FoundDecl, Args, CandidateSet,
6115                        SuppressUserConversions);
6116 }
6117 
6118 /// Determine whether this is an allowable conversion from the result
6119 /// of an explicit conversion operator to the expected type, per C++
6120 /// [over.match.conv]p1 and [over.match.ref]p1.
6121 ///
6122 /// \param ConvType The return type of the conversion function.
6123 ///
6124 /// \param ToType The type we are converting to.
6125 ///
6126 /// \param AllowObjCPointerConversion Allow a conversion from one
6127 /// Objective-C pointer to another.
6128 ///
6129 /// \returns true if the conversion is allowable, false otherwise.
6130 static bool isAllowableExplicitConversion(Sema &S,
6131                                           QualType ConvType, QualType ToType,
6132                                           bool AllowObjCPointerConversion) {
6133   QualType ToNonRefType = ToType.getNonReferenceType();
6134 
6135   // Easy case: the types are the same.
6136   if (S.Context.hasSameUnqualifiedType(ConvType, ToNonRefType))
6137     return true;
6138 
6139   // Allow qualification conversions.
6140   bool ObjCLifetimeConversion;
6141   if (S.IsQualificationConversion(ConvType, ToNonRefType, /*CStyle*/false,
6142                                   ObjCLifetimeConversion))
6143     return true;
6144 
6145   // If we're not allowed to consider Objective-C pointer conversions,
6146   // we're done.
6147   if (!AllowObjCPointerConversion)
6148     return false;
6149 
6150   // Is this an Objective-C pointer conversion?
6151   bool IncompatibleObjC = false;
6152   QualType ConvertedType;
6153   return S.isObjCPointerConversion(ConvType, ToNonRefType, ConvertedType,
6154                                    IncompatibleObjC);
6155 }
6156 
6157 /// AddConversionCandidate - Add a C++ conversion function as a
6158 /// candidate in the candidate set (C++ [over.match.conv],
6159 /// C++ [over.match.copy]). From is the expression we're converting from,
6160 /// and ToType is the type that we're eventually trying to convert to
6161 /// (which may or may not be the same type as the type that the
6162 /// conversion function produces).
6163 void
6164 Sema::AddConversionCandidate(CXXConversionDecl *Conversion,
6165                              DeclAccessPair FoundDecl,
6166                              CXXRecordDecl *ActingContext,
6167                              Expr *From, QualType ToType,
6168                              OverloadCandidateSet& CandidateSet,
6169                              bool AllowObjCConversionOnExplicit) {
6170   assert(!Conversion->getDescribedFunctionTemplate() &&
6171          "Conversion function templates use AddTemplateConversionCandidate");
6172   QualType ConvType = Conversion->getConversionType().getNonReferenceType();
6173   if (!CandidateSet.isNewCandidate(Conversion))
6174     return;
6175 
6176   // If the conversion function has an undeduced return type, trigger its
6177   // deduction now.
6178   if (getLangOpts().CPlusPlus14 && ConvType->isUndeducedType()) {
6179     if (DeduceReturnType(Conversion, From->getExprLoc()))
6180       return;
6181     ConvType = Conversion->getConversionType().getNonReferenceType();
6182   }
6183 
6184   // Per C++ [over.match.conv]p1, [over.match.ref]p1, an explicit conversion
6185   // operator is only a candidate if its return type is the target type or
6186   // can be converted to the target type with a qualification conversion.
6187   if (Conversion->isExplicit() &&
6188       !isAllowableExplicitConversion(*this, ConvType, ToType,
6189                                      AllowObjCConversionOnExplicit))
6190     return;
6191 
6192   // Overload resolution is always an unevaluated context.
6193   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
6194 
6195   // Add this candidate
6196   OverloadCandidate &Candidate = CandidateSet.addCandidate(1);
6197   Candidate.FoundDecl = FoundDecl;
6198   Candidate.Function = Conversion;
6199   Candidate.IsSurrogate = false;
6200   Candidate.IgnoreObjectArgument = false;
6201   Candidate.FinalConversion.setAsIdentityConversion();
6202   Candidate.FinalConversion.setFromType(ConvType);
6203   Candidate.FinalConversion.setAllToTypes(ToType);
6204   Candidate.Viable = true;
6205   Candidate.ExplicitCallArguments = 1;
6206 
6207   // C++ [over.match.funcs]p4:
6208   //   For conversion functions, the function is considered to be a member of
6209   //   the class of the implicit implied object argument for the purpose of
6210   //   defining the type of the implicit object parameter.
6211   //
6212   // Determine the implicit conversion sequence for the implicit
6213   // object parameter.
6214   QualType ImplicitParamType = From->getType();
6215   if (const PointerType *FromPtrType = ImplicitParamType->getAs<PointerType>())
6216     ImplicitParamType = FromPtrType->getPointeeType();
6217   CXXRecordDecl *ConversionContext
6218     = cast<CXXRecordDecl>(ImplicitParamType->getAs<RecordType>()->getDecl());
6219 
6220   Candidate.Conversions[0]
6221     = TryObjectArgumentInitialization(*this, From->getType(),
6222                                       From->Classify(Context),
6223                                       Conversion, ConversionContext);
6224 
6225   if (Candidate.Conversions[0].isBad()) {
6226     Candidate.Viable = false;
6227     Candidate.FailureKind = ovl_fail_bad_conversion;
6228     return;
6229   }
6230 
6231   // We won't go through a user-defined type conversion function to convert a
6232   // derived to base as such conversions are given Conversion Rank. They only
6233   // go through a copy constructor. 13.3.3.1.2-p4 [over.ics.user]
6234   QualType FromCanon
6235     = Context.getCanonicalType(From->getType().getUnqualifiedType());
6236   QualType ToCanon = Context.getCanonicalType(ToType).getUnqualifiedType();
6237   if (FromCanon == ToCanon || IsDerivedFrom(FromCanon, ToCanon)) {
6238     Candidate.Viable = false;
6239     Candidate.FailureKind = ovl_fail_trivial_conversion;
6240     return;
6241   }
6242 
6243   // To determine what the conversion from the result of calling the
6244   // conversion function to the type we're eventually trying to
6245   // convert to (ToType), we need to synthesize a call to the
6246   // conversion function and attempt copy initialization from it. This
6247   // makes sure that we get the right semantics with respect to
6248   // lvalues/rvalues and the type. Fortunately, we can allocate this
6249   // call on the stack and we don't need its arguments to be
6250   // well-formed.
6251   DeclRefExpr ConversionRef(Conversion, false, Conversion->getType(),
6252                             VK_LValue, From->getLocStart());
6253   ImplicitCastExpr ConversionFn(ImplicitCastExpr::OnStack,
6254                                 Context.getPointerType(Conversion->getType()),
6255                                 CK_FunctionToPointerDecay,
6256                                 &ConversionRef, VK_RValue);
6257 
6258   QualType ConversionType = Conversion->getConversionType();
6259   if (RequireCompleteType(From->getLocStart(), ConversionType, 0)) {
6260     Candidate.Viable = false;
6261     Candidate.FailureKind = ovl_fail_bad_final_conversion;
6262     return;
6263   }
6264 
6265   ExprValueKind VK = Expr::getValueKindForType(ConversionType);
6266 
6267   // Note that it is safe to allocate CallExpr on the stack here because
6268   // there are 0 arguments (i.e., nothing is allocated using ASTContext's
6269   // allocator).
6270   QualType CallResultType = ConversionType.getNonLValueExprType(Context);
6271   CallExpr Call(Context, &ConversionFn, None, CallResultType, VK,
6272                 From->getLocStart());
6273   ImplicitConversionSequence ICS =
6274     TryCopyInitialization(*this, &Call, ToType,
6275                           /*SuppressUserConversions=*/true,
6276                           /*InOverloadResolution=*/false,
6277                           /*AllowObjCWritebackConversion=*/false);
6278 
6279   switch (ICS.getKind()) {
6280   case ImplicitConversionSequence::StandardConversion:
6281     Candidate.FinalConversion = ICS.Standard;
6282 
6283     // C++ [over.ics.user]p3:
6284     //   If the user-defined conversion is specified by a specialization of a
6285     //   conversion function template, the second standard conversion sequence
6286     //   shall have exact match rank.
6287     if (Conversion->getPrimaryTemplate() &&
6288         GetConversionRank(ICS.Standard.Second) != ICR_Exact_Match) {
6289       Candidate.Viable = false;
6290       Candidate.FailureKind = ovl_fail_final_conversion_not_exact;
6291       return;
6292     }
6293 
6294     // C++0x [dcl.init.ref]p5:
6295     //    In the second case, if the reference is an rvalue reference and
6296     //    the second standard conversion sequence of the user-defined
6297     //    conversion sequence includes an lvalue-to-rvalue conversion, the
6298     //    program is ill-formed.
6299     if (ToType->isRValueReferenceType() &&
6300         ICS.Standard.First == ICK_Lvalue_To_Rvalue) {
6301       Candidate.Viable = false;
6302       Candidate.FailureKind = ovl_fail_bad_final_conversion;
6303       return;
6304     }
6305     break;
6306 
6307   case ImplicitConversionSequence::BadConversion:
6308     Candidate.Viable = false;
6309     Candidate.FailureKind = ovl_fail_bad_final_conversion;
6310     return;
6311 
6312   default:
6313     llvm_unreachable(
6314            "Can only end up with a standard conversion sequence or failure");
6315   }
6316 
6317   if (EnableIfAttr *FailedAttr = CheckEnableIf(Conversion, None)) {
6318     Candidate.Viable = false;
6319     Candidate.FailureKind = ovl_fail_enable_if;
6320     Candidate.DeductionFailure.Data = FailedAttr;
6321     return;
6322   }
6323 }
6324 
6325 /// \brief Adds a conversion function template specialization
6326 /// candidate to the overload set, using template argument deduction
6327 /// to deduce the template arguments of the conversion function
6328 /// template from the type that we are converting to (C++
6329 /// [temp.deduct.conv]).
6330 void
6331 Sema::AddTemplateConversionCandidate(FunctionTemplateDecl *FunctionTemplate,
6332                                      DeclAccessPair FoundDecl,
6333                                      CXXRecordDecl *ActingDC,
6334                                      Expr *From, QualType ToType,
6335                                      OverloadCandidateSet &CandidateSet,
6336                                      bool AllowObjCConversionOnExplicit) {
6337   assert(isa<CXXConversionDecl>(FunctionTemplate->getTemplatedDecl()) &&
6338          "Only conversion function templates permitted here");
6339 
6340   if (!CandidateSet.isNewCandidate(FunctionTemplate))
6341     return;
6342 
6343   TemplateDeductionInfo Info(CandidateSet.getLocation());
6344   CXXConversionDecl *Specialization = nullptr;
6345   if (TemplateDeductionResult Result
6346         = DeduceTemplateArguments(FunctionTemplate, ToType,
6347                                   Specialization, Info)) {
6348     OverloadCandidate &Candidate = CandidateSet.addCandidate();
6349     Candidate.FoundDecl = FoundDecl;
6350     Candidate.Function = FunctionTemplate->getTemplatedDecl();
6351     Candidate.Viable = false;
6352     Candidate.FailureKind = ovl_fail_bad_deduction;
6353     Candidate.IsSurrogate = false;
6354     Candidate.IgnoreObjectArgument = false;
6355     Candidate.ExplicitCallArguments = 1;
6356     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6357                                                           Info);
6358     return;
6359   }
6360 
6361   // Add the conversion function template specialization produced by
6362   // template argument deduction as a candidate.
6363   assert(Specialization && "Missing function template specialization?");
6364   AddConversionCandidate(Specialization, FoundDecl, ActingDC, From, ToType,
6365                          CandidateSet, AllowObjCConversionOnExplicit);
6366 }
6367 
6368 /// AddSurrogateCandidate - Adds a "surrogate" candidate function that
6369 /// converts the given @c Object to a function pointer via the
6370 /// conversion function @c Conversion, and then attempts to call it
6371 /// with the given arguments (C++ [over.call.object]p2-4). Proto is
6372 /// the type of function that we'll eventually be calling.
6373 void Sema::AddSurrogateCandidate(CXXConversionDecl *Conversion,
6374                                  DeclAccessPair FoundDecl,
6375                                  CXXRecordDecl *ActingContext,
6376                                  const FunctionProtoType *Proto,
6377                                  Expr *Object,
6378                                  ArrayRef<Expr *> Args,
6379                                  OverloadCandidateSet& CandidateSet) {
6380   if (!CandidateSet.isNewCandidate(Conversion))
6381     return;
6382 
6383   // Overload resolution is always an unevaluated context.
6384   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
6385 
6386   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size() + 1);
6387   Candidate.FoundDecl = FoundDecl;
6388   Candidate.Function = nullptr;
6389   Candidate.Surrogate = Conversion;
6390   Candidate.Viable = true;
6391   Candidate.IsSurrogate = true;
6392   Candidate.IgnoreObjectArgument = false;
6393   Candidate.ExplicitCallArguments = Args.size();
6394 
6395   // Determine the implicit conversion sequence for the implicit
6396   // object parameter.
6397   ImplicitConversionSequence ObjectInit
6398     = TryObjectArgumentInitialization(*this, Object->getType(),
6399                                       Object->Classify(Context),
6400                                       Conversion, ActingContext);
6401   if (ObjectInit.isBad()) {
6402     Candidate.Viable = false;
6403     Candidate.FailureKind = ovl_fail_bad_conversion;
6404     Candidate.Conversions[0] = ObjectInit;
6405     return;
6406   }
6407 
6408   // The first conversion is actually a user-defined conversion whose
6409   // first conversion is ObjectInit's standard conversion (which is
6410   // effectively a reference binding). Record it as such.
6411   Candidate.Conversions[0].setUserDefined();
6412   Candidate.Conversions[0].UserDefined.Before = ObjectInit.Standard;
6413   Candidate.Conversions[0].UserDefined.EllipsisConversion = false;
6414   Candidate.Conversions[0].UserDefined.HadMultipleCandidates = false;
6415   Candidate.Conversions[0].UserDefined.ConversionFunction = Conversion;
6416   Candidate.Conversions[0].UserDefined.FoundConversionFunction = FoundDecl;
6417   Candidate.Conversions[0].UserDefined.After
6418     = Candidate.Conversions[0].UserDefined.Before;
6419   Candidate.Conversions[0].UserDefined.After.setAsIdentityConversion();
6420 
6421   // Find the
6422   unsigned NumParams = Proto->getNumParams();
6423 
6424   // (C++ 13.3.2p2): A candidate function having fewer than m
6425   // parameters is viable only if it has an ellipsis in its parameter
6426   // list (8.3.5).
6427   if (Args.size() > NumParams && !Proto->isVariadic()) {
6428     Candidate.Viable = false;
6429     Candidate.FailureKind = ovl_fail_too_many_arguments;
6430     return;
6431   }
6432 
6433   // Function types don't have any default arguments, so just check if
6434   // we have enough arguments.
6435   if (Args.size() < NumParams) {
6436     // Not enough arguments.
6437     Candidate.Viable = false;
6438     Candidate.FailureKind = ovl_fail_too_few_arguments;
6439     return;
6440   }
6441 
6442   // Determine the implicit conversion sequences for each of the
6443   // arguments.
6444   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
6445     if (ArgIdx < NumParams) {
6446       // (C++ 13.3.2p3): for F to be a viable function, there shall
6447       // exist for each argument an implicit conversion sequence
6448       // (13.3.3.1) that converts that argument to the corresponding
6449       // parameter of F.
6450       QualType ParamType = Proto->getParamType(ArgIdx);
6451       Candidate.Conversions[ArgIdx + 1]
6452         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
6453                                 /*SuppressUserConversions=*/false,
6454                                 /*InOverloadResolution=*/false,
6455                                 /*AllowObjCWritebackConversion=*/
6456                                   getLangOpts().ObjCAutoRefCount);
6457       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
6458         Candidate.Viable = false;
6459         Candidate.FailureKind = ovl_fail_bad_conversion;
6460         return;
6461       }
6462     } else {
6463       // (C++ 13.3.2p2): For the purposes of overload resolution, any
6464       // argument for which there is no corresponding parameter is
6465       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
6466       Candidate.Conversions[ArgIdx + 1].setEllipsis();
6467     }
6468   }
6469 
6470   if (EnableIfAttr *FailedAttr = CheckEnableIf(Conversion, None)) {
6471     Candidate.Viable = false;
6472     Candidate.FailureKind = ovl_fail_enable_if;
6473     Candidate.DeductionFailure.Data = FailedAttr;
6474     return;
6475   }
6476 }
6477 
6478 /// \brief Add overload candidates for overloaded operators that are
6479 /// member functions.
6480 ///
6481 /// Add the overloaded operator candidates that are member functions
6482 /// for the operator Op that was used in an operator expression such
6483 /// as "x Op y". , Args/NumArgs provides the operator arguments, and
6484 /// CandidateSet will store the added overload candidates. (C++
6485 /// [over.match.oper]).
6486 void Sema::AddMemberOperatorCandidates(OverloadedOperatorKind Op,
6487                                        SourceLocation OpLoc,
6488                                        ArrayRef<Expr *> Args,
6489                                        OverloadCandidateSet& CandidateSet,
6490                                        SourceRange OpRange) {
6491   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
6492 
6493   // C++ [over.match.oper]p3:
6494   //   For a unary operator @ with an operand of a type whose
6495   //   cv-unqualified version is T1, and for a binary operator @ with
6496   //   a left operand of a type whose cv-unqualified version is T1 and
6497   //   a right operand of a type whose cv-unqualified version is T2,
6498   //   three sets of candidate functions, designated member
6499   //   candidates, non-member candidates and built-in candidates, are
6500   //   constructed as follows:
6501   QualType T1 = Args[0]->getType();
6502 
6503   //     -- If T1 is a complete class type or a class currently being
6504   //        defined, the set of member candidates is the result of the
6505   //        qualified lookup of T1::operator@ (13.3.1.1.1); otherwise,
6506   //        the set of member candidates is empty.
6507   if (const RecordType *T1Rec = T1->getAs<RecordType>()) {
6508     // Complete the type if it can be completed.
6509     RequireCompleteType(OpLoc, T1, 0);
6510     // If the type is neither complete nor being defined, bail out now.
6511     if (!T1Rec->getDecl()->getDefinition())
6512       return;
6513 
6514     LookupResult Operators(*this, OpName, OpLoc, LookupOrdinaryName);
6515     LookupQualifiedName(Operators, T1Rec->getDecl());
6516     Operators.suppressDiagnostics();
6517 
6518     for (LookupResult::iterator Oper = Operators.begin(),
6519                              OperEnd = Operators.end();
6520          Oper != OperEnd;
6521          ++Oper)
6522       AddMethodCandidate(Oper.getPair(), Args[0]->getType(),
6523                          Args[0]->Classify(Context),
6524                          Args.slice(1),
6525                          CandidateSet,
6526                          /* SuppressUserConversions = */ false);
6527   }
6528 }
6529 
6530 /// AddBuiltinCandidate - Add a candidate for a built-in
6531 /// operator. ResultTy and ParamTys are the result and parameter types
6532 /// of the built-in candidate, respectively. Args and NumArgs are the
6533 /// arguments being passed to the candidate. IsAssignmentOperator
6534 /// should be true when this built-in candidate is an assignment
6535 /// operator. NumContextualBoolArguments is the number of arguments
6536 /// (at the beginning of the argument list) that will be contextually
6537 /// converted to bool.
6538 void Sema::AddBuiltinCandidate(QualType ResultTy, QualType *ParamTys,
6539                                ArrayRef<Expr *> Args,
6540                                OverloadCandidateSet& CandidateSet,
6541                                bool IsAssignmentOperator,
6542                                unsigned NumContextualBoolArguments) {
6543   // Overload resolution is always an unevaluated context.
6544   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
6545 
6546   // Add this candidate
6547   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size());
6548   Candidate.FoundDecl = DeclAccessPair::make(nullptr, AS_none);
6549   Candidate.Function = nullptr;
6550   Candidate.IsSurrogate = false;
6551   Candidate.IgnoreObjectArgument = false;
6552   Candidate.BuiltinTypes.ResultTy = ResultTy;
6553   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx)
6554     Candidate.BuiltinTypes.ParamTypes[ArgIdx] = ParamTys[ArgIdx];
6555 
6556   // Determine the implicit conversion sequences for each of the
6557   // arguments.
6558   Candidate.Viable = true;
6559   Candidate.ExplicitCallArguments = Args.size();
6560   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
6561     // C++ [over.match.oper]p4:
6562     //   For the built-in assignment operators, conversions of the
6563     //   left operand are restricted as follows:
6564     //     -- no temporaries are introduced to hold the left operand, and
6565     //     -- no user-defined conversions are applied to the left
6566     //        operand to achieve a type match with the left-most
6567     //        parameter of a built-in candidate.
6568     //
6569     // We block these conversions by turning off user-defined
6570     // conversions, since that is the only way that initialization of
6571     // a reference to a non-class type can occur from something that
6572     // is not of the same type.
6573     if (ArgIdx < NumContextualBoolArguments) {
6574       assert(ParamTys[ArgIdx] == Context.BoolTy &&
6575              "Contextual conversion to bool requires bool type");
6576       Candidate.Conversions[ArgIdx]
6577         = TryContextuallyConvertToBool(*this, Args[ArgIdx]);
6578     } else {
6579       Candidate.Conversions[ArgIdx]
6580         = TryCopyInitialization(*this, Args[ArgIdx], ParamTys[ArgIdx],
6581                                 ArgIdx == 0 && IsAssignmentOperator,
6582                                 /*InOverloadResolution=*/false,
6583                                 /*AllowObjCWritebackConversion=*/
6584                                   getLangOpts().ObjCAutoRefCount);
6585     }
6586     if (Candidate.Conversions[ArgIdx].isBad()) {
6587       Candidate.Viable = false;
6588       Candidate.FailureKind = ovl_fail_bad_conversion;
6589       break;
6590     }
6591   }
6592 }
6593 
6594 namespace {
6595 
6596 /// BuiltinCandidateTypeSet - A set of types that will be used for the
6597 /// candidate operator functions for built-in operators (C++
6598 /// [over.built]). The types are separated into pointer types and
6599 /// enumeration types.
6600 class BuiltinCandidateTypeSet  {
6601   /// TypeSet - A set of types.
6602   typedef llvm::SmallPtrSet<QualType, 8> TypeSet;
6603 
6604   /// PointerTypes - The set of pointer types that will be used in the
6605   /// built-in candidates.
6606   TypeSet PointerTypes;
6607 
6608   /// MemberPointerTypes - The set of member pointer types that will be
6609   /// used in the built-in candidates.
6610   TypeSet MemberPointerTypes;
6611 
6612   /// EnumerationTypes - The set of enumeration types that will be
6613   /// used in the built-in candidates.
6614   TypeSet EnumerationTypes;
6615 
6616   /// \brief The set of vector types that will be used in the built-in
6617   /// candidates.
6618   TypeSet VectorTypes;
6619 
6620   /// \brief A flag indicating non-record types are viable candidates
6621   bool HasNonRecordTypes;
6622 
6623   /// \brief A flag indicating whether either arithmetic or enumeration types
6624   /// were present in the candidate set.
6625   bool HasArithmeticOrEnumeralTypes;
6626 
6627   /// \brief A flag indicating whether the nullptr type was present in the
6628   /// candidate set.
6629   bool HasNullPtrType;
6630 
6631   /// Sema - The semantic analysis instance where we are building the
6632   /// candidate type set.
6633   Sema &SemaRef;
6634 
6635   /// Context - The AST context in which we will build the type sets.
6636   ASTContext &Context;
6637 
6638   bool AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
6639                                                const Qualifiers &VisibleQuals);
6640   bool AddMemberPointerWithMoreQualifiedTypeVariants(QualType Ty);
6641 
6642 public:
6643   /// iterator - Iterates through the types that are part of the set.
6644   typedef TypeSet::iterator iterator;
6645 
6646   BuiltinCandidateTypeSet(Sema &SemaRef)
6647     : HasNonRecordTypes(false),
6648       HasArithmeticOrEnumeralTypes(false),
6649       HasNullPtrType(false),
6650       SemaRef(SemaRef),
6651       Context(SemaRef.Context) { }
6652 
6653   void AddTypesConvertedFrom(QualType Ty,
6654                              SourceLocation Loc,
6655                              bool AllowUserConversions,
6656                              bool AllowExplicitConversions,
6657                              const Qualifiers &VisibleTypeConversionsQuals);
6658 
6659   /// pointer_begin - First pointer type found;
6660   iterator pointer_begin() { return PointerTypes.begin(); }
6661 
6662   /// pointer_end - Past the last pointer type found;
6663   iterator pointer_end() { return PointerTypes.end(); }
6664 
6665   /// member_pointer_begin - First member pointer type found;
6666   iterator member_pointer_begin() { return MemberPointerTypes.begin(); }
6667 
6668   /// member_pointer_end - Past the last member pointer type found;
6669   iterator member_pointer_end() { return MemberPointerTypes.end(); }
6670 
6671   /// enumeration_begin - First enumeration type found;
6672   iterator enumeration_begin() { return EnumerationTypes.begin(); }
6673 
6674   /// enumeration_end - Past the last enumeration type found;
6675   iterator enumeration_end() { return EnumerationTypes.end(); }
6676 
6677   iterator vector_begin() { return VectorTypes.begin(); }
6678   iterator vector_end() { return VectorTypes.end(); }
6679 
6680   bool hasNonRecordTypes() { return HasNonRecordTypes; }
6681   bool hasArithmeticOrEnumeralTypes() { return HasArithmeticOrEnumeralTypes; }
6682   bool hasNullPtrType() const { return HasNullPtrType; }
6683 };
6684 
6685 } // end anonymous namespace
6686 
6687 /// AddPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty to
6688 /// the set of pointer types along with any more-qualified variants of
6689 /// that type. For example, if @p Ty is "int const *", this routine
6690 /// will add "int const *", "int const volatile *", "int const
6691 /// restrict *", and "int const volatile restrict *" to the set of
6692 /// pointer types. Returns true if the add of @p Ty itself succeeded,
6693 /// false otherwise.
6694 ///
6695 /// FIXME: what to do about extended qualifiers?
6696 bool
6697 BuiltinCandidateTypeSet::AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
6698                                              const Qualifiers &VisibleQuals) {
6699 
6700   // Insert this type.
6701   if (!PointerTypes.insert(Ty))
6702     return false;
6703 
6704   QualType PointeeTy;
6705   const PointerType *PointerTy = Ty->getAs<PointerType>();
6706   bool buildObjCPtr = false;
6707   if (!PointerTy) {
6708     const ObjCObjectPointerType *PTy = Ty->castAs<ObjCObjectPointerType>();
6709     PointeeTy = PTy->getPointeeType();
6710     buildObjCPtr = true;
6711   } else {
6712     PointeeTy = PointerTy->getPointeeType();
6713   }
6714 
6715   // Don't add qualified variants of arrays. For one, they're not allowed
6716   // (the qualifier would sink to the element type), and for another, the
6717   // only overload situation where it matters is subscript or pointer +- int,
6718   // and those shouldn't have qualifier variants anyway.
6719   if (PointeeTy->isArrayType())
6720     return true;
6721 
6722   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
6723   bool hasVolatile = VisibleQuals.hasVolatile();
6724   bool hasRestrict = VisibleQuals.hasRestrict();
6725 
6726   // Iterate through all strict supersets of BaseCVR.
6727   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
6728     if ((CVR | BaseCVR) != CVR) continue;
6729     // Skip over volatile if no volatile found anywhere in the types.
6730     if ((CVR & Qualifiers::Volatile) && !hasVolatile) continue;
6731 
6732     // Skip over restrict if no restrict found anywhere in the types, or if
6733     // the type cannot be restrict-qualified.
6734     if ((CVR & Qualifiers::Restrict) &&
6735         (!hasRestrict ||
6736          (!(PointeeTy->isAnyPointerType() || PointeeTy->isReferenceType()))))
6737       continue;
6738 
6739     // Build qualified pointee type.
6740     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
6741 
6742     // Build qualified pointer type.
6743     QualType QPointerTy;
6744     if (!buildObjCPtr)
6745       QPointerTy = Context.getPointerType(QPointeeTy);
6746     else
6747       QPointerTy = Context.getObjCObjectPointerType(QPointeeTy);
6748 
6749     // Insert qualified pointer type.
6750     PointerTypes.insert(QPointerTy);
6751   }
6752 
6753   return true;
6754 }
6755 
6756 /// AddMemberPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty
6757 /// to the set of pointer types along with any more-qualified variants of
6758 /// that type. For example, if @p Ty is "int const *", this routine
6759 /// will add "int const *", "int const volatile *", "int const
6760 /// restrict *", and "int const volatile restrict *" to the set of
6761 /// pointer types. Returns true if the add of @p Ty itself succeeded,
6762 /// false otherwise.
6763 ///
6764 /// FIXME: what to do about extended qualifiers?
6765 bool
6766 BuiltinCandidateTypeSet::AddMemberPointerWithMoreQualifiedTypeVariants(
6767     QualType Ty) {
6768   // Insert this type.
6769   if (!MemberPointerTypes.insert(Ty))
6770     return false;
6771 
6772   const MemberPointerType *PointerTy = Ty->getAs<MemberPointerType>();
6773   assert(PointerTy && "type was not a member pointer type!");
6774 
6775   QualType PointeeTy = PointerTy->getPointeeType();
6776   // Don't add qualified variants of arrays. For one, they're not allowed
6777   // (the qualifier would sink to the element type), and for another, the
6778   // only overload situation where it matters is subscript or pointer +- int,
6779   // and those shouldn't have qualifier variants anyway.
6780   if (PointeeTy->isArrayType())
6781     return true;
6782   const Type *ClassTy = PointerTy->getClass();
6783 
6784   // Iterate through all strict supersets of the pointee type's CVR
6785   // qualifiers.
6786   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
6787   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
6788     if ((CVR | BaseCVR) != CVR) continue;
6789 
6790     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
6791     MemberPointerTypes.insert(
6792       Context.getMemberPointerType(QPointeeTy, ClassTy));
6793   }
6794 
6795   return true;
6796 }
6797 
6798 /// AddTypesConvertedFrom - Add each of the types to which the type @p
6799 /// Ty can be implicit converted to the given set of @p Types. We're
6800 /// primarily interested in pointer types and enumeration types. We also
6801 /// take member pointer types, for the conditional operator.
6802 /// AllowUserConversions is true if we should look at the conversion
6803 /// functions of a class type, and AllowExplicitConversions if we
6804 /// should also include the explicit conversion functions of a class
6805 /// type.
6806 void
6807 BuiltinCandidateTypeSet::AddTypesConvertedFrom(QualType Ty,
6808                                                SourceLocation Loc,
6809                                                bool AllowUserConversions,
6810                                                bool AllowExplicitConversions,
6811                                                const Qualifiers &VisibleQuals) {
6812   // Only deal with canonical types.
6813   Ty = Context.getCanonicalType(Ty);
6814 
6815   // Look through reference types; they aren't part of the type of an
6816   // expression for the purposes of conversions.
6817   if (const ReferenceType *RefTy = Ty->getAs<ReferenceType>())
6818     Ty = RefTy->getPointeeType();
6819 
6820   // If we're dealing with an array type, decay to the pointer.
6821   if (Ty->isArrayType())
6822     Ty = SemaRef.Context.getArrayDecayedType(Ty);
6823 
6824   // Otherwise, we don't care about qualifiers on the type.
6825   Ty = Ty.getLocalUnqualifiedType();
6826 
6827   // Flag if we ever add a non-record type.
6828   const RecordType *TyRec = Ty->getAs<RecordType>();
6829   HasNonRecordTypes = HasNonRecordTypes || !TyRec;
6830 
6831   // Flag if we encounter an arithmetic type.
6832   HasArithmeticOrEnumeralTypes =
6833     HasArithmeticOrEnumeralTypes || Ty->isArithmeticType();
6834 
6835   if (Ty->isObjCIdType() || Ty->isObjCClassType())
6836     PointerTypes.insert(Ty);
6837   else if (Ty->getAs<PointerType>() || Ty->getAs<ObjCObjectPointerType>()) {
6838     // Insert our type, and its more-qualified variants, into the set
6839     // of types.
6840     if (!AddPointerWithMoreQualifiedTypeVariants(Ty, VisibleQuals))
6841       return;
6842   } else if (Ty->isMemberPointerType()) {
6843     // Member pointers are far easier, since the pointee can't be converted.
6844     if (!AddMemberPointerWithMoreQualifiedTypeVariants(Ty))
6845       return;
6846   } else if (Ty->isEnumeralType()) {
6847     HasArithmeticOrEnumeralTypes = true;
6848     EnumerationTypes.insert(Ty);
6849   } else if (Ty->isVectorType()) {
6850     // We treat vector types as arithmetic types in many contexts as an
6851     // extension.
6852     HasArithmeticOrEnumeralTypes = true;
6853     VectorTypes.insert(Ty);
6854   } else if (Ty->isNullPtrType()) {
6855     HasNullPtrType = true;
6856   } else if (AllowUserConversions && TyRec) {
6857     // No conversion functions in incomplete types.
6858     if (SemaRef.RequireCompleteType(Loc, Ty, 0))
6859       return;
6860 
6861     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
6862     std::pair<CXXRecordDecl::conversion_iterator,
6863               CXXRecordDecl::conversion_iterator>
6864       Conversions = ClassDecl->getVisibleConversionFunctions();
6865     for (CXXRecordDecl::conversion_iterator
6866            I = Conversions.first, E = Conversions.second; I != E; ++I) {
6867       NamedDecl *D = I.getDecl();
6868       if (isa<UsingShadowDecl>(D))
6869         D = cast<UsingShadowDecl>(D)->getTargetDecl();
6870 
6871       // Skip conversion function templates; they don't tell us anything
6872       // about which builtin types we can convert to.
6873       if (isa<FunctionTemplateDecl>(D))
6874         continue;
6875 
6876       CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
6877       if (AllowExplicitConversions || !Conv->isExplicit()) {
6878         AddTypesConvertedFrom(Conv->getConversionType(), Loc, false, false,
6879                               VisibleQuals);
6880       }
6881     }
6882   }
6883 }
6884 
6885 /// \brief Helper function for AddBuiltinOperatorCandidates() that adds
6886 /// the volatile- and non-volatile-qualified assignment operators for the
6887 /// given type to the candidate set.
6888 static void AddBuiltinAssignmentOperatorCandidates(Sema &S,
6889                                                    QualType T,
6890                                                    ArrayRef<Expr *> Args,
6891                                     OverloadCandidateSet &CandidateSet) {
6892   QualType ParamTypes[2];
6893 
6894   // T& operator=(T&, T)
6895   ParamTypes[0] = S.Context.getLValueReferenceType(T);
6896   ParamTypes[1] = T;
6897   S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
6898                         /*IsAssignmentOperator=*/true);
6899 
6900   if (!S.Context.getCanonicalType(T).isVolatileQualified()) {
6901     // volatile T& operator=(volatile T&, T)
6902     ParamTypes[0]
6903       = S.Context.getLValueReferenceType(S.Context.getVolatileType(T));
6904     ParamTypes[1] = T;
6905     S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
6906                           /*IsAssignmentOperator=*/true);
6907   }
6908 }
6909 
6910 /// CollectVRQualifiers - This routine returns Volatile/Restrict qualifiers,
6911 /// if any, found in visible type conversion functions found in ArgExpr's type.
6912 static  Qualifiers CollectVRQualifiers(ASTContext &Context, Expr* ArgExpr) {
6913     Qualifiers VRQuals;
6914     const RecordType *TyRec;
6915     if (const MemberPointerType *RHSMPType =
6916         ArgExpr->getType()->getAs<MemberPointerType>())
6917       TyRec = RHSMPType->getClass()->getAs<RecordType>();
6918     else
6919       TyRec = ArgExpr->getType()->getAs<RecordType>();
6920     if (!TyRec) {
6921       // Just to be safe, assume the worst case.
6922       VRQuals.addVolatile();
6923       VRQuals.addRestrict();
6924       return VRQuals;
6925     }
6926 
6927     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
6928     if (!ClassDecl->hasDefinition())
6929       return VRQuals;
6930 
6931     std::pair<CXXRecordDecl::conversion_iterator,
6932               CXXRecordDecl::conversion_iterator>
6933       Conversions = ClassDecl->getVisibleConversionFunctions();
6934 
6935     for (CXXRecordDecl::conversion_iterator
6936            I = Conversions.first, E = Conversions.second; I != E; ++I) {
6937       NamedDecl *D = I.getDecl();
6938       if (isa<UsingShadowDecl>(D))
6939         D = cast<UsingShadowDecl>(D)->getTargetDecl();
6940       if (CXXConversionDecl *Conv = dyn_cast<CXXConversionDecl>(D)) {
6941         QualType CanTy = Context.getCanonicalType(Conv->getConversionType());
6942         if (const ReferenceType *ResTypeRef = CanTy->getAs<ReferenceType>())
6943           CanTy = ResTypeRef->getPointeeType();
6944         // Need to go down the pointer/mempointer chain and add qualifiers
6945         // as see them.
6946         bool done = false;
6947         while (!done) {
6948           if (CanTy.isRestrictQualified())
6949             VRQuals.addRestrict();
6950           if (const PointerType *ResTypePtr = CanTy->getAs<PointerType>())
6951             CanTy = ResTypePtr->getPointeeType();
6952           else if (const MemberPointerType *ResTypeMPtr =
6953                 CanTy->getAs<MemberPointerType>())
6954             CanTy = ResTypeMPtr->getPointeeType();
6955           else
6956             done = true;
6957           if (CanTy.isVolatileQualified())
6958             VRQuals.addVolatile();
6959           if (VRQuals.hasRestrict() && VRQuals.hasVolatile())
6960             return VRQuals;
6961         }
6962       }
6963     }
6964     return VRQuals;
6965 }
6966 
6967 namespace {
6968 
6969 /// \brief Helper class to manage the addition of builtin operator overload
6970 /// candidates. It provides shared state and utility methods used throughout
6971 /// the process, as well as a helper method to add each group of builtin
6972 /// operator overloads from the standard to a candidate set.
6973 class BuiltinOperatorOverloadBuilder {
6974   // Common instance state available to all overload candidate addition methods.
6975   Sema &S;
6976   ArrayRef<Expr *> Args;
6977   Qualifiers VisibleTypeConversionsQuals;
6978   bool HasArithmeticOrEnumeralCandidateType;
6979   SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes;
6980   OverloadCandidateSet &CandidateSet;
6981 
6982   // Define some constants used to index and iterate over the arithemetic types
6983   // provided via the getArithmeticType() method below.
6984   // The "promoted arithmetic types" are the arithmetic
6985   // types are that preserved by promotion (C++ [over.built]p2).
6986   static const unsigned FirstIntegralType = 3;
6987   static const unsigned LastIntegralType = 20;
6988   static const unsigned FirstPromotedIntegralType = 3,
6989                         LastPromotedIntegralType = 11;
6990   static const unsigned FirstPromotedArithmeticType = 0,
6991                         LastPromotedArithmeticType = 11;
6992   static const unsigned NumArithmeticTypes = 20;
6993 
6994   /// \brief Get the canonical type for a given arithmetic type index.
6995   CanQualType getArithmeticType(unsigned index) {
6996     assert(index < NumArithmeticTypes);
6997     static CanQualType ASTContext::* const
6998       ArithmeticTypes[NumArithmeticTypes] = {
6999       // Start of promoted types.
7000       &ASTContext::FloatTy,
7001       &ASTContext::DoubleTy,
7002       &ASTContext::LongDoubleTy,
7003 
7004       // Start of integral types.
7005       &ASTContext::IntTy,
7006       &ASTContext::LongTy,
7007       &ASTContext::LongLongTy,
7008       &ASTContext::Int128Ty,
7009       &ASTContext::UnsignedIntTy,
7010       &ASTContext::UnsignedLongTy,
7011       &ASTContext::UnsignedLongLongTy,
7012       &ASTContext::UnsignedInt128Ty,
7013       // End of promoted types.
7014 
7015       &ASTContext::BoolTy,
7016       &ASTContext::CharTy,
7017       &ASTContext::WCharTy,
7018       &ASTContext::Char16Ty,
7019       &ASTContext::Char32Ty,
7020       &ASTContext::SignedCharTy,
7021       &ASTContext::ShortTy,
7022       &ASTContext::UnsignedCharTy,
7023       &ASTContext::UnsignedShortTy,
7024       // End of integral types.
7025       // FIXME: What about complex? What about half?
7026     };
7027     return S.Context.*ArithmeticTypes[index];
7028   }
7029 
7030   /// \brief Gets the canonical type resulting from the usual arithemetic
7031   /// converions for the given arithmetic types.
7032   CanQualType getUsualArithmeticConversions(unsigned L, unsigned R) {
7033     // Accelerator table for performing the usual arithmetic conversions.
7034     // The rules are basically:
7035     //   - if either is floating-point, use the wider floating-point
7036     //   - if same signedness, use the higher rank
7037     //   - if same size, use unsigned of the higher rank
7038     //   - use the larger type
7039     // These rules, together with the axiom that higher ranks are
7040     // never smaller, are sufficient to precompute all of these results
7041     // *except* when dealing with signed types of higher rank.
7042     // (we could precompute SLL x UI for all known platforms, but it's
7043     // better not to make any assumptions).
7044     // We assume that int128 has a higher rank than long long on all platforms.
7045     enum PromotedType {
7046             Dep=-1,
7047             Flt,  Dbl, LDbl,   SI,   SL,  SLL, S128,   UI,   UL,  ULL, U128
7048     };
7049     static const PromotedType ConversionsTable[LastPromotedArithmeticType]
7050                                         [LastPromotedArithmeticType] = {
7051 /* Flt*/ {  Flt,  Dbl, LDbl,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt },
7052 /* Dbl*/ {  Dbl,  Dbl, LDbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl },
7053 /*LDbl*/ { LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl },
7054 /*  SI*/ {  Flt,  Dbl, LDbl,   SI,   SL,  SLL, S128,   UI,   UL,  ULL, U128 },
7055 /*  SL*/ {  Flt,  Dbl, LDbl,   SL,   SL,  SLL, S128,  Dep,   UL,  ULL, U128 },
7056 /* SLL*/ {  Flt,  Dbl, LDbl,  SLL,  SLL,  SLL, S128,  Dep,  Dep,  ULL, U128 },
7057 /*S128*/ {  Flt,  Dbl, LDbl, S128, S128, S128, S128, S128, S128, S128, U128 },
7058 /*  UI*/ {  Flt,  Dbl, LDbl,   UI,  Dep,  Dep, S128,   UI,   UL,  ULL, U128 },
7059 /*  UL*/ {  Flt,  Dbl, LDbl,   UL,   UL,  Dep, S128,   UL,   UL,  ULL, U128 },
7060 /* ULL*/ {  Flt,  Dbl, LDbl,  ULL,  ULL,  ULL, S128,  ULL,  ULL,  ULL, U128 },
7061 /*U128*/ {  Flt,  Dbl, LDbl, U128, U128, U128, U128, U128, U128, U128, U128 },
7062     };
7063 
7064     assert(L < LastPromotedArithmeticType);
7065     assert(R < LastPromotedArithmeticType);
7066     int Idx = ConversionsTable[L][R];
7067 
7068     // Fast path: the table gives us a concrete answer.
7069     if (Idx != Dep) return getArithmeticType(Idx);
7070 
7071     // Slow path: we need to compare widths.
7072     // An invariant is that the signed type has higher rank.
7073     CanQualType LT = getArithmeticType(L),
7074                 RT = getArithmeticType(R);
7075     unsigned LW = S.Context.getIntWidth(LT),
7076              RW = S.Context.getIntWidth(RT);
7077 
7078     // If they're different widths, use the signed type.
7079     if (LW > RW) return LT;
7080     else if (LW < RW) return RT;
7081 
7082     // Otherwise, use the unsigned type of the signed type's rank.
7083     if (L == SL || R == SL) return S.Context.UnsignedLongTy;
7084     assert(L == SLL || R == SLL);
7085     return S.Context.UnsignedLongLongTy;
7086   }
7087 
7088   /// \brief Helper method to factor out the common pattern of adding overloads
7089   /// for '++' and '--' builtin operators.
7090   void addPlusPlusMinusMinusStyleOverloads(QualType CandidateTy,
7091                                            bool HasVolatile,
7092                                            bool HasRestrict) {
7093     QualType ParamTypes[2] = {
7094       S.Context.getLValueReferenceType(CandidateTy),
7095       S.Context.IntTy
7096     };
7097 
7098     // Non-volatile version.
7099     if (Args.size() == 1)
7100       S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7101     else
7102       S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
7103 
7104     // Use a heuristic to reduce number of builtin candidates in the set:
7105     // add volatile version only if there are conversions to a volatile type.
7106     if (HasVolatile) {
7107       ParamTypes[0] =
7108         S.Context.getLValueReferenceType(
7109           S.Context.getVolatileType(CandidateTy));
7110       if (Args.size() == 1)
7111         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7112       else
7113         S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
7114     }
7115 
7116     // Add restrict version only if there are conversions to a restrict type
7117     // and our candidate type is a non-restrict-qualified pointer.
7118     if (HasRestrict && CandidateTy->isAnyPointerType() &&
7119         !CandidateTy.isRestrictQualified()) {
7120       ParamTypes[0]
7121         = S.Context.getLValueReferenceType(
7122             S.Context.getCVRQualifiedType(CandidateTy, Qualifiers::Restrict));
7123       if (Args.size() == 1)
7124         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7125       else
7126         S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
7127 
7128       if (HasVolatile) {
7129         ParamTypes[0]
7130           = S.Context.getLValueReferenceType(
7131               S.Context.getCVRQualifiedType(CandidateTy,
7132                                             (Qualifiers::Volatile |
7133                                              Qualifiers::Restrict)));
7134         if (Args.size() == 1)
7135           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7136         else
7137           S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
7138       }
7139     }
7140 
7141   }
7142 
7143 public:
7144   BuiltinOperatorOverloadBuilder(
7145     Sema &S, ArrayRef<Expr *> Args,
7146     Qualifiers VisibleTypeConversionsQuals,
7147     bool HasArithmeticOrEnumeralCandidateType,
7148     SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes,
7149     OverloadCandidateSet &CandidateSet)
7150     : S(S), Args(Args),
7151       VisibleTypeConversionsQuals(VisibleTypeConversionsQuals),
7152       HasArithmeticOrEnumeralCandidateType(
7153         HasArithmeticOrEnumeralCandidateType),
7154       CandidateTypes(CandidateTypes),
7155       CandidateSet(CandidateSet) {
7156     // Validate some of our static helper constants in debug builds.
7157     assert(getArithmeticType(FirstPromotedIntegralType) == S.Context.IntTy &&
7158            "Invalid first promoted integral type");
7159     assert(getArithmeticType(LastPromotedIntegralType - 1)
7160              == S.Context.UnsignedInt128Ty &&
7161            "Invalid last promoted integral type");
7162     assert(getArithmeticType(FirstPromotedArithmeticType)
7163              == S.Context.FloatTy &&
7164            "Invalid first promoted arithmetic type");
7165     assert(getArithmeticType(LastPromotedArithmeticType - 1)
7166              == S.Context.UnsignedInt128Ty &&
7167            "Invalid last promoted arithmetic type");
7168   }
7169 
7170   // C++ [over.built]p3:
7171   //
7172   //   For every pair (T, VQ), where T is an arithmetic type, and VQ
7173   //   is either volatile or empty, there exist candidate operator
7174   //   functions of the form
7175   //
7176   //       VQ T&      operator++(VQ T&);
7177   //       T          operator++(VQ T&, int);
7178   //
7179   // C++ [over.built]p4:
7180   //
7181   //   For every pair (T, VQ), where T is an arithmetic type other
7182   //   than bool, and VQ is either volatile or empty, there exist
7183   //   candidate operator functions of the form
7184   //
7185   //       VQ T&      operator--(VQ T&);
7186   //       T          operator--(VQ T&, int);
7187   void addPlusPlusMinusMinusArithmeticOverloads(OverloadedOperatorKind Op) {
7188     if (!HasArithmeticOrEnumeralCandidateType)
7189       return;
7190 
7191     for (unsigned Arith = (Op == OO_PlusPlus? 0 : 1);
7192          Arith < NumArithmeticTypes; ++Arith) {
7193       addPlusPlusMinusMinusStyleOverloads(
7194         getArithmeticType(Arith),
7195         VisibleTypeConversionsQuals.hasVolatile(),
7196         VisibleTypeConversionsQuals.hasRestrict());
7197     }
7198   }
7199 
7200   // C++ [over.built]p5:
7201   //
7202   //   For every pair (T, VQ), where T is a cv-qualified or
7203   //   cv-unqualified object type, and VQ is either volatile or
7204   //   empty, there exist candidate operator functions of the form
7205   //
7206   //       T*VQ&      operator++(T*VQ&);
7207   //       T*VQ&      operator--(T*VQ&);
7208   //       T*         operator++(T*VQ&, int);
7209   //       T*         operator--(T*VQ&, int);
7210   void addPlusPlusMinusMinusPointerOverloads() {
7211     for (BuiltinCandidateTypeSet::iterator
7212               Ptr = CandidateTypes[0].pointer_begin(),
7213            PtrEnd = CandidateTypes[0].pointer_end();
7214          Ptr != PtrEnd; ++Ptr) {
7215       // Skip pointer types that aren't pointers to object types.
7216       if (!(*Ptr)->getPointeeType()->isObjectType())
7217         continue;
7218 
7219       addPlusPlusMinusMinusStyleOverloads(*Ptr,
7220         (!(*Ptr).isVolatileQualified() &&
7221          VisibleTypeConversionsQuals.hasVolatile()),
7222         (!(*Ptr).isRestrictQualified() &&
7223          VisibleTypeConversionsQuals.hasRestrict()));
7224     }
7225   }
7226 
7227   // C++ [over.built]p6:
7228   //   For every cv-qualified or cv-unqualified object type T, there
7229   //   exist candidate operator functions of the form
7230   //
7231   //       T&         operator*(T*);
7232   //
7233   // C++ [over.built]p7:
7234   //   For every function type T that does not have cv-qualifiers or a
7235   //   ref-qualifier, there exist candidate operator functions of the form
7236   //       T&         operator*(T*);
7237   void addUnaryStarPointerOverloads() {
7238     for (BuiltinCandidateTypeSet::iterator
7239               Ptr = CandidateTypes[0].pointer_begin(),
7240            PtrEnd = CandidateTypes[0].pointer_end();
7241          Ptr != PtrEnd; ++Ptr) {
7242       QualType ParamTy = *Ptr;
7243       QualType PointeeTy = ParamTy->getPointeeType();
7244       if (!PointeeTy->isObjectType() && !PointeeTy->isFunctionType())
7245         continue;
7246 
7247       if (const FunctionProtoType *Proto =PointeeTy->getAs<FunctionProtoType>())
7248         if (Proto->getTypeQuals() || Proto->getRefQualifier())
7249           continue;
7250 
7251       S.AddBuiltinCandidate(S.Context.getLValueReferenceType(PointeeTy),
7252                             &ParamTy, Args, CandidateSet);
7253     }
7254   }
7255 
7256   // C++ [over.built]p9:
7257   //  For every promoted arithmetic type T, there exist candidate
7258   //  operator functions of the form
7259   //
7260   //       T         operator+(T);
7261   //       T         operator-(T);
7262   void addUnaryPlusOrMinusArithmeticOverloads() {
7263     if (!HasArithmeticOrEnumeralCandidateType)
7264       return;
7265 
7266     for (unsigned Arith = FirstPromotedArithmeticType;
7267          Arith < LastPromotedArithmeticType; ++Arith) {
7268       QualType ArithTy = getArithmeticType(Arith);
7269       S.AddBuiltinCandidate(ArithTy, &ArithTy, Args, CandidateSet);
7270     }
7271 
7272     // Extension: We also add these operators for vector types.
7273     for (BuiltinCandidateTypeSet::iterator
7274               Vec = CandidateTypes[0].vector_begin(),
7275            VecEnd = CandidateTypes[0].vector_end();
7276          Vec != VecEnd; ++Vec) {
7277       QualType VecTy = *Vec;
7278       S.AddBuiltinCandidate(VecTy, &VecTy, Args, CandidateSet);
7279     }
7280   }
7281 
7282   // C++ [over.built]p8:
7283   //   For every type T, there exist candidate operator functions of
7284   //   the form
7285   //
7286   //       T*         operator+(T*);
7287   void addUnaryPlusPointerOverloads() {
7288     for (BuiltinCandidateTypeSet::iterator
7289               Ptr = CandidateTypes[0].pointer_begin(),
7290            PtrEnd = CandidateTypes[0].pointer_end();
7291          Ptr != PtrEnd; ++Ptr) {
7292       QualType ParamTy = *Ptr;
7293       S.AddBuiltinCandidate(ParamTy, &ParamTy, Args, CandidateSet);
7294     }
7295   }
7296 
7297   // C++ [over.built]p10:
7298   //   For every promoted integral type T, there exist candidate
7299   //   operator functions of the form
7300   //
7301   //        T         operator~(T);
7302   void addUnaryTildePromotedIntegralOverloads() {
7303     if (!HasArithmeticOrEnumeralCandidateType)
7304       return;
7305 
7306     for (unsigned Int = FirstPromotedIntegralType;
7307          Int < LastPromotedIntegralType; ++Int) {
7308       QualType IntTy = getArithmeticType(Int);
7309       S.AddBuiltinCandidate(IntTy, &IntTy, Args, CandidateSet);
7310     }
7311 
7312     // Extension: We also add this operator for vector types.
7313     for (BuiltinCandidateTypeSet::iterator
7314               Vec = CandidateTypes[0].vector_begin(),
7315            VecEnd = CandidateTypes[0].vector_end();
7316          Vec != VecEnd; ++Vec) {
7317       QualType VecTy = *Vec;
7318       S.AddBuiltinCandidate(VecTy, &VecTy, Args, CandidateSet);
7319     }
7320   }
7321 
7322   // C++ [over.match.oper]p16:
7323   //   For every pointer to member type T, there exist candidate operator
7324   //   functions of the form
7325   //
7326   //        bool operator==(T,T);
7327   //        bool operator!=(T,T);
7328   void addEqualEqualOrNotEqualMemberPointerOverloads() {
7329     /// Set of (canonical) types that we've already handled.
7330     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7331 
7332     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7333       for (BuiltinCandidateTypeSet::iterator
7334                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
7335              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
7336            MemPtr != MemPtrEnd;
7337            ++MemPtr) {
7338         // Don't add the same builtin candidate twice.
7339         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
7340           continue;
7341 
7342         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
7343         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
7344       }
7345     }
7346   }
7347 
7348   // C++ [over.built]p15:
7349   //
7350   //   For every T, where T is an enumeration type, a pointer type, or
7351   //   std::nullptr_t, there exist candidate operator functions of the form
7352   //
7353   //        bool       operator<(T, T);
7354   //        bool       operator>(T, T);
7355   //        bool       operator<=(T, T);
7356   //        bool       operator>=(T, T);
7357   //        bool       operator==(T, T);
7358   //        bool       operator!=(T, T);
7359   void addRelationalPointerOrEnumeralOverloads() {
7360     // C++ [over.match.oper]p3:
7361     //   [...]the built-in candidates include all of the candidate operator
7362     //   functions defined in 13.6 that, compared to the given operator, [...]
7363     //   do not have the same parameter-type-list as any non-template non-member
7364     //   candidate.
7365     //
7366     // Note that in practice, this only affects enumeration types because there
7367     // aren't any built-in candidates of record type, and a user-defined operator
7368     // must have an operand of record or enumeration type. Also, the only other
7369     // overloaded operator with enumeration arguments, operator=,
7370     // cannot be overloaded for enumeration types, so this is the only place
7371     // where we must suppress candidates like this.
7372     llvm::DenseSet<std::pair<CanQualType, CanQualType> >
7373       UserDefinedBinaryOperators;
7374 
7375     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7376       if (CandidateTypes[ArgIdx].enumeration_begin() !=
7377           CandidateTypes[ArgIdx].enumeration_end()) {
7378         for (OverloadCandidateSet::iterator C = CandidateSet.begin(),
7379                                          CEnd = CandidateSet.end();
7380              C != CEnd; ++C) {
7381           if (!C->Viable || !C->Function || C->Function->getNumParams() != 2)
7382             continue;
7383 
7384           if (C->Function->isFunctionTemplateSpecialization())
7385             continue;
7386 
7387           QualType FirstParamType =
7388             C->Function->getParamDecl(0)->getType().getUnqualifiedType();
7389           QualType SecondParamType =
7390             C->Function->getParamDecl(1)->getType().getUnqualifiedType();
7391 
7392           // Skip if either parameter isn't of enumeral type.
7393           if (!FirstParamType->isEnumeralType() ||
7394               !SecondParamType->isEnumeralType())
7395             continue;
7396 
7397           // Add this operator to the set of known user-defined operators.
7398           UserDefinedBinaryOperators.insert(
7399             std::make_pair(S.Context.getCanonicalType(FirstParamType),
7400                            S.Context.getCanonicalType(SecondParamType)));
7401         }
7402       }
7403     }
7404 
7405     /// Set of (canonical) types that we've already handled.
7406     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7407 
7408     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7409       for (BuiltinCandidateTypeSet::iterator
7410                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
7411              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
7412            Ptr != PtrEnd; ++Ptr) {
7413         // Don't add the same builtin candidate twice.
7414         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7415           continue;
7416 
7417         QualType ParamTypes[2] = { *Ptr, *Ptr };
7418         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
7419       }
7420       for (BuiltinCandidateTypeSet::iterator
7421                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7422              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7423            Enum != EnumEnd; ++Enum) {
7424         CanQualType CanonType = S.Context.getCanonicalType(*Enum);
7425 
7426         // Don't add the same builtin candidate twice, or if a user defined
7427         // candidate exists.
7428         if (!AddedTypes.insert(CanonType) ||
7429             UserDefinedBinaryOperators.count(std::make_pair(CanonType,
7430                                                             CanonType)))
7431           continue;
7432 
7433         QualType ParamTypes[2] = { *Enum, *Enum };
7434         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
7435       }
7436 
7437       if (CandidateTypes[ArgIdx].hasNullPtrType()) {
7438         CanQualType NullPtrTy = S.Context.getCanonicalType(S.Context.NullPtrTy);
7439         if (AddedTypes.insert(NullPtrTy) &&
7440             !UserDefinedBinaryOperators.count(std::make_pair(NullPtrTy,
7441                                                              NullPtrTy))) {
7442           QualType ParamTypes[2] = { NullPtrTy, NullPtrTy };
7443           S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args,
7444                                 CandidateSet);
7445         }
7446       }
7447     }
7448   }
7449 
7450   // C++ [over.built]p13:
7451   //
7452   //   For every cv-qualified or cv-unqualified object type T
7453   //   there exist candidate operator functions of the form
7454   //
7455   //      T*         operator+(T*, ptrdiff_t);
7456   //      T&         operator[](T*, ptrdiff_t);    [BELOW]
7457   //      T*         operator-(T*, ptrdiff_t);
7458   //      T*         operator+(ptrdiff_t, T*);
7459   //      T&         operator[](ptrdiff_t, T*);    [BELOW]
7460   //
7461   // C++ [over.built]p14:
7462   //
7463   //   For every T, where T is a pointer to object type, there
7464   //   exist candidate operator functions of the form
7465   //
7466   //      ptrdiff_t  operator-(T, T);
7467   void addBinaryPlusOrMinusPointerOverloads(OverloadedOperatorKind Op) {
7468     /// Set of (canonical) types that we've already handled.
7469     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7470 
7471     for (int Arg = 0; Arg < 2; ++Arg) {
7472       QualType AsymetricParamTypes[2] = {
7473         S.Context.getPointerDiffType(),
7474         S.Context.getPointerDiffType(),
7475       };
7476       for (BuiltinCandidateTypeSet::iterator
7477                 Ptr = CandidateTypes[Arg].pointer_begin(),
7478              PtrEnd = CandidateTypes[Arg].pointer_end();
7479            Ptr != PtrEnd; ++Ptr) {
7480         QualType PointeeTy = (*Ptr)->getPointeeType();
7481         if (!PointeeTy->isObjectType())
7482           continue;
7483 
7484         AsymetricParamTypes[Arg] = *Ptr;
7485         if (Arg == 0 || Op == OO_Plus) {
7486           // operator+(T*, ptrdiff_t) or operator-(T*, ptrdiff_t)
7487           // T* operator+(ptrdiff_t, T*);
7488           S.AddBuiltinCandidate(*Ptr, AsymetricParamTypes, Args, CandidateSet);
7489         }
7490         if (Op == OO_Minus) {
7491           // ptrdiff_t operator-(T, T);
7492           if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7493             continue;
7494 
7495           QualType ParamTypes[2] = { *Ptr, *Ptr };
7496           S.AddBuiltinCandidate(S.Context.getPointerDiffType(), ParamTypes,
7497                                 Args, CandidateSet);
7498         }
7499       }
7500     }
7501   }
7502 
7503   // C++ [over.built]p12:
7504   //
7505   //   For every pair of promoted arithmetic types L and R, there
7506   //   exist candidate operator functions of the form
7507   //
7508   //        LR         operator*(L, R);
7509   //        LR         operator/(L, R);
7510   //        LR         operator+(L, R);
7511   //        LR         operator-(L, R);
7512   //        bool       operator<(L, R);
7513   //        bool       operator>(L, R);
7514   //        bool       operator<=(L, R);
7515   //        bool       operator>=(L, R);
7516   //        bool       operator==(L, R);
7517   //        bool       operator!=(L, R);
7518   //
7519   //   where LR is the result of the usual arithmetic conversions
7520   //   between types L and R.
7521   //
7522   // C++ [over.built]p24:
7523   //
7524   //   For every pair of promoted arithmetic types L and R, there exist
7525   //   candidate operator functions of the form
7526   //
7527   //        LR       operator?(bool, L, R);
7528   //
7529   //   where LR is the result of the usual arithmetic conversions
7530   //   between types L and R.
7531   // Our candidates ignore the first parameter.
7532   void addGenericBinaryArithmeticOverloads(bool isComparison) {
7533     if (!HasArithmeticOrEnumeralCandidateType)
7534       return;
7535 
7536     for (unsigned Left = FirstPromotedArithmeticType;
7537          Left < LastPromotedArithmeticType; ++Left) {
7538       for (unsigned Right = FirstPromotedArithmeticType;
7539            Right < LastPromotedArithmeticType; ++Right) {
7540         QualType LandR[2] = { getArithmeticType(Left),
7541                               getArithmeticType(Right) };
7542         QualType Result =
7543           isComparison ? S.Context.BoolTy
7544                        : getUsualArithmeticConversions(Left, Right);
7545         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7546       }
7547     }
7548 
7549     // Extension: Add the binary operators ==, !=, <, <=, >=, >, *, /, and the
7550     // conditional operator for vector types.
7551     for (BuiltinCandidateTypeSet::iterator
7552               Vec1 = CandidateTypes[0].vector_begin(),
7553            Vec1End = CandidateTypes[0].vector_end();
7554          Vec1 != Vec1End; ++Vec1) {
7555       for (BuiltinCandidateTypeSet::iterator
7556                 Vec2 = CandidateTypes[1].vector_begin(),
7557              Vec2End = CandidateTypes[1].vector_end();
7558            Vec2 != Vec2End; ++Vec2) {
7559         QualType LandR[2] = { *Vec1, *Vec2 };
7560         QualType Result = S.Context.BoolTy;
7561         if (!isComparison) {
7562           if ((*Vec1)->isExtVectorType() || !(*Vec2)->isExtVectorType())
7563             Result = *Vec1;
7564           else
7565             Result = *Vec2;
7566         }
7567 
7568         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7569       }
7570     }
7571   }
7572 
7573   // C++ [over.built]p17:
7574   //
7575   //   For every pair of promoted integral types L and R, there
7576   //   exist candidate operator functions of the form
7577   //
7578   //      LR         operator%(L, R);
7579   //      LR         operator&(L, R);
7580   //      LR         operator^(L, R);
7581   //      LR         operator|(L, R);
7582   //      L          operator<<(L, R);
7583   //      L          operator>>(L, R);
7584   //
7585   //   where LR is the result of the usual arithmetic conversions
7586   //   between types L and R.
7587   void addBinaryBitwiseArithmeticOverloads(OverloadedOperatorKind Op) {
7588     if (!HasArithmeticOrEnumeralCandidateType)
7589       return;
7590 
7591     for (unsigned Left = FirstPromotedIntegralType;
7592          Left < LastPromotedIntegralType; ++Left) {
7593       for (unsigned Right = FirstPromotedIntegralType;
7594            Right < LastPromotedIntegralType; ++Right) {
7595         QualType LandR[2] = { getArithmeticType(Left),
7596                               getArithmeticType(Right) };
7597         QualType Result = (Op == OO_LessLess || Op == OO_GreaterGreater)
7598             ? LandR[0]
7599             : getUsualArithmeticConversions(Left, Right);
7600         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7601       }
7602     }
7603   }
7604 
7605   // C++ [over.built]p20:
7606   //
7607   //   For every pair (T, VQ), where T is an enumeration or
7608   //   pointer to member type and VQ is either volatile or
7609   //   empty, there exist candidate operator functions of the form
7610   //
7611   //        VQ T&      operator=(VQ T&, T);
7612   void addAssignmentMemberPointerOrEnumeralOverloads() {
7613     /// Set of (canonical) types that we've already handled.
7614     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7615 
7616     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
7617       for (BuiltinCandidateTypeSet::iterator
7618                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7619              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7620            Enum != EnumEnd; ++Enum) {
7621         if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)))
7622           continue;
7623 
7624         AddBuiltinAssignmentOperatorCandidates(S, *Enum, Args, CandidateSet);
7625       }
7626 
7627       for (BuiltinCandidateTypeSet::iterator
7628                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
7629              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
7630            MemPtr != MemPtrEnd; ++MemPtr) {
7631         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
7632           continue;
7633 
7634         AddBuiltinAssignmentOperatorCandidates(S, *MemPtr, Args, CandidateSet);
7635       }
7636     }
7637   }
7638 
7639   // C++ [over.built]p19:
7640   //
7641   //   For every pair (T, VQ), where T is any type and VQ is either
7642   //   volatile or empty, there exist candidate operator functions
7643   //   of the form
7644   //
7645   //        T*VQ&      operator=(T*VQ&, T*);
7646   //
7647   // C++ [over.built]p21:
7648   //
7649   //   For every pair (T, VQ), where T is a cv-qualified or
7650   //   cv-unqualified object type and VQ is either volatile or
7651   //   empty, there exist candidate operator functions of the form
7652   //
7653   //        T*VQ&      operator+=(T*VQ&, ptrdiff_t);
7654   //        T*VQ&      operator-=(T*VQ&, ptrdiff_t);
7655   void addAssignmentPointerOverloads(bool isEqualOp) {
7656     /// Set of (canonical) types that we've already handled.
7657     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7658 
7659     for (BuiltinCandidateTypeSet::iterator
7660               Ptr = CandidateTypes[0].pointer_begin(),
7661            PtrEnd = CandidateTypes[0].pointer_end();
7662          Ptr != PtrEnd; ++Ptr) {
7663       // If this is operator=, keep track of the builtin candidates we added.
7664       if (isEqualOp)
7665         AddedTypes.insert(S.Context.getCanonicalType(*Ptr));
7666       else if (!(*Ptr)->getPointeeType()->isObjectType())
7667         continue;
7668 
7669       // non-volatile version
7670       QualType ParamTypes[2] = {
7671         S.Context.getLValueReferenceType(*Ptr),
7672         isEqualOp ? *Ptr : S.Context.getPointerDiffType(),
7673       };
7674       S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7675                             /*IsAssigmentOperator=*/ isEqualOp);
7676 
7677       bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
7678                           VisibleTypeConversionsQuals.hasVolatile();
7679       if (NeedVolatile) {
7680         // volatile version
7681         ParamTypes[0] =
7682           S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
7683         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7684                               /*IsAssigmentOperator=*/isEqualOp);
7685       }
7686 
7687       if (!(*Ptr).isRestrictQualified() &&
7688           VisibleTypeConversionsQuals.hasRestrict()) {
7689         // restrict version
7690         ParamTypes[0]
7691           = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
7692         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7693                               /*IsAssigmentOperator=*/isEqualOp);
7694 
7695         if (NeedVolatile) {
7696           // volatile restrict version
7697           ParamTypes[0]
7698             = S.Context.getLValueReferenceType(
7699                 S.Context.getCVRQualifiedType(*Ptr,
7700                                               (Qualifiers::Volatile |
7701                                                Qualifiers::Restrict)));
7702           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7703                                 /*IsAssigmentOperator=*/isEqualOp);
7704         }
7705       }
7706     }
7707 
7708     if (isEqualOp) {
7709       for (BuiltinCandidateTypeSet::iterator
7710                 Ptr = CandidateTypes[1].pointer_begin(),
7711              PtrEnd = CandidateTypes[1].pointer_end();
7712            Ptr != PtrEnd; ++Ptr) {
7713         // Make sure we don't add the same candidate twice.
7714         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7715           continue;
7716 
7717         QualType ParamTypes[2] = {
7718           S.Context.getLValueReferenceType(*Ptr),
7719           *Ptr,
7720         };
7721 
7722         // non-volatile version
7723         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7724                               /*IsAssigmentOperator=*/true);
7725 
7726         bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
7727                            VisibleTypeConversionsQuals.hasVolatile();
7728         if (NeedVolatile) {
7729           // volatile version
7730           ParamTypes[0] =
7731             S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
7732           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7733                                 /*IsAssigmentOperator=*/true);
7734         }
7735 
7736         if (!(*Ptr).isRestrictQualified() &&
7737             VisibleTypeConversionsQuals.hasRestrict()) {
7738           // restrict version
7739           ParamTypes[0]
7740             = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
7741           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7742                                 /*IsAssigmentOperator=*/true);
7743 
7744           if (NeedVolatile) {
7745             // volatile restrict version
7746             ParamTypes[0]
7747               = S.Context.getLValueReferenceType(
7748                   S.Context.getCVRQualifiedType(*Ptr,
7749                                                 (Qualifiers::Volatile |
7750                                                  Qualifiers::Restrict)));
7751             S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7752                                   /*IsAssigmentOperator=*/true);
7753           }
7754         }
7755       }
7756     }
7757   }
7758 
7759   // C++ [over.built]p18:
7760   //
7761   //   For every triple (L, VQ, R), where L is an arithmetic type,
7762   //   VQ is either volatile or empty, and R is a promoted
7763   //   arithmetic type, there exist candidate operator functions of
7764   //   the form
7765   //
7766   //        VQ L&      operator=(VQ L&, R);
7767   //        VQ L&      operator*=(VQ L&, R);
7768   //        VQ L&      operator/=(VQ L&, R);
7769   //        VQ L&      operator+=(VQ L&, R);
7770   //        VQ L&      operator-=(VQ L&, R);
7771   void addAssignmentArithmeticOverloads(bool isEqualOp) {
7772     if (!HasArithmeticOrEnumeralCandidateType)
7773       return;
7774 
7775     for (unsigned Left = 0; Left < NumArithmeticTypes; ++Left) {
7776       for (unsigned Right = FirstPromotedArithmeticType;
7777            Right < LastPromotedArithmeticType; ++Right) {
7778         QualType ParamTypes[2];
7779         ParamTypes[1] = getArithmeticType(Right);
7780 
7781         // Add this built-in operator as a candidate (VQ is empty).
7782         ParamTypes[0] =
7783           S.Context.getLValueReferenceType(getArithmeticType(Left));
7784         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7785                               /*IsAssigmentOperator=*/isEqualOp);
7786 
7787         // Add this built-in operator as a candidate (VQ is 'volatile').
7788         if (VisibleTypeConversionsQuals.hasVolatile()) {
7789           ParamTypes[0] =
7790             S.Context.getVolatileType(getArithmeticType(Left));
7791           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7792           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7793                                 /*IsAssigmentOperator=*/isEqualOp);
7794         }
7795       }
7796     }
7797 
7798     // Extension: Add the binary operators =, +=, -=, *=, /= for vector types.
7799     for (BuiltinCandidateTypeSet::iterator
7800               Vec1 = CandidateTypes[0].vector_begin(),
7801            Vec1End = CandidateTypes[0].vector_end();
7802          Vec1 != Vec1End; ++Vec1) {
7803       for (BuiltinCandidateTypeSet::iterator
7804                 Vec2 = CandidateTypes[1].vector_begin(),
7805              Vec2End = CandidateTypes[1].vector_end();
7806            Vec2 != Vec2End; ++Vec2) {
7807         QualType ParamTypes[2];
7808         ParamTypes[1] = *Vec2;
7809         // Add this built-in operator as a candidate (VQ is empty).
7810         ParamTypes[0] = S.Context.getLValueReferenceType(*Vec1);
7811         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7812                               /*IsAssigmentOperator=*/isEqualOp);
7813 
7814         // Add this built-in operator as a candidate (VQ is 'volatile').
7815         if (VisibleTypeConversionsQuals.hasVolatile()) {
7816           ParamTypes[0] = S.Context.getVolatileType(*Vec1);
7817           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7818           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7819                                 /*IsAssigmentOperator=*/isEqualOp);
7820         }
7821       }
7822     }
7823   }
7824 
7825   // C++ [over.built]p22:
7826   //
7827   //   For every triple (L, VQ, R), where L is an integral type, VQ
7828   //   is either volatile or empty, and R is a promoted integral
7829   //   type, there exist candidate operator functions of the form
7830   //
7831   //        VQ L&       operator%=(VQ L&, R);
7832   //        VQ L&       operator<<=(VQ L&, R);
7833   //        VQ L&       operator>>=(VQ L&, R);
7834   //        VQ L&       operator&=(VQ L&, R);
7835   //        VQ L&       operator^=(VQ L&, R);
7836   //        VQ L&       operator|=(VQ L&, R);
7837   void addAssignmentIntegralOverloads() {
7838     if (!HasArithmeticOrEnumeralCandidateType)
7839       return;
7840 
7841     for (unsigned Left = FirstIntegralType; Left < LastIntegralType; ++Left) {
7842       for (unsigned Right = FirstPromotedIntegralType;
7843            Right < LastPromotedIntegralType; ++Right) {
7844         QualType ParamTypes[2];
7845         ParamTypes[1] = getArithmeticType(Right);
7846 
7847         // Add this built-in operator as a candidate (VQ is empty).
7848         ParamTypes[0] =
7849           S.Context.getLValueReferenceType(getArithmeticType(Left));
7850         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7851         if (VisibleTypeConversionsQuals.hasVolatile()) {
7852           // Add this built-in operator as a candidate (VQ is 'volatile').
7853           ParamTypes[0] = getArithmeticType(Left);
7854           ParamTypes[0] = S.Context.getVolatileType(ParamTypes[0]);
7855           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7856           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7857         }
7858       }
7859     }
7860   }
7861 
7862   // C++ [over.operator]p23:
7863   //
7864   //   There also exist candidate operator functions of the form
7865   //
7866   //        bool        operator!(bool);
7867   //        bool        operator&&(bool, bool);
7868   //        bool        operator||(bool, bool);
7869   void addExclaimOverload() {
7870     QualType ParamTy = S.Context.BoolTy;
7871     S.AddBuiltinCandidate(ParamTy, &ParamTy, Args, CandidateSet,
7872                           /*IsAssignmentOperator=*/false,
7873                           /*NumContextualBoolArguments=*/1);
7874   }
7875   void addAmpAmpOrPipePipeOverload() {
7876     QualType ParamTypes[2] = { S.Context.BoolTy, S.Context.BoolTy };
7877     S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet,
7878                           /*IsAssignmentOperator=*/false,
7879                           /*NumContextualBoolArguments=*/2);
7880   }
7881 
7882   // C++ [over.built]p13:
7883   //
7884   //   For every cv-qualified or cv-unqualified object type T there
7885   //   exist candidate operator functions of the form
7886   //
7887   //        T*         operator+(T*, ptrdiff_t);     [ABOVE]
7888   //        T&         operator[](T*, ptrdiff_t);
7889   //        T*         operator-(T*, ptrdiff_t);     [ABOVE]
7890   //        T*         operator+(ptrdiff_t, T*);     [ABOVE]
7891   //        T&         operator[](ptrdiff_t, T*);
7892   void addSubscriptOverloads() {
7893     for (BuiltinCandidateTypeSet::iterator
7894               Ptr = CandidateTypes[0].pointer_begin(),
7895            PtrEnd = CandidateTypes[0].pointer_end();
7896          Ptr != PtrEnd; ++Ptr) {
7897       QualType ParamTypes[2] = { *Ptr, S.Context.getPointerDiffType() };
7898       QualType PointeeType = (*Ptr)->getPointeeType();
7899       if (!PointeeType->isObjectType())
7900         continue;
7901 
7902       QualType ResultTy = S.Context.getLValueReferenceType(PointeeType);
7903 
7904       // T& operator[](T*, ptrdiff_t)
7905       S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7906     }
7907 
7908     for (BuiltinCandidateTypeSet::iterator
7909               Ptr = CandidateTypes[1].pointer_begin(),
7910            PtrEnd = CandidateTypes[1].pointer_end();
7911          Ptr != PtrEnd; ++Ptr) {
7912       QualType ParamTypes[2] = { S.Context.getPointerDiffType(), *Ptr };
7913       QualType PointeeType = (*Ptr)->getPointeeType();
7914       if (!PointeeType->isObjectType())
7915         continue;
7916 
7917       QualType ResultTy = S.Context.getLValueReferenceType(PointeeType);
7918 
7919       // T& operator[](ptrdiff_t, T*)
7920       S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7921     }
7922   }
7923 
7924   // C++ [over.built]p11:
7925   //    For every quintuple (C1, C2, T, CV1, CV2), where C2 is a class type,
7926   //    C1 is the same type as C2 or is a derived class of C2, T is an object
7927   //    type or a function type, and CV1 and CV2 are cv-qualifier-seqs,
7928   //    there exist candidate operator functions of the form
7929   //
7930   //      CV12 T& operator->*(CV1 C1*, CV2 T C2::*);
7931   //
7932   //    where CV12 is the union of CV1 and CV2.
7933   void addArrowStarOverloads() {
7934     for (BuiltinCandidateTypeSet::iterator
7935              Ptr = CandidateTypes[0].pointer_begin(),
7936            PtrEnd = CandidateTypes[0].pointer_end();
7937          Ptr != PtrEnd; ++Ptr) {
7938       QualType C1Ty = (*Ptr);
7939       QualType C1;
7940       QualifierCollector Q1;
7941       C1 = QualType(Q1.strip(C1Ty->getPointeeType()), 0);
7942       if (!isa<RecordType>(C1))
7943         continue;
7944       // heuristic to reduce number of builtin candidates in the set.
7945       // Add volatile/restrict version only if there are conversions to a
7946       // volatile/restrict type.
7947       if (!VisibleTypeConversionsQuals.hasVolatile() && Q1.hasVolatile())
7948         continue;
7949       if (!VisibleTypeConversionsQuals.hasRestrict() && Q1.hasRestrict())
7950         continue;
7951       for (BuiltinCandidateTypeSet::iterator
7952                 MemPtr = CandidateTypes[1].member_pointer_begin(),
7953              MemPtrEnd = CandidateTypes[1].member_pointer_end();
7954            MemPtr != MemPtrEnd; ++MemPtr) {
7955         const MemberPointerType *mptr = cast<MemberPointerType>(*MemPtr);
7956         QualType C2 = QualType(mptr->getClass(), 0);
7957         C2 = C2.getUnqualifiedType();
7958         if (C1 != C2 && !S.IsDerivedFrom(C1, C2))
7959           break;
7960         QualType ParamTypes[2] = { *Ptr, *MemPtr };
7961         // build CV12 T&
7962         QualType T = mptr->getPointeeType();
7963         if (!VisibleTypeConversionsQuals.hasVolatile() &&
7964             T.isVolatileQualified())
7965           continue;
7966         if (!VisibleTypeConversionsQuals.hasRestrict() &&
7967             T.isRestrictQualified())
7968           continue;
7969         T = Q1.apply(S.Context, T);
7970         QualType ResultTy = S.Context.getLValueReferenceType(T);
7971         S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7972       }
7973     }
7974   }
7975 
7976   // Note that we don't consider the first argument, since it has been
7977   // contextually converted to bool long ago. The candidates below are
7978   // therefore added as binary.
7979   //
7980   // C++ [over.built]p25:
7981   //   For every type T, where T is a pointer, pointer-to-member, or scoped
7982   //   enumeration type, there exist candidate operator functions of the form
7983   //
7984   //        T        operator?(bool, T, T);
7985   //
7986   void addConditionalOperatorOverloads() {
7987     /// Set of (canonical) types that we've already handled.
7988     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7989 
7990     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
7991       for (BuiltinCandidateTypeSet::iterator
7992                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
7993              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
7994            Ptr != PtrEnd; ++Ptr) {
7995         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7996           continue;
7997 
7998         QualType ParamTypes[2] = { *Ptr, *Ptr };
7999         S.AddBuiltinCandidate(*Ptr, ParamTypes, Args, CandidateSet);
8000       }
8001 
8002       for (BuiltinCandidateTypeSet::iterator
8003                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
8004              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
8005            MemPtr != MemPtrEnd; ++MemPtr) {
8006         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
8007           continue;
8008 
8009         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
8010         S.AddBuiltinCandidate(*MemPtr, ParamTypes, Args, CandidateSet);
8011       }
8012 
8013       if (S.getLangOpts().CPlusPlus11) {
8014         for (BuiltinCandidateTypeSet::iterator
8015                   Enum = CandidateTypes[ArgIdx].enumeration_begin(),
8016                EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
8017              Enum != EnumEnd; ++Enum) {
8018           if (!(*Enum)->getAs<EnumType>()->getDecl()->isScoped())
8019             continue;
8020 
8021           if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)))
8022             continue;
8023 
8024           QualType ParamTypes[2] = { *Enum, *Enum };
8025           S.AddBuiltinCandidate(*Enum, ParamTypes, Args, CandidateSet);
8026         }
8027       }
8028     }
8029   }
8030 };
8031 
8032 } // end anonymous namespace
8033 
8034 /// AddBuiltinOperatorCandidates - Add the appropriate built-in
8035 /// operator overloads to the candidate set (C++ [over.built]), based
8036 /// on the operator @p Op and the arguments given. For example, if the
8037 /// operator is a binary '+', this routine might add "int
8038 /// operator+(int, int)" to cover integer addition.
8039 void Sema::AddBuiltinOperatorCandidates(OverloadedOperatorKind Op,
8040                                         SourceLocation OpLoc,
8041                                         ArrayRef<Expr *> Args,
8042                                         OverloadCandidateSet &CandidateSet) {
8043   // Find all of the types that the arguments can convert to, but only
8044   // if the operator we're looking at has built-in operator candidates
8045   // that make use of these types. Also record whether we encounter non-record
8046   // candidate types or either arithmetic or enumeral candidate types.
8047   Qualifiers VisibleTypeConversionsQuals;
8048   VisibleTypeConversionsQuals.addConst();
8049   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx)
8050     VisibleTypeConversionsQuals += CollectVRQualifiers(Context, Args[ArgIdx]);
8051 
8052   bool HasNonRecordCandidateType = false;
8053   bool HasArithmeticOrEnumeralCandidateType = false;
8054   SmallVector<BuiltinCandidateTypeSet, 2> CandidateTypes;
8055   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
8056     CandidateTypes.push_back(BuiltinCandidateTypeSet(*this));
8057     CandidateTypes[ArgIdx].AddTypesConvertedFrom(Args[ArgIdx]->getType(),
8058                                                  OpLoc,
8059                                                  true,
8060                                                  (Op == OO_Exclaim ||
8061                                                   Op == OO_AmpAmp ||
8062                                                   Op == OO_PipePipe),
8063                                                  VisibleTypeConversionsQuals);
8064     HasNonRecordCandidateType = HasNonRecordCandidateType ||
8065         CandidateTypes[ArgIdx].hasNonRecordTypes();
8066     HasArithmeticOrEnumeralCandidateType =
8067         HasArithmeticOrEnumeralCandidateType ||
8068         CandidateTypes[ArgIdx].hasArithmeticOrEnumeralTypes();
8069   }
8070 
8071   // Exit early when no non-record types have been added to the candidate set
8072   // for any of the arguments to the operator.
8073   //
8074   // We can't exit early for !, ||, or &&, since there we have always have
8075   // 'bool' overloads.
8076   if (!HasNonRecordCandidateType &&
8077       !(Op == OO_Exclaim || Op == OO_AmpAmp || Op == OO_PipePipe))
8078     return;
8079 
8080   // Setup an object to manage the common state for building overloads.
8081   BuiltinOperatorOverloadBuilder OpBuilder(*this, Args,
8082                                            VisibleTypeConversionsQuals,
8083                                            HasArithmeticOrEnumeralCandidateType,
8084                                            CandidateTypes, CandidateSet);
8085 
8086   // Dispatch over the operation to add in only those overloads which apply.
8087   switch (Op) {
8088   case OO_None:
8089   case NUM_OVERLOADED_OPERATORS:
8090     llvm_unreachable("Expected an overloaded operator");
8091 
8092   case OO_New:
8093   case OO_Delete:
8094   case OO_Array_New:
8095   case OO_Array_Delete:
8096   case OO_Call:
8097     llvm_unreachable(
8098                     "Special operators don't use AddBuiltinOperatorCandidates");
8099 
8100   case OO_Comma:
8101   case OO_Arrow:
8102     // C++ [over.match.oper]p3:
8103     //   -- For the operator ',', the unary operator '&', or the
8104     //      operator '->', the built-in candidates set is empty.
8105     break;
8106 
8107   case OO_Plus: // '+' is either unary or binary
8108     if (Args.size() == 1)
8109       OpBuilder.addUnaryPlusPointerOverloads();
8110     // Fall through.
8111 
8112   case OO_Minus: // '-' is either unary or binary
8113     if (Args.size() == 1) {
8114       OpBuilder.addUnaryPlusOrMinusArithmeticOverloads();
8115     } else {
8116       OpBuilder.addBinaryPlusOrMinusPointerOverloads(Op);
8117       OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
8118     }
8119     break;
8120 
8121   case OO_Star: // '*' is either unary or binary
8122     if (Args.size() == 1)
8123       OpBuilder.addUnaryStarPointerOverloads();
8124     else
8125       OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
8126     break;
8127 
8128   case OO_Slash:
8129     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
8130     break;
8131 
8132   case OO_PlusPlus:
8133   case OO_MinusMinus:
8134     OpBuilder.addPlusPlusMinusMinusArithmeticOverloads(Op);
8135     OpBuilder.addPlusPlusMinusMinusPointerOverloads();
8136     break;
8137 
8138   case OO_EqualEqual:
8139   case OO_ExclaimEqual:
8140     OpBuilder.addEqualEqualOrNotEqualMemberPointerOverloads();
8141     // Fall through.
8142 
8143   case OO_Less:
8144   case OO_Greater:
8145   case OO_LessEqual:
8146   case OO_GreaterEqual:
8147     OpBuilder.addRelationalPointerOrEnumeralOverloads();
8148     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/true);
8149     break;
8150 
8151   case OO_Percent:
8152   case OO_Caret:
8153   case OO_Pipe:
8154   case OO_LessLess:
8155   case OO_GreaterGreater:
8156     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
8157     break;
8158 
8159   case OO_Amp: // '&' is either unary or binary
8160     if (Args.size() == 1)
8161       // C++ [over.match.oper]p3:
8162       //   -- For the operator ',', the unary operator '&', or the
8163       //      operator '->', the built-in candidates set is empty.
8164       break;
8165 
8166     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
8167     break;
8168 
8169   case OO_Tilde:
8170     OpBuilder.addUnaryTildePromotedIntegralOverloads();
8171     break;
8172 
8173   case OO_Equal:
8174     OpBuilder.addAssignmentMemberPointerOrEnumeralOverloads();
8175     // Fall through.
8176 
8177   case OO_PlusEqual:
8178   case OO_MinusEqual:
8179     OpBuilder.addAssignmentPointerOverloads(Op == OO_Equal);
8180     // Fall through.
8181 
8182   case OO_StarEqual:
8183   case OO_SlashEqual:
8184     OpBuilder.addAssignmentArithmeticOverloads(Op == OO_Equal);
8185     break;
8186 
8187   case OO_PercentEqual:
8188   case OO_LessLessEqual:
8189   case OO_GreaterGreaterEqual:
8190   case OO_AmpEqual:
8191   case OO_CaretEqual:
8192   case OO_PipeEqual:
8193     OpBuilder.addAssignmentIntegralOverloads();
8194     break;
8195 
8196   case OO_Exclaim:
8197     OpBuilder.addExclaimOverload();
8198     break;
8199 
8200   case OO_AmpAmp:
8201   case OO_PipePipe:
8202     OpBuilder.addAmpAmpOrPipePipeOverload();
8203     break;
8204 
8205   case OO_Subscript:
8206     OpBuilder.addSubscriptOverloads();
8207     break;
8208 
8209   case OO_ArrowStar:
8210     OpBuilder.addArrowStarOverloads();
8211     break;
8212 
8213   case OO_Conditional:
8214     OpBuilder.addConditionalOperatorOverloads();
8215     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
8216     break;
8217   }
8218 }
8219 
8220 /// \brief Add function candidates found via argument-dependent lookup
8221 /// to the set of overloading candidates.
8222 ///
8223 /// This routine performs argument-dependent name lookup based on the
8224 /// given function name (which may also be an operator name) and adds
8225 /// all of the overload candidates found by ADL to the overload
8226 /// candidate set (C++ [basic.lookup.argdep]).
8227 void
8228 Sema::AddArgumentDependentLookupCandidates(DeclarationName Name,
8229                                            SourceLocation Loc,
8230                                            ArrayRef<Expr *> Args,
8231                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
8232                                            OverloadCandidateSet& CandidateSet,
8233                                            bool PartialOverloading) {
8234   ADLResult Fns;
8235 
8236   // FIXME: This approach for uniquing ADL results (and removing
8237   // redundant candidates from the set) relies on pointer-equality,
8238   // which means we need to key off the canonical decl.  However,
8239   // always going back to the canonical decl might not get us the
8240   // right set of default arguments.  What default arguments are
8241   // we supposed to consider on ADL candidates, anyway?
8242 
8243   // FIXME: Pass in the explicit template arguments?
8244   ArgumentDependentLookup(Name, Loc, Args, Fns);
8245 
8246   // Erase all of the candidates we already knew about.
8247   for (OverloadCandidateSet::iterator Cand = CandidateSet.begin(),
8248                                    CandEnd = CandidateSet.end();
8249        Cand != CandEnd; ++Cand)
8250     if (Cand->Function) {
8251       Fns.erase(Cand->Function);
8252       if (FunctionTemplateDecl *FunTmpl = Cand->Function->getPrimaryTemplate())
8253         Fns.erase(FunTmpl);
8254     }
8255 
8256   // For each of the ADL candidates we found, add it to the overload
8257   // set.
8258   for (ADLResult::iterator I = Fns.begin(), E = Fns.end(); I != E; ++I) {
8259     DeclAccessPair FoundDecl = DeclAccessPair::make(*I, AS_none);
8260     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
8261       if (ExplicitTemplateArgs)
8262         continue;
8263 
8264       AddOverloadCandidate(FD, FoundDecl, Args, CandidateSet, false,
8265                            PartialOverloading);
8266     } else
8267       AddTemplateOverloadCandidate(cast<FunctionTemplateDecl>(*I),
8268                                    FoundDecl, ExplicitTemplateArgs,
8269                                    Args, CandidateSet);
8270   }
8271 }
8272 
8273 /// isBetterOverloadCandidate - Determines whether the first overload
8274 /// candidate is a better candidate than the second (C++ 13.3.3p1).
8275 bool
8276 isBetterOverloadCandidate(Sema &S,
8277                           const OverloadCandidate &Cand1,
8278                           const OverloadCandidate &Cand2,
8279                           SourceLocation Loc,
8280                           bool UserDefinedConversion) {
8281   // Define viable functions to be better candidates than non-viable
8282   // functions.
8283   if (!Cand2.Viable)
8284     return Cand1.Viable;
8285   else if (!Cand1.Viable)
8286     return false;
8287 
8288   // C++ [over.match.best]p1:
8289   //
8290   //   -- if F is a static member function, ICS1(F) is defined such
8291   //      that ICS1(F) is neither better nor worse than ICS1(G) for
8292   //      any function G, and, symmetrically, ICS1(G) is neither
8293   //      better nor worse than ICS1(F).
8294   unsigned StartArg = 0;
8295   if (Cand1.IgnoreObjectArgument || Cand2.IgnoreObjectArgument)
8296     StartArg = 1;
8297 
8298   // C++ [over.match.best]p1:
8299   //   A viable function F1 is defined to be a better function than another
8300   //   viable function F2 if for all arguments i, ICSi(F1) is not a worse
8301   //   conversion sequence than ICSi(F2), and then...
8302   unsigned NumArgs = Cand1.NumConversions;
8303   assert(Cand2.NumConversions == NumArgs && "Overload candidate mismatch");
8304   bool HasBetterConversion = false;
8305   for (unsigned ArgIdx = StartArg; ArgIdx < NumArgs; ++ArgIdx) {
8306     switch (CompareImplicitConversionSequences(S,
8307                                                Cand1.Conversions[ArgIdx],
8308                                                Cand2.Conversions[ArgIdx])) {
8309     case ImplicitConversionSequence::Better:
8310       // Cand1 has a better conversion sequence.
8311       HasBetterConversion = true;
8312       break;
8313 
8314     case ImplicitConversionSequence::Worse:
8315       // Cand1 can't be better than Cand2.
8316       return false;
8317 
8318     case ImplicitConversionSequence::Indistinguishable:
8319       // Do nothing.
8320       break;
8321     }
8322   }
8323 
8324   //    -- for some argument j, ICSj(F1) is a better conversion sequence than
8325   //       ICSj(F2), or, if not that,
8326   if (HasBetterConversion)
8327     return true;
8328 
8329   //   -- the context is an initialization by user-defined conversion
8330   //      (see 8.5, 13.3.1.5) and the standard conversion sequence
8331   //      from the return type of F1 to the destination type (i.e.,
8332   //      the type of the entity being initialized) is a better
8333   //      conversion sequence than the standard conversion sequence
8334   //      from the return type of F2 to the destination type.
8335   if (UserDefinedConversion && Cand1.Function && Cand2.Function &&
8336       isa<CXXConversionDecl>(Cand1.Function) &&
8337       isa<CXXConversionDecl>(Cand2.Function)) {
8338     // First check whether we prefer one of the conversion functions over the
8339     // other. This only distinguishes the results in non-standard, extension
8340     // cases such as the conversion from a lambda closure type to a function
8341     // pointer or block.
8342     ImplicitConversionSequence::CompareKind Result =
8343         compareConversionFunctions(S, Cand1.Function, Cand2.Function);
8344     if (Result == ImplicitConversionSequence::Indistinguishable)
8345       Result = CompareStandardConversionSequences(S,
8346                                                   Cand1.FinalConversion,
8347                                                   Cand2.FinalConversion);
8348 
8349     if (Result != ImplicitConversionSequence::Indistinguishable)
8350       return Result == ImplicitConversionSequence::Better;
8351 
8352     // FIXME: Compare kind of reference binding if conversion functions
8353     // convert to a reference type used in direct reference binding, per
8354     // C++14 [over.match.best]p1 section 2 bullet 3.
8355   }
8356 
8357   //    -- F1 is a non-template function and F2 is a function template
8358   //       specialization, or, if not that,
8359   bool Cand1IsSpecialization = Cand1.Function &&
8360                                Cand1.Function->getPrimaryTemplate();
8361   bool Cand2IsSpecialization = Cand2.Function &&
8362                                Cand2.Function->getPrimaryTemplate();
8363   if (Cand1IsSpecialization != Cand2IsSpecialization)
8364     return Cand2IsSpecialization;
8365 
8366   //   -- F1 and F2 are function template specializations, and the function
8367   //      template for F1 is more specialized than the template for F2
8368   //      according to the partial ordering rules described in 14.5.5.2, or,
8369   //      if not that,
8370   if (Cand1IsSpecialization && Cand2IsSpecialization) {
8371     if (FunctionTemplateDecl *BetterTemplate
8372           = S.getMoreSpecializedTemplate(Cand1.Function->getPrimaryTemplate(),
8373                                          Cand2.Function->getPrimaryTemplate(),
8374                                          Loc,
8375                        isa<CXXConversionDecl>(Cand1.Function)? TPOC_Conversion
8376                                                              : TPOC_Call,
8377                                          Cand1.ExplicitCallArguments,
8378                                          Cand2.ExplicitCallArguments))
8379       return BetterTemplate == Cand1.Function->getPrimaryTemplate();
8380   }
8381 
8382   // Check for enable_if value-based overload resolution.
8383   if (Cand1.Function && Cand2.Function &&
8384       (Cand1.Function->hasAttr<EnableIfAttr>() ||
8385        Cand2.Function->hasAttr<EnableIfAttr>())) {
8386     // FIXME: The next several lines are just
8387     // specific_attr_iterator<EnableIfAttr> but going in declaration order,
8388     // instead of reverse order which is how they're stored in the AST.
8389     AttrVec Cand1Attrs;
8390     if (Cand1.Function->hasAttrs()) {
8391       Cand1Attrs = Cand1.Function->getAttrs();
8392       Cand1Attrs.erase(std::remove_if(Cand1Attrs.begin(), Cand1Attrs.end(),
8393                                       IsNotEnableIfAttr),
8394                        Cand1Attrs.end());
8395       std::reverse(Cand1Attrs.begin(), Cand1Attrs.end());
8396     }
8397 
8398     AttrVec Cand2Attrs;
8399     if (Cand2.Function->hasAttrs()) {
8400       Cand2Attrs = Cand2.Function->getAttrs();
8401       Cand2Attrs.erase(std::remove_if(Cand2Attrs.begin(), Cand2Attrs.end(),
8402                                       IsNotEnableIfAttr),
8403                        Cand2Attrs.end());
8404       std::reverse(Cand2Attrs.begin(), Cand2Attrs.end());
8405     }
8406 
8407     // Candidate 1 is better if it has strictly more attributes and
8408     // the common sequence is identical.
8409     if (Cand1Attrs.size() <= Cand2Attrs.size())
8410       return false;
8411 
8412     auto Cand1I = Cand1Attrs.begin();
8413     for (auto &Cand2A : Cand2Attrs) {
8414       auto &Cand1A = *Cand1I++;
8415       llvm::FoldingSetNodeID Cand1ID, Cand2ID;
8416       cast<EnableIfAttr>(Cand1A)->getCond()->Profile(Cand1ID,
8417                                                      S.getASTContext(), true);
8418       cast<EnableIfAttr>(Cand2A)->getCond()->Profile(Cand2ID,
8419                                                      S.getASTContext(), true);
8420       if (Cand1ID != Cand2ID)
8421         return false;
8422     }
8423 
8424     return true;
8425   }
8426 
8427   return false;
8428 }
8429 
8430 /// \brief Computes the best viable function (C++ 13.3.3)
8431 /// within an overload candidate set.
8432 ///
8433 /// \param Loc The location of the function name (or operator symbol) for
8434 /// which overload resolution occurs.
8435 ///
8436 /// \param Best If overload resolution was successful or found a deleted
8437 /// function, \p Best points to the candidate function found.
8438 ///
8439 /// \returns The result of overload resolution.
8440 OverloadingResult
8441 OverloadCandidateSet::BestViableFunction(Sema &S, SourceLocation Loc,
8442                                          iterator &Best,
8443                                          bool UserDefinedConversion) {
8444   // Find the best viable function.
8445   Best = end();
8446   for (iterator Cand = begin(); Cand != end(); ++Cand) {
8447     if (Cand->Viable)
8448       if (Best == end() || isBetterOverloadCandidate(S, *Cand, *Best, Loc,
8449                                                      UserDefinedConversion))
8450         Best = Cand;
8451   }
8452 
8453   // If we didn't find any viable functions, abort.
8454   if (Best == end())
8455     return OR_No_Viable_Function;
8456 
8457   // Make sure that this function is better than every other viable
8458   // function. If not, we have an ambiguity.
8459   for (iterator Cand = begin(); Cand != end(); ++Cand) {
8460     if (Cand->Viable &&
8461         Cand != Best &&
8462         !isBetterOverloadCandidate(S, *Best, *Cand, Loc,
8463                                    UserDefinedConversion)) {
8464       Best = end();
8465       return OR_Ambiguous;
8466     }
8467   }
8468 
8469   // Best is the best viable function.
8470   if (Best->Function &&
8471       (Best->Function->isDeleted() ||
8472        S.isFunctionConsideredUnavailable(Best->Function)))
8473     return OR_Deleted;
8474 
8475   return OR_Success;
8476 }
8477 
8478 namespace {
8479 
8480 enum OverloadCandidateKind {
8481   oc_function,
8482   oc_method,
8483   oc_constructor,
8484   oc_function_template,
8485   oc_method_template,
8486   oc_constructor_template,
8487   oc_implicit_default_constructor,
8488   oc_implicit_copy_constructor,
8489   oc_implicit_move_constructor,
8490   oc_implicit_copy_assignment,
8491   oc_implicit_move_assignment,
8492   oc_implicit_inherited_constructor
8493 };
8494 
8495 OverloadCandidateKind ClassifyOverloadCandidate(Sema &S,
8496                                                 FunctionDecl *Fn,
8497                                                 std::string &Description) {
8498   bool isTemplate = false;
8499 
8500   if (FunctionTemplateDecl *FunTmpl = Fn->getPrimaryTemplate()) {
8501     isTemplate = true;
8502     Description = S.getTemplateArgumentBindingsText(
8503       FunTmpl->getTemplateParameters(), *Fn->getTemplateSpecializationArgs());
8504   }
8505 
8506   if (CXXConstructorDecl *Ctor = dyn_cast<CXXConstructorDecl>(Fn)) {
8507     if (!Ctor->isImplicit())
8508       return isTemplate ? oc_constructor_template : oc_constructor;
8509 
8510     if (Ctor->getInheritedConstructor())
8511       return oc_implicit_inherited_constructor;
8512 
8513     if (Ctor->isDefaultConstructor())
8514       return oc_implicit_default_constructor;
8515 
8516     if (Ctor->isMoveConstructor())
8517       return oc_implicit_move_constructor;
8518 
8519     assert(Ctor->isCopyConstructor() &&
8520            "unexpected sort of implicit constructor");
8521     return oc_implicit_copy_constructor;
8522   }
8523 
8524   if (CXXMethodDecl *Meth = dyn_cast<CXXMethodDecl>(Fn)) {
8525     // This actually gets spelled 'candidate function' for now, but
8526     // it doesn't hurt to split it out.
8527     if (!Meth->isImplicit())
8528       return isTemplate ? oc_method_template : oc_method;
8529 
8530     if (Meth->isMoveAssignmentOperator())
8531       return oc_implicit_move_assignment;
8532 
8533     if (Meth->isCopyAssignmentOperator())
8534       return oc_implicit_copy_assignment;
8535 
8536     assert(isa<CXXConversionDecl>(Meth) && "expected conversion");
8537     return oc_method;
8538   }
8539 
8540   return isTemplate ? oc_function_template : oc_function;
8541 }
8542 
8543 void MaybeEmitInheritedConstructorNote(Sema &S, Decl *Fn) {
8544   const CXXConstructorDecl *Ctor = dyn_cast<CXXConstructorDecl>(Fn);
8545   if (!Ctor) return;
8546 
8547   Ctor = Ctor->getInheritedConstructor();
8548   if (!Ctor) return;
8549 
8550   S.Diag(Ctor->getLocation(), diag::note_ovl_candidate_inherited_constructor);
8551 }
8552 
8553 } // end anonymous namespace
8554 
8555 // Notes the location of an overload candidate.
8556 void Sema::NoteOverloadCandidate(FunctionDecl *Fn, QualType DestType) {
8557   std::string FnDesc;
8558   OverloadCandidateKind K = ClassifyOverloadCandidate(*this, Fn, FnDesc);
8559   PartialDiagnostic PD = PDiag(diag::note_ovl_candidate)
8560                              << (unsigned) K << FnDesc;
8561   HandleFunctionTypeMismatch(PD, Fn->getType(), DestType);
8562   Diag(Fn->getLocation(), PD);
8563   MaybeEmitInheritedConstructorNote(*this, Fn);
8564 }
8565 
8566 // Notes the location of all overload candidates designated through
8567 // OverloadedExpr
8568 void Sema::NoteAllOverloadCandidates(Expr* OverloadedExpr, QualType DestType) {
8569   assert(OverloadedExpr->getType() == Context.OverloadTy);
8570 
8571   OverloadExpr::FindResult Ovl = OverloadExpr::find(OverloadedExpr);
8572   OverloadExpr *OvlExpr = Ovl.Expression;
8573 
8574   for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
8575                             IEnd = OvlExpr->decls_end();
8576        I != IEnd; ++I) {
8577     if (FunctionTemplateDecl *FunTmpl =
8578                 dyn_cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl()) ) {
8579       NoteOverloadCandidate(FunTmpl->getTemplatedDecl(), DestType);
8580     } else if (FunctionDecl *Fun
8581                       = dyn_cast<FunctionDecl>((*I)->getUnderlyingDecl()) ) {
8582       NoteOverloadCandidate(Fun, DestType);
8583     }
8584   }
8585 }
8586 
8587 /// Diagnoses an ambiguous conversion.  The partial diagnostic is the
8588 /// "lead" diagnostic; it will be given two arguments, the source and
8589 /// target types of the conversion.
8590 void ImplicitConversionSequence::DiagnoseAmbiguousConversion(
8591                                  Sema &S,
8592                                  SourceLocation CaretLoc,
8593                                  const PartialDiagnostic &PDiag) const {
8594   S.Diag(CaretLoc, PDiag)
8595     << Ambiguous.getFromType() << Ambiguous.getToType();
8596   // FIXME: The note limiting machinery is borrowed from
8597   // OverloadCandidateSet::NoteCandidates; there's an opportunity for
8598   // refactoring here.
8599   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
8600   unsigned CandsShown = 0;
8601   AmbiguousConversionSequence::const_iterator I, E;
8602   for (I = Ambiguous.begin(), E = Ambiguous.end(); I != E; ++I) {
8603     if (CandsShown >= 4 && ShowOverloads == Ovl_Best)
8604       break;
8605     ++CandsShown;
8606     S.NoteOverloadCandidate(*I);
8607   }
8608   if (I != E)
8609     S.Diag(SourceLocation(), diag::note_ovl_too_many_candidates) << int(E - I);
8610 }
8611 
8612 namespace {
8613 
8614 void DiagnoseBadConversion(Sema &S, OverloadCandidate *Cand, unsigned I) {
8615   const ImplicitConversionSequence &Conv = Cand->Conversions[I];
8616   assert(Conv.isBad());
8617   assert(Cand->Function && "for now, candidate must be a function");
8618   FunctionDecl *Fn = Cand->Function;
8619 
8620   // There's a conversion slot for the object argument if this is a
8621   // non-constructor method.  Note that 'I' corresponds the
8622   // conversion-slot index.
8623   bool isObjectArgument = false;
8624   if (isa<CXXMethodDecl>(Fn) && !isa<CXXConstructorDecl>(Fn)) {
8625     if (I == 0)
8626       isObjectArgument = true;
8627     else
8628       I--;
8629   }
8630 
8631   std::string FnDesc;
8632   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, FnDesc);
8633 
8634   Expr *FromExpr = Conv.Bad.FromExpr;
8635   QualType FromTy = Conv.Bad.getFromType();
8636   QualType ToTy = Conv.Bad.getToType();
8637 
8638   if (FromTy == S.Context.OverloadTy) {
8639     assert(FromExpr && "overload set argument came from implicit argument?");
8640     Expr *E = FromExpr->IgnoreParens();
8641     if (isa<UnaryOperator>(E))
8642       E = cast<UnaryOperator>(E)->getSubExpr()->IgnoreParens();
8643     DeclarationName Name = cast<OverloadExpr>(E)->getName();
8644 
8645     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_overload)
8646       << (unsigned) FnKind << FnDesc
8647       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8648       << ToTy << Name << I+1;
8649     MaybeEmitInheritedConstructorNote(S, Fn);
8650     return;
8651   }
8652 
8653   // Do some hand-waving analysis to see if the non-viability is due
8654   // to a qualifier mismatch.
8655   CanQualType CFromTy = S.Context.getCanonicalType(FromTy);
8656   CanQualType CToTy = S.Context.getCanonicalType(ToTy);
8657   if (CanQual<ReferenceType> RT = CToTy->getAs<ReferenceType>())
8658     CToTy = RT->getPointeeType();
8659   else {
8660     // TODO: detect and diagnose the full richness of const mismatches.
8661     if (CanQual<PointerType> FromPT = CFromTy->getAs<PointerType>())
8662       if (CanQual<PointerType> ToPT = CToTy->getAs<PointerType>())
8663         CFromTy = FromPT->getPointeeType(), CToTy = ToPT->getPointeeType();
8664   }
8665 
8666   if (CToTy.getUnqualifiedType() == CFromTy.getUnqualifiedType() &&
8667       !CToTy.isAtLeastAsQualifiedAs(CFromTy)) {
8668     Qualifiers FromQs = CFromTy.getQualifiers();
8669     Qualifiers ToQs = CToTy.getQualifiers();
8670 
8671     if (FromQs.getAddressSpace() != ToQs.getAddressSpace()) {
8672       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_addrspace)
8673         << (unsigned) FnKind << FnDesc
8674         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8675         << FromTy
8676         << FromQs.getAddressSpace() << ToQs.getAddressSpace()
8677         << (unsigned) isObjectArgument << I+1;
8678       MaybeEmitInheritedConstructorNote(S, Fn);
8679       return;
8680     }
8681 
8682     if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
8683       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_ownership)
8684         << (unsigned) FnKind << FnDesc
8685         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8686         << FromTy
8687         << FromQs.getObjCLifetime() << ToQs.getObjCLifetime()
8688         << (unsigned) isObjectArgument << I+1;
8689       MaybeEmitInheritedConstructorNote(S, Fn);
8690       return;
8691     }
8692 
8693     if (FromQs.getObjCGCAttr() != ToQs.getObjCGCAttr()) {
8694       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_gc)
8695       << (unsigned) FnKind << FnDesc
8696       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8697       << FromTy
8698       << FromQs.getObjCGCAttr() << ToQs.getObjCGCAttr()
8699       << (unsigned) isObjectArgument << I+1;
8700       MaybeEmitInheritedConstructorNote(S, Fn);
8701       return;
8702     }
8703 
8704     unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
8705     assert(CVR && "unexpected qualifiers mismatch");
8706 
8707     if (isObjectArgument) {
8708       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr_this)
8709         << (unsigned) FnKind << FnDesc
8710         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8711         << FromTy << (CVR - 1);
8712     } else {
8713       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr)
8714         << (unsigned) FnKind << FnDesc
8715         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8716         << FromTy << (CVR - 1) << I+1;
8717     }
8718     MaybeEmitInheritedConstructorNote(S, Fn);
8719     return;
8720   }
8721 
8722   // Special diagnostic for failure to convert an initializer list, since
8723   // telling the user that it has type void is not useful.
8724   if (FromExpr && isa<InitListExpr>(FromExpr)) {
8725     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_list_argument)
8726       << (unsigned) FnKind << FnDesc
8727       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8728       << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8729     MaybeEmitInheritedConstructorNote(S, Fn);
8730     return;
8731   }
8732 
8733   // Diagnose references or pointers to incomplete types differently,
8734   // since it's far from impossible that the incompleteness triggered
8735   // the failure.
8736   QualType TempFromTy = FromTy.getNonReferenceType();
8737   if (const PointerType *PTy = TempFromTy->getAs<PointerType>())
8738     TempFromTy = PTy->getPointeeType();
8739   if (TempFromTy->isIncompleteType()) {
8740     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_conv_incomplete)
8741       << (unsigned) FnKind << FnDesc
8742       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8743       << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8744     MaybeEmitInheritedConstructorNote(S, Fn);
8745     return;
8746   }
8747 
8748   // Diagnose base -> derived pointer conversions.
8749   unsigned BaseToDerivedConversion = 0;
8750   if (const PointerType *FromPtrTy = FromTy->getAs<PointerType>()) {
8751     if (const PointerType *ToPtrTy = ToTy->getAs<PointerType>()) {
8752       if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
8753                                                FromPtrTy->getPointeeType()) &&
8754           !FromPtrTy->getPointeeType()->isIncompleteType() &&
8755           !ToPtrTy->getPointeeType()->isIncompleteType() &&
8756           S.IsDerivedFrom(ToPtrTy->getPointeeType(),
8757                           FromPtrTy->getPointeeType()))
8758         BaseToDerivedConversion = 1;
8759     }
8760   } else if (const ObjCObjectPointerType *FromPtrTy
8761                                     = FromTy->getAs<ObjCObjectPointerType>()) {
8762     if (const ObjCObjectPointerType *ToPtrTy
8763                                         = ToTy->getAs<ObjCObjectPointerType>())
8764       if (const ObjCInterfaceDecl *FromIface = FromPtrTy->getInterfaceDecl())
8765         if (const ObjCInterfaceDecl *ToIface = ToPtrTy->getInterfaceDecl())
8766           if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
8767                                                 FromPtrTy->getPointeeType()) &&
8768               FromIface->isSuperClassOf(ToIface))
8769             BaseToDerivedConversion = 2;
8770   } else if (const ReferenceType *ToRefTy = ToTy->getAs<ReferenceType>()) {
8771     if (ToRefTy->getPointeeType().isAtLeastAsQualifiedAs(FromTy) &&
8772         !FromTy->isIncompleteType() &&
8773         !ToRefTy->getPointeeType()->isIncompleteType() &&
8774         S.IsDerivedFrom(ToRefTy->getPointeeType(), FromTy)) {
8775       BaseToDerivedConversion = 3;
8776     } else if (ToTy->isLValueReferenceType() && !FromExpr->isLValue() &&
8777                ToTy.getNonReferenceType().getCanonicalType() ==
8778                FromTy.getNonReferenceType().getCanonicalType()) {
8779       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_lvalue)
8780         << (unsigned) FnKind << FnDesc
8781         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8782         << (unsigned) isObjectArgument << I + 1;
8783       MaybeEmitInheritedConstructorNote(S, Fn);
8784       return;
8785     }
8786   }
8787 
8788   if (BaseToDerivedConversion) {
8789     S.Diag(Fn->getLocation(),
8790            diag::note_ovl_candidate_bad_base_to_derived_conv)
8791       << (unsigned) FnKind << FnDesc
8792       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8793       << (BaseToDerivedConversion - 1)
8794       << FromTy << ToTy << I+1;
8795     MaybeEmitInheritedConstructorNote(S, Fn);
8796     return;
8797   }
8798 
8799   if (isa<ObjCObjectPointerType>(CFromTy) &&
8800       isa<PointerType>(CToTy)) {
8801       Qualifiers FromQs = CFromTy.getQualifiers();
8802       Qualifiers ToQs = CToTy.getQualifiers();
8803       if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
8804         S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_arc_conv)
8805         << (unsigned) FnKind << FnDesc
8806         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8807         << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8808         MaybeEmitInheritedConstructorNote(S, Fn);
8809         return;
8810       }
8811   }
8812 
8813   // Emit the generic diagnostic and, optionally, add the hints to it.
8814   PartialDiagnostic FDiag = S.PDiag(diag::note_ovl_candidate_bad_conv);
8815   FDiag << (unsigned) FnKind << FnDesc
8816     << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8817     << FromTy << ToTy << (unsigned) isObjectArgument << I + 1
8818     << (unsigned) (Cand->Fix.Kind);
8819 
8820   // If we can fix the conversion, suggest the FixIts.
8821   for (std::vector<FixItHint>::iterator HI = Cand->Fix.Hints.begin(),
8822        HE = Cand->Fix.Hints.end(); HI != HE; ++HI)
8823     FDiag << *HI;
8824   S.Diag(Fn->getLocation(), FDiag);
8825 
8826   MaybeEmitInheritedConstructorNote(S, Fn);
8827 }
8828 
8829 /// Additional arity mismatch diagnosis specific to a function overload
8830 /// candidates. This is not covered by the more general DiagnoseArityMismatch()
8831 /// over a candidate in any candidate set.
8832 bool CheckArityMismatch(Sema &S, OverloadCandidate *Cand,
8833                         unsigned NumArgs) {
8834   FunctionDecl *Fn = Cand->Function;
8835   unsigned MinParams = Fn->getMinRequiredArguments();
8836 
8837   // With invalid overloaded operators, it's possible that we think we
8838   // have an arity mismatch when in fact it looks like we have the
8839   // right number of arguments, because only overloaded operators have
8840   // the weird behavior of overloading member and non-member functions.
8841   // Just don't report anything.
8842   if (Fn->isInvalidDecl() &&
8843       Fn->getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
8844     return true;
8845 
8846   if (NumArgs < MinParams) {
8847     assert((Cand->FailureKind == ovl_fail_too_few_arguments) ||
8848            (Cand->FailureKind == ovl_fail_bad_deduction &&
8849             Cand->DeductionFailure.Result == Sema::TDK_TooFewArguments));
8850   } else {
8851     assert((Cand->FailureKind == ovl_fail_too_many_arguments) ||
8852            (Cand->FailureKind == ovl_fail_bad_deduction &&
8853             Cand->DeductionFailure.Result == Sema::TDK_TooManyArguments));
8854   }
8855 
8856   return false;
8857 }
8858 
8859 /// General arity mismatch diagnosis over a candidate in a candidate set.
8860 void DiagnoseArityMismatch(Sema &S, Decl *D, unsigned NumFormalArgs) {
8861   assert(isa<FunctionDecl>(D) &&
8862       "The templated declaration should at least be a function"
8863       " when diagnosing bad template argument deduction due to too many"
8864       " or too few arguments");
8865 
8866   FunctionDecl *Fn = cast<FunctionDecl>(D);
8867 
8868   // TODO: treat calls to a missing default constructor as a special case
8869   const FunctionProtoType *FnTy = Fn->getType()->getAs<FunctionProtoType>();
8870   unsigned MinParams = Fn->getMinRequiredArguments();
8871 
8872   // at least / at most / exactly
8873   unsigned mode, modeCount;
8874   if (NumFormalArgs < MinParams) {
8875     if (MinParams != FnTy->getNumParams() || FnTy->isVariadic() ||
8876         FnTy->isTemplateVariadic())
8877       mode = 0; // "at least"
8878     else
8879       mode = 2; // "exactly"
8880     modeCount = MinParams;
8881   } else {
8882     if (MinParams != FnTy->getNumParams())
8883       mode = 1; // "at most"
8884     else
8885       mode = 2; // "exactly"
8886     modeCount = FnTy->getNumParams();
8887   }
8888 
8889   std::string Description;
8890   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, Description);
8891 
8892   if (modeCount == 1 && Fn->getParamDecl(0)->getDeclName())
8893     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity_one)
8894       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != nullptr)
8895       << mode << Fn->getParamDecl(0) << NumFormalArgs;
8896   else
8897     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity)
8898       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != nullptr)
8899       << mode << modeCount << NumFormalArgs;
8900   MaybeEmitInheritedConstructorNote(S, Fn);
8901 }
8902 
8903 /// Arity mismatch diagnosis specific to a function overload candidate.
8904 void DiagnoseArityMismatch(Sema &S, OverloadCandidate *Cand,
8905                            unsigned NumFormalArgs) {
8906   if (!CheckArityMismatch(S, Cand, NumFormalArgs))
8907     DiagnoseArityMismatch(S, Cand->Function, NumFormalArgs);
8908 }
8909 
8910 TemplateDecl *getDescribedTemplate(Decl *Templated) {
8911   if (FunctionDecl *FD = dyn_cast<FunctionDecl>(Templated))
8912     return FD->getDescribedFunctionTemplate();
8913   else if (CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(Templated))
8914     return RD->getDescribedClassTemplate();
8915 
8916   llvm_unreachable("Unsupported: Getting the described template declaration"
8917                    " for bad deduction diagnosis");
8918 }
8919 
8920 /// Diagnose a failed template-argument deduction.
8921 void DiagnoseBadDeduction(Sema &S, Decl *Templated,
8922                           DeductionFailureInfo &DeductionFailure,
8923                           unsigned NumArgs) {
8924   TemplateParameter Param = DeductionFailure.getTemplateParameter();
8925   NamedDecl *ParamD;
8926   (ParamD = Param.dyn_cast<TemplateTypeParmDecl*>()) ||
8927   (ParamD = Param.dyn_cast<NonTypeTemplateParmDecl*>()) ||
8928   (ParamD = Param.dyn_cast<TemplateTemplateParmDecl*>());
8929   switch (DeductionFailure.Result) {
8930   case Sema::TDK_Success:
8931     llvm_unreachable("TDK_success while diagnosing bad deduction");
8932 
8933   case Sema::TDK_Incomplete: {
8934     assert(ParamD && "no parameter found for incomplete deduction result");
8935     S.Diag(Templated->getLocation(),
8936            diag::note_ovl_candidate_incomplete_deduction)
8937         << ParamD->getDeclName();
8938     MaybeEmitInheritedConstructorNote(S, Templated);
8939     return;
8940   }
8941 
8942   case Sema::TDK_Underqualified: {
8943     assert(ParamD && "no parameter found for bad qualifiers deduction result");
8944     TemplateTypeParmDecl *TParam = cast<TemplateTypeParmDecl>(ParamD);
8945 
8946     QualType Param = DeductionFailure.getFirstArg()->getAsType();
8947 
8948     // Param will have been canonicalized, but it should just be a
8949     // qualified version of ParamD, so move the qualifiers to that.
8950     QualifierCollector Qs;
8951     Qs.strip(Param);
8952     QualType NonCanonParam = Qs.apply(S.Context, TParam->getTypeForDecl());
8953     assert(S.Context.hasSameType(Param, NonCanonParam));
8954 
8955     // Arg has also been canonicalized, but there's nothing we can do
8956     // about that.  It also doesn't matter as much, because it won't
8957     // have any template parameters in it (because deduction isn't
8958     // done on dependent types).
8959     QualType Arg = DeductionFailure.getSecondArg()->getAsType();
8960 
8961     S.Diag(Templated->getLocation(), diag::note_ovl_candidate_underqualified)
8962         << ParamD->getDeclName() << Arg << NonCanonParam;
8963     MaybeEmitInheritedConstructorNote(S, Templated);
8964     return;
8965   }
8966 
8967   case Sema::TDK_Inconsistent: {
8968     assert(ParamD && "no parameter found for inconsistent deduction result");
8969     int which = 0;
8970     if (isa<TemplateTypeParmDecl>(ParamD))
8971       which = 0;
8972     else if (isa<NonTypeTemplateParmDecl>(ParamD))
8973       which = 1;
8974     else {
8975       which = 2;
8976     }
8977 
8978     S.Diag(Templated->getLocation(),
8979            diag::note_ovl_candidate_inconsistent_deduction)
8980         << which << ParamD->getDeclName() << *DeductionFailure.getFirstArg()
8981         << *DeductionFailure.getSecondArg();
8982     MaybeEmitInheritedConstructorNote(S, Templated);
8983     return;
8984   }
8985 
8986   case Sema::TDK_InvalidExplicitArguments:
8987     assert(ParamD && "no parameter found for invalid explicit arguments");
8988     if (ParamD->getDeclName())
8989       S.Diag(Templated->getLocation(),
8990              diag::note_ovl_candidate_explicit_arg_mismatch_named)
8991           << ParamD->getDeclName();
8992     else {
8993       int index = 0;
8994       if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(ParamD))
8995         index = TTP->getIndex();
8996       else if (NonTypeTemplateParmDecl *NTTP
8997                                   = dyn_cast<NonTypeTemplateParmDecl>(ParamD))
8998         index = NTTP->getIndex();
8999       else
9000         index = cast<TemplateTemplateParmDecl>(ParamD)->getIndex();
9001       S.Diag(Templated->getLocation(),
9002              diag::note_ovl_candidate_explicit_arg_mismatch_unnamed)
9003           << (index + 1);
9004     }
9005     MaybeEmitInheritedConstructorNote(S, Templated);
9006     return;
9007 
9008   case Sema::TDK_TooManyArguments:
9009   case Sema::TDK_TooFewArguments:
9010     DiagnoseArityMismatch(S, Templated, NumArgs);
9011     return;
9012 
9013   case Sema::TDK_InstantiationDepth:
9014     S.Diag(Templated->getLocation(),
9015            diag::note_ovl_candidate_instantiation_depth);
9016     MaybeEmitInheritedConstructorNote(S, Templated);
9017     return;
9018 
9019   case Sema::TDK_SubstitutionFailure: {
9020     // Format the template argument list into the argument string.
9021     SmallString<128> TemplateArgString;
9022     if (TemplateArgumentList *Args =
9023             DeductionFailure.getTemplateArgumentList()) {
9024       TemplateArgString = " ";
9025       TemplateArgString += S.getTemplateArgumentBindingsText(
9026           getDescribedTemplate(Templated)->getTemplateParameters(), *Args);
9027     }
9028 
9029     // If this candidate was disabled by enable_if, say so.
9030     PartialDiagnosticAt *PDiag = DeductionFailure.getSFINAEDiagnostic();
9031     if (PDiag && PDiag->second.getDiagID() ==
9032           diag::err_typename_nested_not_found_enable_if) {
9033       // FIXME: Use the source range of the condition, and the fully-qualified
9034       //        name of the enable_if template. These are both present in PDiag.
9035       S.Diag(PDiag->first, diag::note_ovl_candidate_disabled_by_enable_if)
9036         << "'enable_if'" << TemplateArgString;
9037       return;
9038     }
9039 
9040     // Format the SFINAE diagnostic into the argument string.
9041     // FIXME: Add a general mechanism to include a PartialDiagnostic *'s
9042     //        formatted message in another diagnostic.
9043     SmallString<128> SFINAEArgString;
9044     SourceRange R;
9045     if (PDiag) {
9046       SFINAEArgString = ": ";
9047       R = SourceRange(PDiag->first, PDiag->first);
9048       PDiag->second.EmitToString(S.getDiagnostics(), SFINAEArgString);
9049     }
9050 
9051     S.Diag(Templated->getLocation(),
9052            diag::note_ovl_candidate_substitution_failure)
9053         << TemplateArgString << SFINAEArgString << R;
9054     MaybeEmitInheritedConstructorNote(S, Templated);
9055     return;
9056   }
9057 
9058   case Sema::TDK_FailedOverloadResolution: {
9059     OverloadExpr::FindResult R = OverloadExpr::find(DeductionFailure.getExpr());
9060     S.Diag(Templated->getLocation(),
9061            diag::note_ovl_candidate_failed_overload_resolution)
9062         << R.Expression->getName();
9063     return;
9064   }
9065 
9066   case Sema::TDK_NonDeducedMismatch: {
9067     // FIXME: Provide a source location to indicate what we couldn't match.
9068     TemplateArgument FirstTA = *DeductionFailure.getFirstArg();
9069     TemplateArgument SecondTA = *DeductionFailure.getSecondArg();
9070     if (FirstTA.getKind() == TemplateArgument::Template &&
9071         SecondTA.getKind() == TemplateArgument::Template) {
9072       TemplateName FirstTN = FirstTA.getAsTemplate();
9073       TemplateName SecondTN = SecondTA.getAsTemplate();
9074       if (FirstTN.getKind() == TemplateName::Template &&
9075           SecondTN.getKind() == TemplateName::Template) {
9076         if (FirstTN.getAsTemplateDecl()->getName() ==
9077             SecondTN.getAsTemplateDecl()->getName()) {
9078           // FIXME: This fixes a bad diagnostic where both templates are named
9079           // the same.  This particular case is a bit difficult since:
9080           // 1) It is passed as a string to the diagnostic printer.
9081           // 2) The diagnostic printer only attempts to find a better
9082           //    name for types, not decls.
9083           // Ideally, this should folded into the diagnostic printer.
9084           S.Diag(Templated->getLocation(),
9085                  diag::note_ovl_candidate_non_deduced_mismatch_qualified)
9086               << FirstTN.getAsTemplateDecl() << SecondTN.getAsTemplateDecl();
9087           return;
9088         }
9089       }
9090     }
9091     // FIXME: For generic lambda parameters, check if the function is a lambda
9092     // call operator, and if so, emit a prettier and more informative
9093     // diagnostic that mentions 'auto' and lambda in addition to
9094     // (or instead of?) the canonical template type parameters.
9095     S.Diag(Templated->getLocation(),
9096            diag::note_ovl_candidate_non_deduced_mismatch)
9097         << FirstTA << SecondTA;
9098     return;
9099   }
9100   // TODO: diagnose these individually, then kill off
9101   // note_ovl_candidate_bad_deduction, which is uselessly vague.
9102   case Sema::TDK_MiscellaneousDeductionFailure:
9103     S.Diag(Templated->getLocation(), diag::note_ovl_candidate_bad_deduction);
9104     MaybeEmitInheritedConstructorNote(S, Templated);
9105     return;
9106   }
9107 }
9108 
9109 /// Diagnose a failed template-argument deduction, for function calls.
9110 void DiagnoseBadDeduction(Sema &S, OverloadCandidate *Cand, unsigned NumArgs) {
9111   unsigned TDK = Cand->DeductionFailure.Result;
9112   if (TDK == Sema::TDK_TooFewArguments || TDK == Sema::TDK_TooManyArguments) {
9113     if (CheckArityMismatch(S, Cand, NumArgs))
9114       return;
9115   }
9116   DiagnoseBadDeduction(S, Cand->Function, // pattern
9117                        Cand->DeductionFailure, NumArgs);
9118 }
9119 
9120 /// CUDA: diagnose an invalid call across targets.
9121 void DiagnoseBadTarget(Sema &S, OverloadCandidate *Cand) {
9122   FunctionDecl *Caller = cast<FunctionDecl>(S.CurContext);
9123   FunctionDecl *Callee = Cand->Function;
9124 
9125   Sema::CUDAFunctionTarget CallerTarget = S.IdentifyCUDATarget(Caller),
9126                            CalleeTarget = S.IdentifyCUDATarget(Callee);
9127 
9128   std::string FnDesc;
9129   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Callee, FnDesc);
9130 
9131   S.Diag(Callee->getLocation(), diag::note_ovl_candidate_bad_target)
9132       << (unsigned) FnKind << CalleeTarget << CallerTarget;
9133 }
9134 
9135 void DiagnoseFailedEnableIfAttr(Sema &S, OverloadCandidate *Cand) {
9136   FunctionDecl *Callee = Cand->Function;
9137   EnableIfAttr *Attr = static_cast<EnableIfAttr*>(Cand->DeductionFailure.Data);
9138 
9139   S.Diag(Callee->getLocation(),
9140          diag::note_ovl_candidate_disabled_by_enable_if_attr)
9141       << Attr->getCond()->getSourceRange() << Attr->getMessage();
9142 }
9143 
9144 /// Generates a 'note' diagnostic for an overload candidate.  We've
9145 /// already generated a primary error at the call site.
9146 ///
9147 /// It really does need to be a single diagnostic with its caret
9148 /// pointed at the candidate declaration.  Yes, this creates some
9149 /// major challenges of technical writing.  Yes, this makes pointing
9150 /// out problems with specific arguments quite awkward.  It's still
9151 /// better than generating twenty screens of text for every failed
9152 /// overload.
9153 ///
9154 /// It would be great to be able to express per-candidate problems
9155 /// more richly for those diagnostic clients that cared, but we'd
9156 /// still have to be just as careful with the default diagnostics.
9157 void NoteFunctionCandidate(Sema &S, OverloadCandidate *Cand,
9158                            unsigned NumArgs) {
9159   FunctionDecl *Fn = Cand->Function;
9160 
9161   // Note deleted candidates, but only if they're viable.
9162   if (Cand->Viable && (Fn->isDeleted() ||
9163       S.isFunctionConsideredUnavailable(Fn))) {
9164     std::string FnDesc;
9165     OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, FnDesc);
9166 
9167     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_deleted)
9168       << FnKind << FnDesc
9169       << (Fn->isDeleted() ? (Fn->isDeletedAsWritten() ? 1 : 2) : 0);
9170     MaybeEmitInheritedConstructorNote(S, Fn);
9171     return;
9172   }
9173 
9174   // We don't really have anything else to say about viable candidates.
9175   if (Cand->Viable) {
9176     S.NoteOverloadCandidate(Fn);
9177     return;
9178   }
9179 
9180   switch (Cand->FailureKind) {
9181   case ovl_fail_too_many_arguments:
9182   case ovl_fail_too_few_arguments:
9183     return DiagnoseArityMismatch(S, Cand, NumArgs);
9184 
9185   case ovl_fail_bad_deduction:
9186     return DiagnoseBadDeduction(S, Cand, NumArgs);
9187 
9188   case ovl_fail_trivial_conversion:
9189   case ovl_fail_bad_final_conversion:
9190   case ovl_fail_final_conversion_not_exact:
9191     return S.NoteOverloadCandidate(Fn);
9192 
9193   case ovl_fail_bad_conversion: {
9194     unsigned I = (Cand->IgnoreObjectArgument ? 1 : 0);
9195     for (unsigned N = Cand->NumConversions; I != N; ++I)
9196       if (Cand->Conversions[I].isBad())
9197         return DiagnoseBadConversion(S, Cand, I);
9198 
9199     // FIXME: this currently happens when we're called from SemaInit
9200     // when user-conversion overload fails.  Figure out how to handle
9201     // those conditions and diagnose them well.
9202     return S.NoteOverloadCandidate(Fn);
9203   }
9204 
9205   case ovl_fail_bad_target:
9206     return DiagnoseBadTarget(S, Cand);
9207 
9208   case ovl_fail_enable_if:
9209     return DiagnoseFailedEnableIfAttr(S, Cand);
9210   }
9211 }
9212 
9213 void NoteSurrogateCandidate(Sema &S, OverloadCandidate *Cand) {
9214   // Desugar the type of the surrogate down to a function type,
9215   // retaining as many typedefs as possible while still showing
9216   // the function type (and, therefore, its parameter types).
9217   QualType FnType = Cand->Surrogate->getConversionType();
9218   bool isLValueReference = false;
9219   bool isRValueReference = false;
9220   bool isPointer = false;
9221   if (const LValueReferenceType *FnTypeRef =
9222         FnType->getAs<LValueReferenceType>()) {
9223     FnType = FnTypeRef->getPointeeType();
9224     isLValueReference = true;
9225   } else if (const RValueReferenceType *FnTypeRef =
9226                FnType->getAs<RValueReferenceType>()) {
9227     FnType = FnTypeRef->getPointeeType();
9228     isRValueReference = true;
9229   }
9230   if (const PointerType *FnTypePtr = FnType->getAs<PointerType>()) {
9231     FnType = FnTypePtr->getPointeeType();
9232     isPointer = true;
9233   }
9234   // Desugar down to a function type.
9235   FnType = QualType(FnType->getAs<FunctionType>(), 0);
9236   // Reconstruct the pointer/reference as appropriate.
9237   if (isPointer) FnType = S.Context.getPointerType(FnType);
9238   if (isRValueReference) FnType = S.Context.getRValueReferenceType(FnType);
9239   if (isLValueReference) FnType = S.Context.getLValueReferenceType(FnType);
9240 
9241   S.Diag(Cand->Surrogate->getLocation(), diag::note_ovl_surrogate_cand)
9242     << FnType;
9243   MaybeEmitInheritedConstructorNote(S, Cand->Surrogate);
9244 }
9245 
9246 void NoteBuiltinOperatorCandidate(Sema &S,
9247                                   StringRef Opc,
9248                                   SourceLocation OpLoc,
9249                                   OverloadCandidate *Cand) {
9250   assert(Cand->NumConversions <= 2 && "builtin operator is not binary");
9251   std::string TypeStr("operator");
9252   TypeStr += Opc;
9253   TypeStr += "(";
9254   TypeStr += Cand->BuiltinTypes.ParamTypes[0].getAsString();
9255   if (Cand->NumConversions == 1) {
9256     TypeStr += ")";
9257     S.Diag(OpLoc, diag::note_ovl_builtin_unary_candidate) << TypeStr;
9258   } else {
9259     TypeStr += ", ";
9260     TypeStr += Cand->BuiltinTypes.ParamTypes[1].getAsString();
9261     TypeStr += ")";
9262     S.Diag(OpLoc, diag::note_ovl_builtin_binary_candidate) << TypeStr;
9263   }
9264 }
9265 
9266 void NoteAmbiguousUserConversions(Sema &S, SourceLocation OpLoc,
9267                                   OverloadCandidate *Cand) {
9268   unsigned NoOperands = Cand->NumConversions;
9269   for (unsigned ArgIdx = 0; ArgIdx < NoOperands; ++ArgIdx) {
9270     const ImplicitConversionSequence &ICS = Cand->Conversions[ArgIdx];
9271     if (ICS.isBad()) break; // all meaningless after first invalid
9272     if (!ICS.isAmbiguous()) continue;
9273 
9274     ICS.DiagnoseAmbiguousConversion(S, OpLoc,
9275                               S.PDiag(diag::note_ambiguous_type_conversion));
9276   }
9277 }
9278 
9279 static SourceLocation GetLocationForCandidate(const OverloadCandidate *Cand) {
9280   if (Cand->Function)
9281     return Cand->Function->getLocation();
9282   if (Cand->IsSurrogate)
9283     return Cand->Surrogate->getLocation();
9284   return SourceLocation();
9285 }
9286 
9287 static unsigned RankDeductionFailure(const DeductionFailureInfo &DFI) {
9288   switch ((Sema::TemplateDeductionResult)DFI.Result) {
9289   case Sema::TDK_Success:
9290     llvm_unreachable("TDK_success while diagnosing bad deduction");
9291 
9292   case Sema::TDK_Invalid:
9293   case Sema::TDK_Incomplete:
9294     return 1;
9295 
9296   case Sema::TDK_Underqualified:
9297   case Sema::TDK_Inconsistent:
9298     return 2;
9299 
9300   case Sema::TDK_SubstitutionFailure:
9301   case Sema::TDK_NonDeducedMismatch:
9302   case Sema::TDK_MiscellaneousDeductionFailure:
9303     return 3;
9304 
9305   case Sema::TDK_InstantiationDepth:
9306   case Sema::TDK_FailedOverloadResolution:
9307     return 4;
9308 
9309   case Sema::TDK_InvalidExplicitArguments:
9310     return 5;
9311 
9312   case Sema::TDK_TooManyArguments:
9313   case Sema::TDK_TooFewArguments:
9314     return 6;
9315   }
9316   llvm_unreachable("Unhandled deduction result");
9317 }
9318 
9319 struct CompareOverloadCandidatesForDisplay {
9320   Sema &S;
9321   size_t NumArgs;
9322 
9323   CompareOverloadCandidatesForDisplay(Sema &S, size_t nArgs)
9324       : S(S), NumArgs(nArgs) {}
9325 
9326   bool operator()(const OverloadCandidate *L,
9327                   const OverloadCandidate *R) {
9328     // Fast-path this check.
9329     if (L == R) return false;
9330 
9331     // Order first by viability.
9332     if (L->Viable) {
9333       if (!R->Viable) return true;
9334 
9335       // TODO: introduce a tri-valued comparison for overload
9336       // candidates.  Would be more worthwhile if we had a sort
9337       // that could exploit it.
9338       if (isBetterOverloadCandidate(S, *L, *R, SourceLocation())) return true;
9339       if (isBetterOverloadCandidate(S, *R, *L, SourceLocation())) return false;
9340     } else if (R->Viable)
9341       return false;
9342 
9343     assert(L->Viable == R->Viable);
9344 
9345     // Criteria by which we can sort non-viable candidates:
9346     if (!L->Viable) {
9347       // 1. Arity mismatches come after other candidates.
9348       if (L->FailureKind == ovl_fail_too_many_arguments ||
9349           L->FailureKind == ovl_fail_too_few_arguments) {
9350         if (R->FailureKind == ovl_fail_too_many_arguments ||
9351             R->FailureKind == ovl_fail_too_few_arguments) {
9352           int LDist = std::abs((int)L->getNumParams() - (int)NumArgs);
9353           int RDist = std::abs((int)R->getNumParams() - (int)NumArgs);
9354           if (LDist == RDist) {
9355             if (L->FailureKind == R->FailureKind)
9356               // Sort non-surrogates before surrogates.
9357               return !L->IsSurrogate && R->IsSurrogate;
9358             // Sort candidates requiring fewer parameters than there were
9359             // arguments given after candidates requiring more parameters
9360             // than there were arguments given.
9361             return L->FailureKind == ovl_fail_too_many_arguments;
9362           }
9363           return LDist < RDist;
9364         }
9365         return false;
9366       }
9367       if (R->FailureKind == ovl_fail_too_many_arguments ||
9368           R->FailureKind == ovl_fail_too_few_arguments)
9369         return true;
9370 
9371       // 2. Bad conversions come first and are ordered by the number
9372       // of bad conversions and quality of good conversions.
9373       if (L->FailureKind == ovl_fail_bad_conversion) {
9374         if (R->FailureKind != ovl_fail_bad_conversion)
9375           return true;
9376 
9377         // The conversion that can be fixed with a smaller number of changes,
9378         // comes first.
9379         unsigned numLFixes = L->Fix.NumConversionsFixed;
9380         unsigned numRFixes = R->Fix.NumConversionsFixed;
9381         numLFixes = (numLFixes == 0) ? UINT_MAX : numLFixes;
9382         numRFixes = (numRFixes == 0) ? UINT_MAX : numRFixes;
9383         if (numLFixes != numRFixes) {
9384           if (numLFixes < numRFixes)
9385             return true;
9386           else
9387             return false;
9388         }
9389 
9390         // If there's any ordering between the defined conversions...
9391         // FIXME: this might not be transitive.
9392         assert(L->NumConversions == R->NumConversions);
9393 
9394         int leftBetter = 0;
9395         unsigned I = (L->IgnoreObjectArgument || R->IgnoreObjectArgument);
9396         for (unsigned E = L->NumConversions; I != E; ++I) {
9397           switch (CompareImplicitConversionSequences(S,
9398                                                      L->Conversions[I],
9399                                                      R->Conversions[I])) {
9400           case ImplicitConversionSequence::Better:
9401             leftBetter++;
9402             break;
9403 
9404           case ImplicitConversionSequence::Worse:
9405             leftBetter--;
9406             break;
9407 
9408           case ImplicitConversionSequence::Indistinguishable:
9409             break;
9410           }
9411         }
9412         if (leftBetter > 0) return true;
9413         if (leftBetter < 0) return false;
9414 
9415       } else if (R->FailureKind == ovl_fail_bad_conversion)
9416         return false;
9417 
9418       if (L->FailureKind == ovl_fail_bad_deduction) {
9419         if (R->FailureKind != ovl_fail_bad_deduction)
9420           return true;
9421 
9422         if (L->DeductionFailure.Result != R->DeductionFailure.Result)
9423           return RankDeductionFailure(L->DeductionFailure)
9424                < RankDeductionFailure(R->DeductionFailure);
9425       } else if (R->FailureKind == ovl_fail_bad_deduction)
9426         return false;
9427 
9428       // TODO: others?
9429     }
9430 
9431     // Sort everything else by location.
9432     SourceLocation LLoc = GetLocationForCandidate(L);
9433     SourceLocation RLoc = GetLocationForCandidate(R);
9434 
9435     // Put candidates without locations (e.g. builtins) at the end.
9436     if (LLoc.isInvalid()) return false;
9437     if (RLoc.isInvalid()) return true;
9438 
9439     return S.SourceMgr.isBeforeInTranslationUnit(LLoc, RLoc);
9440   }
9441 };
9442 
9443 /// CompleteNonViableCandidate - Normally, overload resolution only
9444 /// computes up to the first. Produces the FixIt set if possible.
9445 void CompleteNonViableCandidate(Sema &S, OverloadCandidate *Cand,
9446                                 ArrayRef<Expr *> Args) {
9447   assert(!Cand->Viable);
9448 
9449   // Don't do anything on failures other than bad conversion.
9450   if (Cand->FailureKind != ovl_fail_bad_conversion) return;
9451 
9452   // We only want the FixIts if all the arguments can be corrected.
9453   bool Unfixable = false;
9454   // Use a implicit copy initialization to check conversion fixes.
9455   Cand->Fix.setConversionChecker(TryCopyInitialization);
9456 
9457   // Skip forward to the first bad conversion.
9458   unsigned ConvIdx = (Cand->IgnoreObjectArgument ? 1 : 0);
9459   unsigned ConvCount = Cand->NumConversions;
9460   while (true) {
9461     assert(ConvIdx != ConvCount && "no bad conversion in candidate");
9462     ConvIdx++;
9463     if (Cand->Conversions[ConvIdx - 1].isBad()) {
9464       Unfixable = !Cand->TryToFixBadConversion(ConvIdx - 1, S);
9465       break;
9466     }
9467   }
9468 
9469   if (ConvIdx == ConvCount)
9470     return;
9471 
9472   assert(!Cand->Conversions[ConvIdx].isInitialized() &&
9473          "remaining conversion is initialized?");
9474 
9475   // FIXME: this should probably be preserved from the overload
9476   // operation somehow.
9477   bool SuppressUserConversions = false;
9478 
9479   const FunctionProtoType* Proto;
9480   unsigned ArgIdx = ConvIdx;
9481 
9482   if (Cand->IsSurrogate) {
9483     QualType ConvType
9484       = Cand->Surrogate->getConversionType().getNonReferenceType();
9485     if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
9486       ConvType = ConvPtrType->getPointeeType();
9487     Proto = ConvType->getAs<FunctionProtoType>();
9488     ArgIdx--;
9489   } else if (Cand->Function) {
9490     Proto = Cand->Function->getType()->getAs<FunctionProtoType>();
9491     if (isa<CXXMethodDecl>(Cand->Function) &&
9492         !isa<CXXConstructorDecl>(Cand->Function))
9493       ArgIdx--;
9494   } else {
9495     // Builtin binary operator with a bad first conversion.
9496     assert(ConvCount <= 3);
9497     for (; ConvIdx != ConvCount; ++ConvIdx)
9498       Cand->Conversions[ConvIdx]
9499         = TryCopyInitialization(S, Args[ConvIdx],
9500                                 Cand->BuiltinTypes.ParamTypes[ConvIdx],
9501                                 SuppressUserConversions,
9502                                 /*InOverloadResolution*/ true,
9503                                 /*AllowObjCWritebackConversion=*/
9504                                   S.getLangOpts().ObjCAutoRefCount);
9505     return;
9506   }
9507 
9508   // Fill in the rest of the conversions.
9509   unsigned NumParams = Proto->getNumParams();
9510   for (; ConvIdx != ConvCount; ++ConvIdx, ++ArgIdx) {
9511     if (ArgIdx < NumParams) {
9512       Cand->Conversions[ConvIdx] = TryCopyInitialization(
9513           S, Args[ArgIdx], Proto->getParamType(ArgIdx), SuppressUserConversions,
9514           /*InOverloadResolution=*/true,
9515           /*AllowObjCWritebackConversion=*/
9516           S.getLangOpts().ObjCAutoRefCount);
9517       // Store the FixIt in the candidate if it exists.
9518       if (!Unfixable && Cand->Conversions[ConvIdx].isBad())
9519         Unfixable = !Cand->TryToFixBadConversion(ConvIdx, S);
9520     }
9521     else
9522       Cand->Conversions[ConvIdx].setEllipsis();
9523   }
9524 }
9525 
9526 } // end anonymous namespace
9527 
9528 /// PrintOverloadCandidates - When overload resolution fails, prints
9529 /// diagnostic messages containing the candidates in the candidate
9530 /// set.
9531 void OverloadCandidateSet::NoteCandidates(Sema &S,
9532                                           OverloadCandidateDisplayKind OCD,
9533                                           ArrayRef<Expr *> Args,
9534                                           StringRef Opc,
9535                                           SourceLocation OpLoc) {
9536   // Sort the candidates by viability and position.  Sorting directly would
9537   // be prohibitive, so we make a set of pointers and sort those.
9538   SmallVector<OverloadCandidate*, 32> Cands;
9539   if (OCD == OCD_AllCandidates) Cands.reserve(size());
9540   for (iterator Cand = begin(), LastCand = end(); Cand != LastCand; ++Cand) {
9541     if (Cand->Viable)
9542       Cands.push_back(Cand);
9543     else if (OCD == OCD_AllCandidates) {
9544       CompleteNonViableCandidate(S, Cand, Args);
9545       if (Cand->Function || Cand->IsSurrogate)
9546         Cands.push_back(Cand);
9547       // Otherwise, this a non-viable builtin candidate.  We do not, in general,
9548       // want to list every possible builtin candidate.
9549     }
9550   }
9551 
9552   std::sort(Cands.begin(), Cands.end(),
9553             CompareOverloadCandidatesForDisplay(S, Args.size()));
9554 
9555   bool ReportedAmbiguousConversions = false;
9556 
9557   SmallVectorImpl<OverloadCandidate*>::iterator I, E;
9558   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
9559   unsigned CandsShown = 0;
9560   for (I = Cands.begin(), E = Cands.end(); I != E; ++I) {
9561     OverloadCandidate *Cand = *I;
9562 
9563     // Set an arbitrary limit on the number of candidate functions we'll spam
9564     // the user with.  FIXME: This limit should depend on details of the
9565     // candidate list.
9566     if (CandsShown >= 4 && ShowOverloads == Ovl_Best) {
9567       break;
9568     }
9569     ++CandsShown;
9570 
9571     if (Cand->Function)
9572       NoteFunctionCandidate(S, Cand, Args.size());
9573     else if (Cand->IsSurrogate)
9574       NoteSurrogateCandidate(S, Cand);
9575     else {
9576       assert(Cand->Viable &&
9577              "Non-viable built-in candidates are not added to Cands.");
9578       // Generally we only see ambiguities including viable builtin
9579       // operators if overload resolution got screwed up by an
9580       // ambiguous user-defined conversion.
9581       //
9582       // FIXME: It's quite possible for different conversions to see
9583       // different ambiguities, though.
9584       if (!ReportedAmbiguousConversions) {
9585         NoteAmbiguousUserConversions(S, OpLoc, Cand);
9586         ReportedAmbiguousConversions = true;
9587       }
9588 
9589       // If this is a viable builtin, print it.
9590       NoteBuiltinOperatorCandidate(S, Opc, OpLoc, Cand);
9591     }
9592   }
9593 
9594   if (I != E)
9595     S.Diag(OpLoc, diag::note_ovl_too_many_candidates) << int(E - I);
9596 }
9597 
9598 static SourceLocation
9599 GetLocationForCandidate(const TemplateSpecCandidate *Cand) {
9600   return Cand->Specialization ? Cand->Specialization->getLocation()
9601                               : SourceLocation();
9602 }
9603 
9604 struct CompareTemplateSpecCandidatesForDisplay {
9605   Sema &S;
9606   CompareTemplateSpecCandidatesForDisplay(Sema &S) : S(S) {}
9607 
9608   bool operator()(const TemplateSpecCandidate *L,
9609                   const TemplateSpecCandidate *R) {
9610     // Fast-path this check.
9611     if (L == R)
9612       return false;
9613 
9614     // Assuming that both candidates are not matches...
9615 
9616     // Sort by the ranking of deduction failures.
9617     if (L->DeductionFailure.Result != R->DeductionFailure.Result)
9618       return RankDeductionFailure(L->DeductionFailure) <
9619              RankDeductionFailure(R->DeductionFailure);
9620 
9621     // Sort everything else by location.
9622     SourceLocation LLoc = GetLocationForCandidate(L);
9623     SourceLocation RLoc = GetLocationForCandidate(R);
9624 
9625     // Put candidates without locations (e.g. builtins) at the end.
9626     if (LLoc.isInvalid())
9627       return false;
9628     if (RLoc.isInvalid())
9629       return true;
9630 
9631     return S.SourceMgr.isBeforeInTranslationUnit(LLoc, RLoc);
9632   }
9633 };
9634 
9635 /// Diagnose a template argument deduction failure.
9636 /// We are treating these failures as overload failures due to bad
9637 /// deductions.
9638 void TemplateSpecCandidate::NoteDeductionFailure(Sema &S) {
9639   DiagnoseBadDeduction(S, Specialization, // pattern
9640                        DeductionFailure, /*NumArgs=*/0);
9641 }
9642 
9643 void TemplateSpecCandidateSet::destroyCandidates() {
9644   for (iterator i = begin(), e = end(); i != e; ++i) {
9645     i->DeductionFailure.Destroy();
9646   }
9647 }
9648 
9649 void TemplateSpecCandidateSet::clear() {
9650   destroyCandidates();
9651   Candidates.clear();
9652 }
9653 
9654 /// NoteCandidates - When no template specialization match is found, prints
9655 /// diagnostic messages containing the non-matching specializations that form
9656 /// the candidate set.
9657 /// This is analoguous to OverloadCandidateSet::NoteCandidates() with
9658 /// OCD == OCD_AllCandidates and Cand->Viable == false.
9659 void TemplateSpecCandidateSet::NoteCandidates(Sema &S, SourceLocation Loc) {
9660   // Sort the candidates by position (assuming no candidate is a match).
9661   // Sorting directly would be prohibitive, so we make a set of pointers
9662   // and sort those.
9663   SmallVector<TemplateSpecCandidate *, 32> Cands;
9664   Cands.reserve(size());
9665   for (iterator Cand = begin(), LastCand = end(); Cand != LastCand; ++Cand) {
9666     if (Cand->Specialization)
9667       Cands.push_back(Cand);
9668     // Otherwise, this is a non-matching builtin candidate.  We do not,
9669     // in general, want to list every possible builtin candidate.
9670   }
9671 
9672   std::sort(Cands.begin(), Cands.end(),
9673             CompareTemplateSpecCandidatesForDisplay(S));
9674 
9675   // FIXME: Perhaps rename OverloadsShown and getShowOverloads()
9676   // for generalization purposes (?).
9677   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
9678 
9679   SmallVectorImpl<TemplateSpecCandidate *>::iterator I, E;
9680   unsigned CandsShown = 0;
9681   for (I = Cands.begin(), E = Cands.end(); I != E; ++I) {
9682     TemplateSpecCandidate *Cand = *I;
9683 
9684     // Set an arbitrary limit on the number of candidates we'll spam
9685     // the user with.  FIXME: This limit should depend on details of the
9686     // candidate list.
9687     if (CandsShown >= 4 && ShowOverloads == Ovl_Best)
9688       break;
9689     ++CandsShown;
9690 
9691     assert(Cand->Specialization &&
9692            "Non-matching built-in candidates are not added to Cands.");
9693     Cand->NoteDeductionFailure(S);
9694   }
9695 
9696   if (I != E)
9697     S.Diag(Loc, diag::note_ovl_too_many_candidates) << int(E - I);
9698 }
9699 
9700 // [PossiblyAFunctionType]  -->   [Return]
9701 // NonFunctionType --> NonFunctionType
9702 // R (A) --> R(A)
9703 // R (*)(A) --> R (A)
9704 // R (&)(A) --> R (A)
9705 // R (S::*)(A) --> R (A)
9706 QualType Sema::ExtractUnqualifiedFunctionType(QualType PossiblyAFunctionType) {
9707   QualType Ret = PossiblyAFunctionType;
9708   if (const PointerType *ToTypePtr =
9709     PossiblyAFunctionType->getAs<PointerType>())
9710     Ret = ToTypePtr->getPointeeType();
9711   else if (const ReferenceType *ToTypeRef =
9712     PossiblyAFunctionType->getAs<ReferenceType>())
9713     Ret = ToTypeRef->getPointeeType();
9714   else if (const MemberPointerType *MemTypePtr =
9715     PossiblyAFunctionType->getAs<MemberPointerType>())
9716     Ret = MemTypePtr->getPointeeType();
9717   Ret =
9718     Context.getCanonicalType(Ret).getUnqualifiedType();
9719   return Ret;
9720 }
9721 
9722 // A helper class to help with address of function resolution
9723 // - allows us to avoid passing around all those ugly parameters
9724 class AddressOfFunctionResolver
9725 {
9726   Sema& S;
9727   Expr* SourceExpr;
9728   const QualType& TargetType;
9729   QualType TargetFunctionType; // Extracted function type from target type
9730 
9731   bool Complain;
9732   //DeclAccessPair& ResultFunctionAccessPair;
9733   ASTContext& Context;
9734 
9735   bool TargetTypeIsNonStaticMemberFunction;
9736   bool FoundNonTemplateFunction;
9737   bool StaticMemberFunctionFromBoundPointer;
9738 
9739   OverloadExpr::FindResult OvlExprInfo;
9740   OverloadExpr *OvlExpr;
9741   TemplateArgumentListInfo OvlExplicitTemplateArgs;
9742   SmallVector<std::pair<DeclAccessPair, FunctionDecl*>, 4> Matches;
9743   TemplateSpecCandidateSet FailedCandidates;
9744 
9745 public:
9746   AddressOfFunctionResolver(Sema &S, Expr *SourceExpr,
9747                             const QualType &TargetType, bool Complain)
9748       : S(S), SourceExpr(SourceExpr), TargetType(TargetType),
9749         Complain(Complain), Context(S.getASTContext()),
9750         TargetTypeIsNonStaticMemberFunction(
9751             !!TargetType->getAs<MemberPointerType>()),
9752         FoundNonTemplateFunction(false),
9753         StaticMemberFunctionFromBoundPointer(false),
9754         OvlExprInfo(OverloadExpr::find(SourceExpr)),
9755         OvlExpr(OvlExprInfo.Expression),
9756         FailedCandidates(OvlExpr->getNameLoc()) {
9757     ExtractUnqualifiedFunctionTypeFromTargetType();
9758 
9759     if (TargetFunctionType->isFunctionType()) {
9760       if (UnresolvedMemberExpr *UME = dyn_cast<UnresolvedMemberExpr>(OvlExpr))
9761         if (!UME->isImplicitAccess() &&
9762             !S.ResolveSingleFunctionTemplateSpecialization(UME))
9763           StaticMemberFunctionFromBoundPointer = true;
9764     } else if (OvlExpr->hasExplicitTemplateArgs()) {
9765       DeclAccessPair dap;
9766       if (FunctionDecl *Fn = S.ResolveSingleFunctionTemplateSpecialization(
9767               OvlExpr, false, &dap)) {
9768         if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn))
9769           if (!Method->isStatic()) {
9770             // If the target type is a non-function type and the function found
9771             // is a non-static member function, pretend as if that was the
9772             // target, it's the only possible type to end up with.
9773             TargetTypeIsNonStaticMemberFunction = true;
9774 
9775             // And skip adding the function if its not in the proper form.
9776             // We'll diagnose this due to an empty set of functions.
9777             if (!OvlExprInfo.HasFormOfMemberPointer)
9778               return;
9779           }
9780 
9781         Matches.push_back(std::make_pair(dap, Fn));
9782       }
9783       return;
9784     }
9785 
9786     if (OvlExpr->hasExplicitTemplateArgs())
9787       OvlExpr->getExplicitTemplateArgs().copyInto(OvlExplicitTemplateArgs);
9788 
9789     if (FindAllFunctionsThatMatchTargetTypeExactly()) {
9790       // C++ [over.over]p4:
9791       //   If more than one function is selected, [...]
9792       if (Matches.size() > 1) {
9793         if (FoundNonTemplateFunction)
9794           EliminateAllTemplateMatches();
9795         else
9796           EliminateAllExceptMostSpecializedTemplate();
9797       }
9798     }
9799   }
9800 
9801 private:
9802   bool isTargetTypeAFunction() const {
9803     return TargetFunctionType->isFunctionType();
9804   }
9805 
9806   // [ToType]     [Return]
9807 
9808   // R (*)(A) --> R (A), IsNonStaticMemberFunction = false
9809   // R (&)(A) --> R (A), IsNonStaticMemberFunction = false
9810   // R (S::*)(A) --> R (A), IsNonStaticMemberFunction = true
9811   void inline ExtractUnqualifiedFunctionTypeFromTargetType() {
9812     TargetFunctionType = S.ExtractUnqualifiedFunctionType(TargetType);
9813   }
9814 
9815   // return true if any matching specializations were found
9816   bool AddMatchingTemplateFunction(FunctionTemplateDecl* FunctionTemplate,
9817                                    const DeclAccessPair& CurAccessFunPair) {
9818     if (CXXMethodDecl *Method
9819               = dyn_cast<CXXMethodDecl>(FunctionTemplate->getTemplatedDecl())) {
9820       // Skip non-static function templates when converting to pointer, and
9821       // static when converting to member pointer.
9822       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
9823         return false;
9824     }
9825     else if (TargetTypeIsNonStaticMemberFunction)
9826       return false;
9827 
9828     // C++ [over.over]p2:
9829     //   If the name is a function template, template argument deduction is
9830     //   done (14.8.2.2), and if the argument deduction succeeds, the
9831     //   resulting template argument list is used to generate a single
9832     //   function template specialization, which is added to the set of
9833     //   overloaded functions considered.
9834     FunctionDecl *Specialization = nullptr;
9835     TemplateDeductionInfo Info(FailedCandidates.getLocation());
9836     if (Sema::TemplateDeductionResult Result
9837           = S.DeduceTemplateArguments(FunctionTemplate,
9838                                       &OvlExplicitTemplateArgs,
9839                                       TargetFunctionType, Specialization,
9840                                       Info, /*InOverloadResolution=*/true)) {
9841       // Make a note of the failed deduction for diagnostics.
9842       FailedCandidates.addCandidate()
9843           .set(FunctionTemplate->getTemplatedDecl(),
9844                MakeDeductionFailureInfo(Context, Result, Info));
9845       return false;
9846     }
9847 
9848     // Template argument deduction ensures that we have an exact match or
9849     // compatible pointer-to-function arguments that would be adjusted by ICS.
9850     // This function template specicalization works.
9851     Specialization = cast<FunctionDecl>(Specialization->getCanonicalDecl());
9852     assert(S.isSameOrCompatibleFunctionType(
9853               Context.getCanonicalType(Specialization->getType()),
9854               Context.getCanonicalType(TargetFunctionType)));
9855     Matches.push_back(std::make_pair(CurAccessFunPair, Specialization));
9856     return true;
9857   }
9858 
9859   bool AddMatchingNonTemplateFunction(NamedDecl* Fn,
9860                                       const DeclAccessPair& CurAccessFunPair) {
9861     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
9862       // Skip non-static functions when converting to pointer, and static
9863       // when converting to member pointer.
9864       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
9865         return false;
9866     }
9867     else if (TargetTypeIsNonStaticMemberFunction)
9868       return false;
9869 
9870     if (FunctionDecl *FunDecl = dyn_cast<FunctionDecl>(Fn)) {
9871       if (S.getLangOpts().CUDA)
9872         if (FunctionDecl *Caller = dyn_cast<FunctionDecl>(S.CurContext))
9873           if (S.CheckCUDATarget(Caller, FunDecl))
9874             return false;
9875 
9876       // If any candidate has a placeholder return type, trigger its deduction
9877       // now.
9878       if (S.getLangOpts().CPlusPlus14 &&
9879           FunDecl->getReturnType()->isUndeducedType() &&
9880           S.DeduceReturnType(FunDecl, SourceExpr->getLocStart(), Complain))
9881         return false;
9882 
9883       QualType ResultTy;
9884       if (Context.hasSameUnqualifiedType(TargetFunctionType,
9885                                          FunDecl->getType()) ||
9886           S.IsNoReturnConversion(FunDecl->getType(), TargetFunctionType,
9887                                  ResultTy)) {
9888         Matches.push_back(std::make_pair(CurAccessFunPair,
9889           cast<FunctionDecl>(FunDecl->getCanonicalDecl())));
9890         FoundNonTemplateFunction = true;
9891         return true;
9892       }
9893     }
9894 
9895     return false;
9896   }
9897 
9898   bool FindAllFunctionsThatMatchTargetTypeExactly() {
9899     bool Ret = false;
9900 
9901     // If the overload expression doesn't have the form of a pointer to
9902     // member, don't try to convert it to a pointer-to-member type.
9903     if (IsInvalidFormOfPointerToMemberFunction())
9904       return false;
9905 
9906     for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
9907                                E = OvlExpr->decls_end();
9908          I != E; ++I) {
9909       // Look through any using declarations to find the underlying function.
9910       NamedDecl *Fn = (*I)->getUnderlyingDecl();
9911 
9912       // C++ [over.over]p3:
9913       //   Non-member functions and static member functions match
9914       //   targets of type "pointer-to-function" or "reference-to-function."
9915       //   Nonstatic member functions match targets of
9916       //   type "pointer-to-member-function."
9917       // Note that according to DR 247, the containing class does not matter.
9918       if (FunctionTemplateDecl *FunctionTemplate
9919                                         = dyn_cast<FunctionTemplateDecl>(Fn)) {
9920         if (AddMatchingTemplateFunction(FunctionTemplate, I.getPair()))
9921           Ret = true;
9922       }
9923       // If we have explicit template arguments supplied, skip non-templates.
9924       else if (!OvlExpr->hasExplicitTemplateArgs() &&
9925                AddMatchingNonTemplateFunction(Fn, I.getPair()))
9926         Ret = true;
9927     }
9928     assert(Ret || Matches.empty());
9929     return Ret;
9930   }
9931 
9932   void EliminateAllExceptMostSpecializedTemplate() {
9933     //   [...] and any given function template specialization F1 is
9934     //   eliminated if the set contains a second function template
9935     //   specialization whose function template is more specialized
9936     //   than the function template of F1 according to the partial
9937     //   ordering rules of 14.5.5.2.
9938 
9939     // The algorithm specified above is quadratic. We instead use a
9940     // two-pass algorithm (similar to the one used to identify the
9941     // best viable function in an overload set) that identifies the
9942     // best function template (if it exists).
9943 
9944     UnresolvedSet<4> MatchesCopy; // TODO: avoid!
9945     for (unsigned I = 0, E = Matches.size(); I != E; ++I)
9946       MatchesCopy.addDecl(Matches[I].second, Matches[I].first.getAccess());
9947 
9948     // TODO: It looks like FailedCandidates does not serve much purpose
9949     // here, since the no_viable diagnostic has index 0.
9950     UnresolvedSetIterator Result = S.getMostSpecialized(
9951         MatchesCopy.begin(), MatchesCopy.end(), FailedCandidates,
9952         SourceExpr->getLocStart(), S.PDiag(),
9953         S.PDiag(diag::err_addr_ovl_ambiguous) << Matches[0]
9954                                                      .second->getDeclName(),
9955         S.PDiag(diag::note_ovl_candidate) << (unsigned)oc_function_template,
9956         Complain, TargetFunctionType);
9957 
9958     if (Result != MatchesCopy.end()) {
9959       // Make it the first and only element
9960       Matches[0].first = Matches[Result - MatchesCopy.begin()].first;
9961       Matches[0].second = cast<FunctionDecl>(*Result);
9962       Matches.resize(1);
9963     }
9964   }
9965 
9966   void EliminateAllTemplateMatches() {
9967     //   [...] any function template specializations in the set are
9968     //   eliminated if the set also contains a non-template function, [...]
9969     for (unsigned I = 0, N = Matches.size(); I != N; ) {
9970       if (Matches[I].second->getPrimaryTemplate() == nullptr)
9971         ++I;
9972       else {
9973         Matches[I] = Matches[--N];
9974         Matches.set_size(N);
9975       }
9976     }
9977   }
9978 
9979 public:
9980   void ComplainNoMatchesFound() const {
9981     assert(Matches.empty());
9982     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_no_viable)
9983         << OvlExpr->getName() << TargetFunctionType
9984         << OvlExpr->getSourceRange();
9985     if (FailedCandidates.empty())
9986       S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType);
9987     else {
9988       // We have some deduction failure messages. Use them to diagnose
9989       // the function templates, and diagnose the non-template candidates
9990       // normally.
9991       for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
9992                                  IEnd = OvlExpr->decls_end();
9993            I != IEnd; ++I)
9994         if (FunctionDecl *Fun =
9995                 dyn_cast<FunctionDecl>((*I)->getUnderlyingDecl()))
9996           S.NoteOverloadCandidate(Fun, TargetFunctionType);
9997       FailedCandidates.NoteCandidates(S, OvlExpr->getLocStart());
9998     }
9999   }
10000 
10001   bool IsInvalidFormOfPointerToMemberFunction() const {
10002     return TargetTypeIsNonStaticMemberFunction &&
10003       !OvlExprInfo.HasFormOfMemberPointer;
10004   }
10005 
10006   void ComplainIsInvalidFormOfPointerToMemberFunction() const {
10007       // TODO: Should we condition this on whether any functions might
10008       // have matched, or is it more appropriate to do that in callers?
10009       // TODO: a fixit wouldn't hurt.
10010       S.Diag(OvlExpr->getNameLoc(), diag::err_addr_ovl_no_qualifier)
10011         << TargetType << OvlExpr->getSourceRange();
10012   }
10013 
10014   bool IsStaticMemberFunctionFromBoundPointer() const {
10015     return StaticMemberFunctionFromBoundPointer;
10016   }
10017 
10018   void ComplainIsStaticMemberFunctionFromBoundPointer() const {
10019     S.Diag(OvlExpr->getLocStart(),
10020            diag::err_invalid_form_pointer_member_function)
10021       << OvlExpr->getSourceRange();
10022   }
10023 
10024   void ComplainOfInvalidConversion() const {
10025     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_not_func_ptrref)
10026       << OvlExpr->getName() << TargetType;
10027   }
10028 
10029   void ComplainMultipleMatchesFound() const {
10030     assert(Matches.size() > 1);
10031     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_ambiguous)
10032       << OvlExpr->getName()
10033       << OvlExpr->getSourceRange();
10034     S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType);
10035   }
10036 
10037   bool hadMultipleCandidates() const { return (OvlExpr->getNumDecls() > 1); }
10038 
10039   int getNumMatches() const { return Matches.size(); }
10040 
10041   FunctionDecl* getMatchingFunctionDecl() const {
10042     if (Matches.size() != 1) return nullptr;
10043     return Matches[0].second;
10044   }
10045 
10046   const DeclAccessPair* getMatchingFunctionAccessPair() const {
10047     if (Matches.size() != 1) return nullptr;
10048     return &Matches[0].first;
10049   }
10050 };
10051 
10052 /// ResolveAddressOfOverloadedFunction - Try to resolve the address of
10053 /// an overloaded function (C++ [over.over]), where @p From is an
10054 /// expression with overloaded function type and @p ToType is the type
10055 /// we're trying to resolve to. For example:
10056 ///
10057 /// @code
10058 /// int f(double);
10059 /// int f(int);
10060 ///
10061 /// int (*pfd)(double) = f; // selects f(double)
10062 /// @endcode
10063 ///
10064 /// This routine returns the resulting FunctionDecl if it could be
10065 /// resolved, and NULL otherwise. When @p Complain is true, this
10066 /// routine will emit diagnostics if there is an error.
10067 FunctionDecl *
10068 Sema::ResolveAddressOfOverloadedFunction(Expr *AddressOfExpr,
10069                                          QualType TargetType,
10070                                          bool Complain,
10071                                          DeclAccessPair &FoundResult,
10072                                          bool *pHadMultipleCandidates) {
10073   assert(AddressOfExpr->getType() == Context.OverloadTy);
10074 
10075   AddressOfFunctionResolver Resolver(*this, AddressOfExpr, TargetType,
10076                                      Complain);
10077   int NumMatches = Resolver.getNumMatches();
10078   FunctionDecl *Fn = nullptr;
10079   if (NumMatches == 0 && Complain) {
10080     if (Resolver.IsInvalidFormOfPointerToMemberFunction())
10081       Resolver.ComplainIsInvalidFormOfPointerToMemberFunction();
10082     else
10083       Resolver.ComplainNoMatchesFound();
10084   }
10085   else if (NumMatches > 1 && Complain)
10086     Resolver.ComplainMultipleMatchesFound();
10087   else if (NumMatches == 1) {
10088     Fn = Resolver.getMatchingFunctionDecl();
10089     assert(Fn);
10090     FoundResult = *Resolver.getMatchingFunctionAccessPair();
10091     if (Complain) {
10092       if (Resolver.IsStaticMemberFunctionFromBoundPointer())
10093         Resolver.ComplainIsStaticMemberFunctionFromBoundPointer();
10094       else
10095         CheckAddressOfMemberAccess(AddressOfExpr, FoundResult);
10096     }
10097   }
10098 
10099   if (pHadMultipleCandidates)
10100     *pHadMultipleCandidates = Resolver.hadMultipleCandidates();
10101   return Fn;
10102 }
10103 
10104 /// \brief Given an expression that refers to an overloaded function, try to
10105 /// resolve that overloaded function expression down to a single function.
10106 ///
10107 /// This routine can only resolve template-ids that refer to a single function
10108 /// template, where that template-id refers to a single template whose template
10109 /// arguments are either provided by the template-id or have defaults,
10110 /// as described in C++0x [temp.arg.explicit]p3.
10111 ///
10112 /// If no template-ids are found, no diagnostics are emitted and NULL is
10113 /// returned.
10114 FunctionDecl *
10115 Sema::ResolveSingleFunctionTemplateSpecialization(OverloadExpr *ovl,
10116                                                   bool Complain,
10117                                                   DeclAccessPair *FoundResult) {
10118   // C++ [over.over]p1:
10119   //   [...] [Note: any redundant set of parentheses surrounding the
10120   //   overloaded function name is ignored (5.1). ]
10121   // C++ [over.over]p1:
10122   //   [...] The overloaded function name can be preceded by the &
10123   //   operator.
10124 
10125   // If we didn't actually find any template-ids, we're done.
10126   if (!ovl->hasExplicitTemplateArgs())
10127     return nullptr;
10128 
10129   TemplateArgumentListInfo ExplicitTemplateArgs;
10130   ovl->getExplicitTemplateArgs().copyInto(ExplicitTemplateArgs);
10131   TemplateSpecCandidateSet FailedCandidates(ovl->getNameLoc());
10132 
10133   // Look through all of the overloaded functions, searching for one
10134   // whose type matches exactly.
10135   FunctionDecl *Matched = nullptr;
10136   for (UnresolvedSetIterator I = ovl->decls_begin(),
10137          E = ovl->decls_end(); I != E; ++I) {
10138     // C++0x [temp.arg.explicit]p3:
10139     //   [...] In contexts where deduction is done and fails, or in contexts
10140     //   where deduction is not done, if a template argument list is
10141     //   specified and it, along with any default template arguments,
10142     //   identifies a single function template specialization, then the
10143     //   template-id is an lvalue for the function template specialization.
10144     FunctionTemplateDecl *FunctionTemplate
10145       = cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl());
10146 
10147     // C++ [over.over]p2:
10148     //   If the name is a function template, template argument deduction is
10149     //   done (14.8.2.2), and if the argument deduction succeeds, the
10150     //   resulting template argument list is used to generate a single
10151     //   function template specialization, which is added to the set of
10152     //   overloaded functions considered.
10153     FunctionDecl *Specialization = nullptr;
10154     TemplateDeductionInfo Info(FailedCandidates.getLocation());
10155     if (TemplateDeductionResult Result
10156           = DeduceTemplateArguments(FunctionTemplate, &ExplicitTemplateArgs,
10157                                     Specialization, Info,
10158                                     /*InOverloadResolution=*/true)) {
10159       // Make a note of the failed deduction for diagnostics.
10160       // TODO: Actually use the failed-deduction info?
10161       FailedCandidates.addCandidate()
10162           .set(FunctionTemplate->getTemplatedDecl(),
10163                MakeDeductionFailureInfo(Context, Result, Info));
10164       continue;
10165     }
10166 
10167     assert(Specialization && "no specialization and no error?");
10168 
10169     // Multiple matches; we can't resolve to a single declaration.
10170     if (Matched) {
10171       if (Complain) {
10172         Diag(ovl->getExprLoc(), diag::err_addr_ovl_ambiguous)
10173           << ovl->getName();
10174         NoteAllOverloadCandidates(ovl);
10175       }
10176       return nullptr;
10177     }
10178 
10179     Matched = Specialization;
10180     if (FoundResult) *FoundResult = I.getPair();
10181   }
10182 
10183   if (Matched && getLangOpts().CPlusPlus14 &&
10184       Matched->getReturnType()->isUndeducedType() &&
10185       DeduceReturnType(Matched, ovl->getExprLoc(), Complain))
10186     return nullptr;
10187 
10188   return Matched;
10189 }
10190 
10191 
10192 
10193 
10194 // Resolve and fix an overloaded expression that can be resolved
10195 // because it identifies a single function template specialization.
10196 //
10197 // Last three arguments should only be supplied if Complain = true
10198 //
10199 // Return true if it was logically possible to so resolve the
10200 // expression, regardless of whether or not it succeeded.  Always
10201 // returns true if 'complain' is set.
10202 bool Sema::ResolveAndFixSingleFunctionTemplateSpecialization(
10203                       ExprResult &SrcExpr, bool doFunctionPointerConverion,
10204                    bool complain, const SourceRange& OpRangeForComplaining,
10205                                            QualType DestTypeForComplaining,
10206                                             unsigned DiagIDForComplaining) {
10207   assert(SrcExpr.get()->getType() == Context.OverloadTy);
10208 
10209   OverloadExpr::FindResult ovl = OverloadExpr::find(SrcExpr.get());
10210 
10211   DeclAccessPair found;
10212   ExprResult SingleFunctionExpression;
10213   if (FunctionDecl *fn = ResolveSingleFunctionTemplateSpecialization(
10214                            ovl.Expression, /*complain*/ false, &found)) {
10215     if (DiagnoseUseOfDecl(fn, SrcExpr.get()->getLocStart())) {
10216       SrcExpr = ExprError();
10217       return true;
10218     }
10219 
10220     // It is only correct to resolve to an instance method if we're
10221     // resolving a form that's permitted to be a pointer to member.
10222     // Otherwise we'll end up making a bound member expression, which
10223     // is illegal in all the contexts we resolve like this.
10224     if (!ovl.HasFormOfMemberPointer &&
10225         isa<CXXMethodDecl>(fn) &&
10226         cast<CXXMethodDecl>(fn)->isInstance()) {
10227       if (!complain) return false;
10228 
10229       Diag(ovl.Expression->getExprLoc(),
10230            diag::err_bound_member_function)
10231         << 0 << ovl.Expression->getSourceRange();
10232 
10233       // TODO: I believe we only end up here if there's a mix of
10234       // static and non-static candidates (otherwise the expression
10235       // would have 'bound member' type, not 'overload' type).
10236       // Ideally we would note which candidate was chosen and why
10237       // the static candidates were rejected.
10238       SrcExpr = ExprError();
10239       return true;
10240     }
10241 
10242     // Fix the expression to refer to 'fn'.
10243     SingleFunctionExpression =
10244         FixOverloadedFunctionReference(SrcExpr.get(), found, fn);
10245 
10246     // If desired, do function-to-pointer decay.
10247     if (doFunctionPointerConverion) {
10248       SingleFunctionExpression =
10249         DefaultFunctionArrayLvalueConversion(SingleFunctionExpression.get());
10250       if (SingleFunctionExpression.isInvalid()) {
10251         SrcExpr = ExprError();
10252         return true;
10253       }
10254     }
10255   }
10256 
10257   if (!SingleFunctionExpression.isUsable()) {
10258     if (complain) {
10259       Diag(OpRangeForComplaining.getBegin(), DiagIDForComplaining)
10260         << ovl.Expression->getName()
10261         << DestTypeForComplaining
10262         << OpRangeForComplaining
10263         << ovl.Expression->getQualifierLoc().getSourceRange();
10264       NoteAllOverloadCandidates(SrcExpr.get());
10265 
10266       SrcExpr = ExprError();
10267       return true;
10268     }
10269 
10270     return false;
10271   }
10272 
10273   SrcExpr = SingleFunctionExpression;
10274   return true;
10275 }
10276 
10277 /// \brief Add a single candidate to the overload set.
10278 static void AddOverloadedCallCandidate(Sema &S,
10279                                        DeclAccessPair FoundDecl,
10280                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
10281                                        ArrayRef<Expr *> Args,
10282                                        OverloadCandidateSet &CandidateSet,
10283                                        bool PartialOverloading,
10284                                        bool KnownValid) {
10285   NamedDecl *Callee = FoundDecl.getDecl();
10286   if (isa<UsingShadowDecl>(Callee))
10287     Callee = cast<UsingShadowDecl>(Callee)->getTargetDecl();
10288 
10289   if (FunctionDecl *Func = dyn_cast<FunctionDecl>(Callee)) {
10290     if (ExplicitTemplateArgs) {
10291       assert(!KnownValid && "Explicit template arguments?");
10292       return;
10293     }
10294     S.AddOverloadCandidate(Func, FoundDecl, Args, CandidateSet, false,
10295                            PartialOverloading);
10296     return;
10297   }
10298 
10299   if (FunctionTemplateDecl *FuncTemplate
10300       = dyn_cast<FunctionTemplateDecl>(Callee)) {
10301     S.AddTemplateOverloadCandidate(FuncTemplate, FoundDecl,
10302                                    ExplicitTemplateArgs, Args, CandidateSet);
10303     return;
10304   }
10305 
10306   assert(!KnownValid && "unhandled case in overloaded call candidate");
10307 }
10308 
10309 /// \brief Add the overload candidates named by callee and/or found by argument
10310 /// dependent lookup to the given overload set.
10311 void Sema::AddOverloadedCallCandidates(UnresolvedLookupExpr *ULE,
10312                                        ArrayRef<Expr *> Args,
10313                                        OverloadCandidateSet &CandidateSet,
10314                                        bool PartialOverloading) {
10315 
10316 #ifndef NDEBUG
10317   // Verify that ArgumentDependentLookup is consistent with the rules
10318   // in C++0x [basic.lookup.argdep]p3:
10319   //
10320   //   Let X be the lookup set produced by unqualified lookup (3.4.1)
10321   //   and let Y be the lookup set produced by argument dependent
10322   //   lookup (defined as follows). If X contains
10323   //
10324   //     -- a declaration of a class member, or
10325   //
10326   //     -- a block-scope function declaration that is not a
10327   //        using-declaration, or
10328   //
10329   //     -- a declaration that is neither a function or a function
10330   //        template
10331   //
10332   //   then Y is empty.
10333 
10334   if (ULE->requiresADL()) {
10335     for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
10336            E = ULE->decls_end(); I != E; ++I) {
10337       assert(!(*I)->getDeclContext()->isRecord());
10338       assert(isa<UsingShadowDecl>(*I) ||
10339              !(*I)->getDeclContext()->isFunctionOrMethod());
10340       assert((*I)->getUnderlyingDecl()->isFunctionOrFunctionTemplate());
10341     }
10342   }
10343 #endif
10344 
10345   // It would be nice to avoid this copy.
10346   TemplateArgumentListInfo TABuffer;
10347   TemplateArgumentListInfo *ExplicitTemplateArgs = nullptr;
10348   if (ULE->hasExplicitTemplateArgs()) {
10349     ULE->copyTemplateArgumentsInto(TABuffer);
10350     ExplicitTemplateArgs = &TABuffer;
10351   }
10352 
10353   for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
10354          E = ULE->decls_end(); I != E; ++I)
10355     AddOverloadedCallCandidate(*this, I.getPair(), ExplicitTemplateArgs, Args,
10356                                CandidateSet, PartialOverloading,
10357                                /*KnownValid*/ true);
10358 
10359   if (ULE->requiresADL())
10360     AddArgumentDependentLookupCandidates(ULE->getName(), ULE->getExprLoc(),
10361                                          Args, ExplicitTemplateArgs,
10362                                          CandidateSet, PartialOverloading);
10363 }
10364 
10365 /// Determine whether a declaration with the specified name could be moved into
10366 /// a different namespace.
10367 static bool canBeDeclaredInNamespace(const DeclarationName &Name) {
10368   switch (Name.getCXXOverloadedOperator()) {
10369   case OO_New: case OO_Array_New:
10370   case OO_Delete: case OO_Array_Delete:
10371     return false;
10372 
10373   default:
10374     return true;
10375   }
10376 }
10377 
10378 /// Attempt to recover from an ill-formed use of a non-dependent name in a
10379 /// template, where the non-dependent name was declared after the template
10380 /// was defined. This is common in code written for a compilers which do not
10381 /// correctly implement two-stage name lookup.
10382 ///
10383 /// Returns true if a viable candidate was found and a diagnostic was issued.
10384 static bool
10385 DiagnoseTwoPhaseLookup(Sema &SemaRef, SourceLocation FnLoc,
10386                        const CXXScopeSpec &SS, LookupResult &R,
10387                        OverloadCandidateSet::CandidateSetKind CSK,
10388                        TemplateArgumentListInfo *ExplicitTemplateArgs,
10389                        ArrayRef<Expr *> Args) {
10390   if (SemaRef.ActiveTemplateInstantiations.empty() || !SS.isEmpty())
10391     return false;
10392 
10393   for (DeclContext *DC = SemaRef.CurContext; DC; DC = DC->getParent()) {
10394     if (DC->isTransparentContext())
10395       continue;
10396 
10397     SemaRef.LookupQualifiedName(R, DC);
10398 
10399     if (!R.empty()) {
10400       R.suppressDiagnostics();
10401 
10402       if (isa<CXXRecordDecl>(DC)) {
10403         // Don't diagnose names we find in classes; we get much better
10404         // diagnostics for these from DiagnoseEmptyLookup.
10405         R.clear();
10406         return false;
10407       }
10408 
10409       OverloadCandidateSet Candidates(FnLoc, CSK);
10410       for (LookupResult::iterator I = R.begin(), E = R.end(); I != E; ++I)
10411         AddOverloadedCallCandidate(SemaRef, I.getPair(),
10412                                    ExplicitTemplateArgs, Args,
10413                                    Candidates, false, /*KnownValid*/ false);
10414 
10415       OverloadCandidateSet::iterator Best;
10416       if (Candidates.BestViableFunction(SemaRef, FnLoc, Best) != OR_Success) {
10417         // No viable functions. Don't bother the user with notes for functions
10418         // which don't work and shouldn't be found anyway.
10419         R.clear();
10420         return false;
10421       }
10422 
10423       // Find the namespaces where ADL would have looked, and suggest
10424       // declaring the function there instead.
10425       Sema::AssociatedNamespaceSet AssociatedNamespaces;
10426       Sema::AssociatedClassSet AssociatedClasses;
10427       SemaRef.FindAssociatedClassesAndNamespaces(FnLoc, Args,
10428                                                  AssociatedNamespaces,
10429                                                  AssociatedClasses);
10430       Sema::AssociatedNamespaceSet SuggestedNamespaces;
10431       if (canBeDeclaredInNamespace(R.getLookupName())) {
10432         DeclContext *Std = SemaRef.getStdNamespace();
10433         for (Sema::AssociatedNamespaceSet::iterator
10434                it = AssociatedNamespaces.begin(),
10435                end = AssociatedNamespaces.end(); it != end; ++it) {
10436           // Never suggest declaring a function within namespace 'std'.
10437           if (Std && Std->Encloses(*it))
10438             continue;
10439 
10440           // Never suggest declaring a function within a namespace with a
10441           // reserved name, like __gnu_cxx.
10442           NamespaceDecl *NS = dyn_cast<NamespaceDecl>(*it);
10443           if (NS &&
10444               NS->getQualifiedNameAsString().find("__") != std::string::npos)
10445             continue;
10446 
10447           SuggestedNamespaces.insert(*it);
10448         }
10449       }
10450 
10451       SemaRef.Diag(R.getNameLoc(), diag::err_not_found_by_two_phase_lookup)
10452         << R.getLookupName();
10453       if (SuggestedNamespaces.empty()) {
10454         SemaRef.Diag(Best->Function->getLocation(),
10455                      diag::note_not_found_by_two_phase_lookup)
10456           << R.getLookupName() << 0;
10457       } else if (SuggestedNamespaces.size() == 1) {
10458         SemaRef.Diag(Best->Function->getLocation(),
10459                      diag::note_not_found_by_two_phase_lookup)
10460           << R.getLookupName() << 1 << *SuggestedNamespaces.begin();
10461       } else {
10462         // FIXME: It would be useful to list the associated namespaces here,
10463         // but the diagnostics infrastructure doesn't provide a way to produce
10464         // a localized representation of a list of items.
10465         SemaRef.Diag(Best->Function->getLocation(),
10466                      diag::note_not_found_by_two_phase_lookup)
10467           << R.getLookupName() << 2;
10468       }
10469 
10470       // Try to recover by calling this function.
10471       return true;
10472     }
10473 
10474     R.clear();
10475   }
10476 
10477   return false;
10478 }
10479 
10480 /// Attempt to recover from ill-formed use of a non-dependent operator in a
10481 /// template, where the non-dependent operator was declared after the template
10482 /// was defined.
10483 ///
10484 /// Returns true if a viable candidate was found and a diagnostic was issued.
10485 static bool
10486 DiagnoseTwoPhaseOperatorLookup(Sema &SemaRef, OverloadedOperatorKind Op,
10487                                SourceLocation OpLoc,
10488                                ArrayRef<Expr *> Args) {
10489   DeclarationName OpName =
10490     SemaRef.Context.DeclarationNames.getCXXOperatorName(Op);
10491   LookupResult R(SemaRef, OpName, OpLoc, Sema::LookupOperatorName);
10492   return DiagnoseTwoPhaseLookup(SemaRef, OpLoc, CXXScopeSpec(), R,
10493                                 OverloadCandidateSet::CSK_Operator,
10494                                 /*ExplicitTemplateArgs=*/nullptr, Args);
10495 }
10496 
10497 namespace {
10498 class BuildRecoveryCallExprRAII {
10499   Sema &SemaRef;
10500 public:
10501   BuildRecoveryCallExprRAII(Sema &S) : SemaRef(S) {
10502     assert(SemaRef.IsBuildingRecoveryCallExpr == false);
10503     SemaRef.IsBuildingRecoveryCallExpr = true;
10504   }
10505 
10506   ~BuildRecoveryCallExprRAII() {
10507     SemaRef.IsBuildingRecoveryCallExpr = false;
10508   }
10509 };
10510 
10511 }
10512 
10513 /// Attempts to recover from a call where no functions were found.
10514 ///
10515 /// Returns true if new candidates were found.
10516 static ExprResult
10517 BuildRecoveryCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
10518                       UnresolvedLookupExpr *ULE,
10519                       SourceLocation LParenLoc,
10520                       MutableArrayRef<Expr *> Args,
10521                       SourceLocation RParenLoc,
10522                       bool EmptyLookup, bool AllowTypoCorrection) {
10523   // Do not try to recover if it is already building a recovery call.
10524   // This stops infinite loops for template instantiations like
10525   //
10526   // template <typename T> auto foo(T t) -> decltype(foo(t)) {}
10527   // template <typename T> auto foo(T t) -> decltype(foo(&t)) {}
10528   //
10529   if (SemaRef.IsBuildingRecoveryCallExpr)
10530     return ExprError();
10531   BuildRecoveryCallExprRAII RCE(SemaRef);
10532 
10533   CXXScopeSpec SS;
10534   SS.Adopt(ULE->getQualifierLoc());
10535   SourceLocation TemplateKWLoc = ULE->getTemplateKeywordLoc();
10536 
10537   TemplateArgumentListInfo TABuffer;
10538   TemplateArgumentListInfo *ExplicitTemplateArgs = nullptr;
10539   if (ULE->hasExplicitTemplateArgs()) {
10540     ULE->copyTemplateArgumentsInto(TABuffer);
10541     ExplicitTemplateArgs = &TABuffer;
10542   }
10543 
10544   LookupResult R(SemaRef, ULE->getName(), ULE->getNameLoc(),
10545                  Sema::LookupOrdinaryName);
10546   FunctionCallFilterCCC Validator(SemaRef, Args.size(),
10547                                   ExplicitTemplateArgs != nullptr,
10548                                   dyn_cast<MemberExpr>(Fn));
10549   NoTypoCorrectionCCC RejectAll;
10550   CorrectionCandidateCallback *CCC = AllowTypoCorrection ?
10551       (CorrectionCandidateCallback*)&Validator :
10552       (CorrectionCandidateCallback*)&RejectAll;
10553   if (!DiagnoseTwoPhaseLookup(SemaRef, Fn->getExprLoc(), SS, R,
10554                               OverloadCandidateSet::CSK_Normal,
10555                               ExplicitTemplateArgs, Args) &&
10556       (!EmptyLookup ||
10557        SemaRef.DiagnoseEmptyLookup(S, SS, R, *CCC,
10558                                    ExplicitTemplateArgs, Args)))
10559     return ExprError();
10560 
10561   assert(!R.empty() && "lookup results empty despite recovery");
10562 
10563   // Build an implicit member call if appropriate.  Just drop the
10564   // casts and such from the call, we don't really care.
10565   ExprResult NewFn = ExprError();
10566   if ((*R.begin())->isCXXClassMember())
10567     NewFn = SemaRef.BuildPossibleImplicitMemberExpr(SS, TemplateKWLoc,
10568                                                     R, ExplicitTemplateArgs);
10569   else if (ExplicitTemplateArgs || TemplateKWLoc.isValid())
10570     NewFn = SemaRef.BuildTemplateIdExpr(SS, TemplateKWLoc, R, false,
10571                                         ExplicitTemplateArgs);
10572   else
10573     NewFn = SemaRef.BuildDeclarationNameExpr(SS, R, false);
10574 
10575   if (NewFn.isInvalid())
10576     return ExprError();
10577 
10578   // This shouldn't cause an infinite loop because we're giving it
10579   // an expression with viable lookup results, which should never
10580   // end up here.
10581   return SemaRef.ActOnCallExpr(/*Scope*/ nullptr, NewFn.get(), LParenLoc,
10582                                MultiExprArg(Args.data(), Args.size()),
10583                                RParenLoc);
10584 }
10585 
10586 /// \brief Constructs and populates an OverloadedCandidateSet from
10587 /// the given function.
10588 /// \returns true when an the ExprResult output parameter has been set.
10589 bool Sema::buildOverloadedCallSet(Scope *S, Expr *Fn,
10590                                   UnresolvedLookupExpr *ULE,
10591                                   MultiExprArg Args,
10592                                   SourceLocation RParenLoc,
10593                                   OverloadCandidateSet *CandidateSet,
10594                                   ExprResult *Result) {
10595 #ifndef NDEBUG
10596   if (ULE->requiresADL()) {
10597     // To do ADL, we must have found an unqualified name.
10598     assert(!ULE->getQualifier() && "qualified name with ADL");
10599 
10600     // We don't perform ADL for implicit declarations of builtins.
10601     // Verify that this was correctly set up.
10602     FunctionDecl *F;
10603     if (ULE->decls_begin() + 1 == ULE->decls_end() &&
10604         (F = dyn_cast<FunctionDecl>(*ULE->decls_begin())) &&
10605         F->getBuiltinID() && F->isImplicit())
10606       llvm_unreachable("performing ADL for builtin");
10607 
10608     // We don't perform ADL in C.
10609     assert(getLangOpts().CPlusPlus && "ADL enabled in C");
10610   }
10611 #endif
10612 
10613   UnbridgedCastsSet UnbridgedCasts;
10614   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts)) {
10615     *Result = ExprError();
10616     return true;
10617   }
10618 
10619   // Add the functions denoted by the callee to the set of candidate
10620   // functions, including those from argument-dependent lookup.
10621   AddOverloadedCallCandidates(ULE, Args, *CandidateSet);
10622 
10623   // If we found nothing, try to recover.
10624   // BuildRecoveryCallExpr diagnoses the error itself, so we just bail
10625   // out if it fails.
10626   if (CandidateSet->empty()) {
10627     // In Microsoft mode, if we are inside a template class member function then
10628     // create a type dependent CallExpr. The goal is to postpone name lookup
10629     // to instantiation time to be able to search into type dependent base
10630     // classes.
10631     if (getLangOpts().MSVCCompat && CurContext->isDependentContext() &&
10632         (isa<FunctionDecl>(CurContext) || isa<CXXRecordDecl>(CurContext))) {
10633       CallExpr *CE = new (Context) CallExpr(Context, Fn, Args,
10634                                             Context.DependentTy, VK_RValue,
10635                                             RParenLoc);
10636       CE->setTypeDependent(true);
10637       *Result = CE;
10638       return true;
10639     }
10640     return false;
10641   }
10642 
10643   UnbridgedCasts.restore();
10644   return false;
10645 }
10646 
10647 /// FinishOverloadedCallExpr - given an OverloadCandidateSet, builds and returns
10648 /// the completed call expression. If overload resolution fails, emits
10649 /// diagnostics and returns ExprError()
10650 static ExprResult FinishOverloadedCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
10651                                            UnresolvedLookupExpr *ULE,
10652                                            SourceLocation LParenLoc,
10653                                            MultiExprArg Args,
10654                                            SourceLocation RParenLoc,
10655                                            Expr *ExecConfig,
10656                                            OverloadCandidateSet *CandidateSet,
10657                                            OverloadCandidateSet::iterator *Best,
10658                                            OverloadingResult OverloadResult,
10659                                            bool AllowTypoCorrection) {
10660   if (CandidateSet->empty())
10661     return BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc, Args,
10662                                  RParenLoc, /*EmptyLookup=*/true,
10663                                  AllowTypoCorrection);
10664 
10665   switch (OverloadResult) {
10666   case OR_Success: {
10667     FunctionDecl *FDecl = (*Best)->Function;
10668     SemaRef.CheckUnresolvedLookupAccess(ULE, (*Best)->FoundDecl);
10669     if (SemaRef.DiagnoseUseOfDecl(FDecl, ULE->getNameLoc()))
10670       return ExprError();
10671     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
10672     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
10673                                          ExecConfig);
10674   }
10675 
10676   case OR_No_Viable_Function: {
10677     // Try to recover by looking for viable functions which the user might
10678     // have meant to call.
10679     ExprResult Recovery = BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc,
10680                                                 Args, RParenLoc,
10681                                                 /*EmptyLookup=*/false,
10682                                                 AllowTypoCorrection);
10683     if (!Recovery.isInvalid())
10684       return Recovery;
10685 
10686     SemaRef.Diag(Fn->getLocStart(),
10687          diag::err_ovl_no_viable_function_in_call)
10688       << ULE->getName() << Fn->getSourceRange();
10689     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
10690     break;
10691   }
10692 
10693   case OR_Ambiguous:
10694     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_ambiguous_call)
10695       << ULE->getName() << Fn->getSourceRange();
10696     CandidateSet->NoteCandidates(SemaRef, OCD_ViableCandidates, Args);
10697     break;
10698 
10699   case OR_Deleted: {
10700     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_deleted_call)
10701       << (*Best)->Function->isDeleted()
10702       << ULE->getName()
10703       << SemaRef.getDeletedOrUnavailableSuffix((*Best)->Function)
10704       << Fn->getSourceRange();
10705     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
10706 
10707     // We emitted an error for the unvailable/deleted function call but keep
10708     // the call in the AST.
10709     FunctionDecl *FDecl = (*Best)->Function;
10710     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
10711     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
10712                                          ExecConfig);
10713   }
10714   }
10715 
10716   // Overload resolution failed.
10717   return ExprError();
10718 }
10719 
10720 /// BuildOverloadedCallExpr - Given the call expression that calls Fn
10721 /// (which eventually refers to the declaration Func) and the call
10722 /// arguments Args/NumArgs, attempt to resolve the function call down
10723 /// to a specific function. If overload resolution succeeds, returns
10724 /// the call expression produced by overload resolution.
10725 /// Otherwise, emits diagnostics and returns ExprError.
10726 ExprResult Sema::BuildOverloadedCallExpr(Scope *S, Expr *Fn,
10727                                          UnresolvedLookupExpr *ULE,
10728                                          SourceLocation LParenLoc,
10729                                          MultiExprArg Args,
10730                                          SourceLocation RParenLoc,
10731                                          Expr *ExecConfig,
10732                                          bool AllowTypoCorrection) {
10733   OverloadCandidateSet CandidateSet(Fn->getExprLoc(),
10734                                     OverloadCandidateSet::CSK_Normal);
10735   ExprResult result;
10736 
10737   if (buildOverloadedCallSet(S, Fn, ULE, Args, LParenLoc, &CandidateSet,
10738                              &result))
10739     return result;
10740 
10741   OverloadCandidateSet::iterator Best;
10742   OverloadingResult OverloadResult =
10743       CandidateSet.BestViableFunction(*this, Fn->getLocStart(), Best);
10744 
10745   return FinishOverloadedCallExpr(*this, S, Fn, ULE, LParenLoc, Args,
10746                                   RParenLoc, ExecConfig, &CandidateSet,
10747                                   &Best, OverloadResult,
10748                                   AllowTypoCorrection);
10749 }
10750 
10751 static bool IsOverloaded(const UnresolvedSetImpl &Functions) {
10752   return Functions.size() > 1 ||
10753     (Functions.size() == 1 && isa<FunctionTemplateDecl>(*Functions.begin()));
10754 }
10755 
10756 /// \brief Create a unary operation that may resolve to an overloaded
10757 /// operator.
10758 ///
10759 /// \param OpLoc The location of the operator itself (e.g., '*').
10760 ///
10761 /// \param OpcIn The UnaryOperator::Opcode that describes this
10762 /// operator.
10763 ///
10764 /// \param Fns The set of non-member functions that will be
10765 /// considered by overload resolution. The caller needs to build this
10766 /// set based on the context using, e.g.,
10767 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
10768 /// set should not contain any member functions; those will be added
10769 /// by CreateOverloadedUnaryOp().
10770 ///
10771 /// \param Input The input argument.
10772 ExprResult
10773 Sema::CreateOverloadedUnaryOp(SourceLocation OpLoc, unsigned OpcIn,
10774                               const UnresolvedSetImpl &Fns,
10775                               Expr *Input) {
10776   UnaryOperator::Opcode Opc = static_cast<UnaryOperator::Opcode>(OpcIn);
10777 
10778   OverloadedOperatorKind Op = UnaryOperator::getOverloadedOperator(Opc);
10779   assert(Op != OO_None && "Invalid opcode for overloaded unary operator");
10780   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
10781   // TODO: provide better source location info.
10782   DeclarationNameInfo OpNameInfo(OpName, OpLoc);
10783 
10784   if (checkPlaceholderForOverload(*this, Input))
10785     return ExprError();
10786 
10787   Expr *Args[2] = { Input, nullptr };
10788   unsigned NumArgs = 1;
10789 
10790   // For post-increment and post-decrement, add the implicit '0' as
10791   // the second argument, so that we know this is a post-increment or
10792   // post-decrement.
10793   if (Opc == UO_PostInc || Opc == UO_PostDec) {
10794     llvm::APSInt Zero(Context.getTypeSize(Context.IntTy), false);
10795     Args[1] = IntegerLiteral::Create(Context, Zero, Context.IntTy,
10796                                      SourceLocation());
10797     NumArgs = 2;
10798   }
10799 
10800   ArrayRef<Expr *> ArgsArray(Args, NumArgs);
10801 
10802   if (Input->isTypeDependent()) {
10803     if (Fns.empty())
10804       return new (Context) UnaryOperator(Input, Opc, Context.DependentTy,
10805                                          VK_RValue, OK_Ordinary, OpLoc);
10806 
10807     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
10808     UnresolvedLookupExpr *Fn
10809       = UnresolvedLookupExpr::Create(Context, NamingClass,
10810                                      NestedNameSpecifierLoc(), OpNameInfo,
10811                                      /*ADL*/ true, IsOverloaded(Fns),
10812                                      Fns.begin(), Fns.end());
10813     return new (Context)
10814         CXXOperatorCallExpr(Context, Op, Fn, ArgsArray, Context.DependentTy,
10815                             VK_RValue, OpLoc, false);
10816   }
10817 
10818   // Build an empty overload set.
10819   OverloadCandidateSet CandidateSet(OpLoc, OverloadCandidateSet::CSK_Operator);
10820 
10821   // Add the candidates from the given function set.
10822   AddFunctionCandidates(Fns, ArgsArray, CandidateSet, false);
10823 
10824   // Add operator candidates that are member functions.
10825   AddMemberOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
10826 
10827   // Add candidates from ADL.
10828   AddArgumentDependentLookupCandidates(OpName, OpLoc, ArgsArray,
10829                                        /*ExplicitTemplateArgs*/nullptr,
10830                                        CandidateSet);
10831 
10832   // Add builtin operator candidates.
10833   AddBuiltinOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
10834 
10835   bool HadMultipleCandidates = (CandidateSet.size() > 1);
10836 
10837   // Perform overload resolution.
10838   OverloadCandidateSet::iterator Best;
10839   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
10840   case OR_Success: {
10841     // We found a built-in operator or an overloaded operator.
10842     FunctionDecl *FnDecl = Best->Function;
10843 
10844     if (FnDecl) {
10845       // We matched an overloaded operator. Build a call to that
10846       // operator.
10847 
10848       // Convert the arguments.
10849       if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
10850         CheckMemberOperatorAccess(OpLoc, Args[0], nullptr, Best->FoundDecl);
10851 
10852         ExprResult InputRes =
10853           PerformObjectArgumentInitialization(Input, /*Qualifier=*/nullptr,
10854                                               Best->FoundDecl, Method);
10855         if (InputRes.isInvalid())
10856           return ExprError();
10857         Input = InputRes.get();
10858       } else {
10859         // Convert the arguments.
10860         ExprResult InputInit
10861           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
10862                                                       Context,
10863                                                       FnDecl->getParamDecl(0)),
10864                                       SourceLocation(),
10865                                       Input);
10866         if (InputInit.isInvalid())
10867           return ExprError();
10868         Input = InputInit.get();
10869       }
10870 
10871       // Build the actual expression node.
10872       ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl, Best->FoundDecl,
10873                                                 HadMultipleCandidates, OpLoc);
10874       if (FnExpr.isInvalid())
10875         return ExprError();
10876 
10877       // Determine the result type.
10878       QualType ResultTy = FnDecl->getReturnType();
10879       ExprValueKind VK = Expr::getValueKindForType(ResultTy);
10880       ResultTy = ResultTy.getNonLValueExprType(Context);
10881 
10882       Args[0] = Input;
10883       CallExpr *TheCall =
10884         new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.get(), ArgsArray,
10885                                           ResultTy, VK, OpLoc, false);
10886 
10887       if (CheckCallReturnType(FnDecl->getReturnType(), OpLoc, TheCall, FnDecl))
10888         return ExprError();
10889 
10890       return MaybeBindToTemporary(TheCall);
10891     } else {
10892       // We matched a built-in operator. Convert the arguments, then
10893       // break out so that we will build the appropriate built-in
10894       // operator node.
10895       ExprResult InputRes =
10896         PerformImplicitConversion(Input, Best->BuiltinTypes.ParamTypes[0],
10897                                   Best->Conversions[0], AA_Passing);
10898       if (InputRes.isInvalid())
10899         return ExprError();
10900       Input = InputRes.get();
10901       break;
10902     }
10903   }
10904 
10905   case OR_No_Viable_Function:
10906     // This is an erroneous use of an operator which can be overloaded by
10907     // a non-member function. Check for non-member operators which were
10908     // defined too late to be candidates.
10909     if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, ArgsArray))
10910       // FIXME: Recover by calling the found function.
10911       return ExprError();
10912 
10913     // No viable function; fall through to handling this as a
10914     // built-in operator, which will produce an error message for us.
10915     break;
10916 
10917   case OR_Ambiguous:
10918     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
10919         << UnaryOperator::getOpcodeStr(Opc)
10920         << Input->getType()
10921         << Input->getSourceRange();
10922     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, ArgsArray,
10923                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
10924     return ExprError();
10925 
10926   case OR_Deleted:
10927     Diag(OpLoc, diag::err_ovl_deleted_oper)
10928       << Best->Function->isDeleted()
10929       << UnaryOperator::getOpcodeStr(Opc)
10930       << getDeletedOrUnavailableSuffix(Best->Function)
10931       << Input->getSourceRange();
10932     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, ArgsArray,
10933                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
10934     return ExprError();
10935   }
10936 
10937   // Either we found no viable overloaded operator or we matched a
10938   // built-in operator. In either case, fall through to trying to
10939   // build a built-in operation.
10940   return CreateBuiltinUnaryOp(OpLoc, Opc, Input);
10941 }
10942 
10943 /// \brief Create a binary operation that may resolve to an overloaded
10944 /// operator.
10945 ///
10946 /// \param OpLoc The location of the operator itself (e.g., '+').
10947 ///
10948 /// \param OpcIn The BinaryOperator::Opcode that describes this
10949 /// operator.
10950 ///
10951 /// \param Fns The set of non-member functions that will be
10952 /// considered by overload resolution. The caller needs to build this
10953 /// set based on the context using, e.g.,
10954 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
10955 /// set should not contain any member functions; those will be added
10956 /// by CreateOverloadedBinOp().
10957 ///
10958 /// \param LHS Left-hand argument.
10959 /// \param RHS Right-hand argument.
10960 ExprResult
10961 Sema::CreateOverloadedBinOp(SourceLocation OpLoc,
10962                             unsigned OpcIn,
10963                             const UnresolvedSetImpl &Fns,
10964                             Expr *LHS, Expr *RHS) {
10965   Expr *Args[2] = { LHS, RHS };
10966   LHS=RHS=nullptr; // Please use only Args instead of LHS/RHS couple
10967 
10968   BinaryOperator::Opcode Opc = static_cast<BinaryOperator::Opcode>(OpcIn);
10969   OverloadedOperatorKind Op = BinaryOperator::getOverloadedOperator(Opc);
10970   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
10971 
10972   // If either side is type-dependent, create an appropriate dependent
10973   // expression.
10974   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
10975     if (Fns.empty()) {
10976       // If there are no functions to store, just build a dependent
10977       // BinaryOperator or CompoundAssignment.
10978       if (Opc <= BO_Assign || Opc > BO_OrAssign)
10979         return new (Context) BinaryOperator(
10980             Args[0], Args[1], Opc, Context.DependentTy, VK_RValue, OK_Ordinary,
10981             OpLoc, FPFeatures.fp_contract);
10982 
10983       return new (Context) CompoundAssignOperator(
10984           Args[0], Args[1], Opc, Context.DependentTy, VK_LValue, OK_Ordinary,
10985           Context.DependentTy, Context.DependentTy, OpLoc,
10986           FPFeatures.fp_contract);
10987     }
10988 
10989     // FIXME: save results of ADL from here?
10990     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
10991     // TODO: provide better source location info in DNLoc component.
10992     DeclarationNameInfo OpNameInfo(OpName, OpLoc);
10993     UnresolvedLookupExpr *Fn
10994       = UnresolvedLookupExpr::Create(Context, NamingClass,
10995                                      NestedNameSpecifierLoc(), OpNameInfo,
10996                                      /*ADL*/ true, IsOverloaded(Fns),
10997                                      Fns.begin(), Fns.end());
10998     return new (Context)
10999         CXXOperatorCallExpr(Context, Op, Fn, Args, Context.DependentTy,
11000                             VK_RValue, OpLoc, FPFeatures.fp_contract);
11001   }
11002 
11003   // Always do placeholder-like conversions on the RHS.
11004   if (checkPlaceholderForOverload(*this, Args[1]))
11005     return ExprError();
11006 
11007   // Do placeholder-like conversion on the LHS; note that we should
11008   // not get here with a PseudoObject LHS.
11009   assert(Args[0]->getObjectKind() != OK_ObjCProperty);
11010   if (checkPlaceholderForOverload(*this, Args[0]))
11011     return ExprError();
11012 
11013   // If this is the assignment operator, we only perform overload resolution
11014   // if the left-hand side is a class or enumeration type. This is actually
11015   // a hack. The standard requires that we do overload resolution between the
11016   // various built-in candidates, but as DR507 points out, this can lead to
11017   // problems. So we do it this way, which pretty much follows what GCC does.
11018   // Note that we go the traditional code path for compound assignment forms.
11019   if (Opc == BO_Assign && !Args[0]->getType()->isOverloadableType())
11020     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
11021 
11022   // If this is the .* operator, which is not overloadable, just
11023   // create a built-in binary operator.
11024   if (Opc == BO_PtrMemD)
11025     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
11026 
11027   // Build an empty overload set.
11028   OverloadCandidateSet CandidateSet(OpLoc, OverloadCandidateSet::CSK_Operator);
11029 
11030   // Add the candidates from the given function set.
11031   AddFunctionCandidates(Fns, Args, CandidateSet, false);
11032 
11033   // Add operator candidates that are member functions.
11034   AddMemberOperatorCandidates(Op, OpLoc, Args, CandidateSet);
11035 
11036   // Add candidates from ADL.
11037   AddArgumentDependentLookupCandidates(OpName, OpLoc, Args,
11038                                        /*ExplicitTemplateArgs*/ nullptr,
11039                                        CandidateSet);
11040 
11041   // Add builtin operator candidates.
11042   AddBuiltinOperatorCandidates(Op, OpLoc, Args, CandidateSet);
11043 
11044   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11045 
11046   // Perform overload resolution.
11047   OverloadCandidateSet::iterator Best;
11048   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
11049     case OR_Success: {
11050       // We found a built-in operator or an overloaded operator.
11051       FunctionDecl *FnDecl = Best->Function;
11052 
11053       if (FnDecl) {
11054         // We matched an overloaded operator. Build a call to that
11055         // operator.
11056 
11057         // Convert the arguments.
11058         if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
11059           // Best->Access is only meaningful for class members.
11060           CheckMemberOperatorAccess(OpLoc, Args[0], Args[1], Best->FoundDecl);
11061 
11062           ExprResult Arg1 =
11063             PerformCopyInitialization(
11064               InitializedEntity::InitializeParameter(Context,
11065                                                      FnDecl->getParamDecl(0)),
11066               SourceLocation(), Args[1]);
11067           if (Arg1.isInvalid())
11068             return ExprError();
11069 
11070           ExprResult Arg0 =
11071             PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/nullptr,
11072                                                 Best->FoundDecl, Method);
11073           if (Arg0.isInvalid())
11074             return ExprError();
11075           Args[0] = Arg0.getAs<Expr>();
11076           Args[1] = RHS = Arg1.getAs<Expr>();
11077         } else {
11078           // Convert the arguments.
11079           ExprResult Arg0 = PerformCopyInitialization(
11080             InitializedEntity::InitializeParameter(Context,
11081                                                    FnDecl->getParamDecl(0)),
11082             SourceLocation(), Args[0]);
11083           if (Arg0.isInvalid())
11084             return ExprError();
11085 
11086           ExprResult Arg1 =
11087             PerformCopyInitialization(
11088               InitializedEntity::InitializeParameter(Context,
11089                                                      FnDecl->getParamDecl(1)),
11090               SourceLocation(), Args[1]);
11091           if (Arg1.isInvalid())
11092             return ExprError();
11093           Args[0] = LHS = Arg0.getAs<Expr>();
11094           Args[1] = RHS = Arg1.getAs<Expr>();
11095         }
11096 
11097         // Build the actual expression node.
11098         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
11099                                                   Best->FoundDecl,
11100                                                   HadMultipleCandidates, OpLoc);
11101         if (FnExpr.isInvalid())
11102           return ExprError();
11103 
11104         // Determine the result type.
11105         QualType ResultTy = FnDecl->getReturnType();
11106         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11107         ResultTy = ResultTy.getNonLValueExprType(Context);
11108 
11109         CXXOperatorCallExpr *TheCall =
11110           new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.get(),
11111                                             Args, ResultTy, VK, OpLoc,
11112                                             FPFeatures.fp_contract);
11113 
11114         if (CheckCallReturnType(FnDecl->getReturnType(), OpLoc, TheCall,
11115                                 FnDecl))
11116           return ExprError();
11117 
11118         ArrayRef<const Expr *> ArgsArray(Args, 2);
11119         // Cut off the implicit 'this'.
11120         if (isa<CXXMethodDecl>(FnDecl))
11121           ArgsArray = ArgsArray.slice(1);
11122         checkCall(FnDecl, ArgsArray, 0, isa<CXXMethodDecl>(FnDecl), OpLoc,
11123                   TheCall->getSourceRange(), VariadicDoesNotApply);
11124 
11125         return MaybeBindToTemporary(TheCall);
11126       } else {
11127         // We matched a built-in operator. Convert the arguments, then
11128         // break out so that we will build the appropriate built-in
11129         // operator node.
11130         ExprResult ArgsRes0 =
11131           PerformImplicitConversion(Args[0], Best->BuiltinTypes.ParamTypes[0],
11132                                     Best->Conversions[0], AA_Passing);
11133         if (ArgsRes0.isInvalid())
11134           return ExprError();
11135         Args[0] = ArgsRes0.get();
11136 
11137         ExprResult ArgsRes1 =
11138           PerformImplicitConversion(Args[1], Best->BuiltinTypes.ParamTypes[1],
11139                                     Best->Conversions[1], AA_Passing);
11140         if (ArgsRes1.isInvalid())
11141           return ExprError();
11142         Args[1] = ArgsRes1.get();
11143         break;
11144       }
11145     }
11146 
11147     case OR_No_Viable_Function: {
11148       // C++ [over.match.oper]p9:
11149       //   If the operator is the operator , [...] and there are no
11150       //   viable functions, then the operator is assumed to be the
11151       //   built-in operator and interpreted according to clause 5.
11152       if (Opc == BO_Comma)
11153         break;
11154 
11155       // For class as left operand for assignment or compound assigment
11156       // operator do not fall through to handling in built-in, but report that
11157       // no overloaded assignment operator found
11158       ExprResult Result = ExprError();
11159       if (Args[0]->getType()->isRecordType() &&
11160           Opc >= BO_Assign && Opc <= BO_OrAssign) {
11161         Diag(OpLoc,  diag::err_ovl_no_viable_oper)
11162              << BinaryOperator::getOpcodeStr(Opc)
11163              << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11164         if (Args[0]->getType()->isIncompleteType()) {
11165           Diag(OpLoc, diag::note_assign_lhs_incomplete)
11166             << Args[0]->getType()
11167             << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11168         }
11169       } else {
11170         // This is an erroneous use of an operator which can be overloaded by
11171         // a non-member function. Check for non-member operators which were
11172         // defined too late to be candidates.
11173         if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, Args))
11174           // FIXME: Recover by calling the found function.
11175           return ExprError();
11176 
11177         // No viable function; try to create a built-in operation, which will
11178         // produce an error. Then, show the non-viable candidates.
11179         Result = CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
11180       }
11181       assert(Result.isInvalid() &&
11182              "C++ binary operator overloading is missing candidates!");
11183       if (Result.isInvalid())
11184         CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
11185                                     BinaryOperator::getOpcodeStr(Opc), OpLoc);
11186       return Result;
11187     }
11188 
11189     case OR_Ambiguous:
11190       Diag(OpLoc,  diag::err_ovl_ambiguous_oper_binary)
11191           << BinaryOperator::getOpcodeStr(Opc)
11192           << Args[0]->getType() << Args[1]->getType()
11193           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11194       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
11195                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
11196       return ExprError();
11197 
11198     case OR_Deleted:
11199       if (isImplicitlyDeleted(Best->Function)) {
11200         CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
11201         Diag(OpLoc, diag::err_ovl_deleted_special_oper)
11202           << Context.getRecordType(Method->getParent())
11203           << getSpecialMember(Method);
11204 
11205         // The user probably meant to call this special member. Just
11206         // explain why it's deleted.
11207         NoteDeletedFunction(Method);
11208         return ExprError();
11209       } else {
11210         Diag(OpLoc, diag::err_ovl_deleted_oper)
11211           << Best->Function->isDeleted()
11212           << BinaryOperator::getOpcodeStr(Opc)
11213           << getDeletedOrUnavailableSuffix(Best->Function)
11214           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11215       }
11216       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
11217                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
11218       return ExprError();
11219   }
11220 
11221   // We matched a built-in operator; build it.
11222   return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
11223 }
11224 
11225 ExprResult
11226 Sema::CreateOverloadedArraySubscriptExpr(SourceLocation LLoc,
11227                                          SourceLocation RLoc,
11228                                          Expr *Base, Expr *Idx) {
11229   Expr *Args[2] = { Base, Idx };
11230   DeclarationName OpName =
11231       Context.DeclarationNames.getCXXOperatorName(OO_Subscript);
11232 
11233   // If either side is type-dependent, create an appropriate dependent
11234   // expression.
11235   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
11236 
11237     CXXRecordDecl *NamingClass = nullptr; // lookup ignores member operators
11238     // CHECKME: no 'operator' keyword?
11239     DeclarationNameInfo OpNameInfo(OpName, LLoc);
11240     OpNameInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
11241     UnresolvedLookupExpr *Fn
11242       = UnresolvedLookupExpr::Create(Context, NamingClass,
11243                                      NestedNameSpecifierLoc(), OpNameInfo,
11244                                      /*ADL*/ true, /*Overloaded*/ false,
11245                                      UnresolvedSetIterator(),
11246                                      UnresolvedSetIterator());
11247     // Can't add any actual overloads yet
11248 
11249     return new (Context)
11250         CXXOperatorCallExpr(Context, OO_Subscript, Fn, Args,
11251                             Context.DependentTy, VK_RValue, RLoc, false);
11252   }
11253 
11254   // Handle placeholders on both operands.
11255   if (checkPlaceholderForOverload(*this, Args[0]))
11256     return ExprError();
11257   if (checkPlaceholderForOverload(*this, Args[1]))
11258     return ExprError();
11259 
11260   // Build an empty overload set.
11261   OverloadCandidateSet CandidateSet(LLoc, OverloadCandidateSet::CSK_Operator);
11262 
11263   // Subscript can only be overloaded as a member function.
11264 
11265   // Add operator candidates that are member functions.
11266   AddMemberOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
11267 
11268   // Add builtin operator candidates.
11269   AddBuiltinOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
11270 
11271   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11272 
11273   // Perform overload resolution.
11274   OverloadCandidateSet::iterator Best;
11275   switch (CandidateSet.BestViableFunction(*this, LLoc, Best)) {
11276     case OR_Success: {
11277       // We found a built-in operator or an overloaded operator.
11278       FunctionDecl *FnDecl = Best->Function;
11279 
11280       if (FnDecl) {
11281         // We matched an overloaded operator. Build a call to that
11282         // operator.
11283 
11284         CheckMemberOperatorAccess(LLoc, Args[0], Args[1], Best->FoundDecl);
11285 
11286         // Convert the arguments.
11287         CXXMethodDecl *Method = cast<CXXMethodDecl>(FnDecl);
11288         ExprResult Arg0 =
11289           PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/nullptr,
11290                                               Best->FoundDecl, Method);
11291         if (Arg0.isInvalid())
11292           return ExprError();
11293         Args[0] = Arg0.get();
11294 
11295         // Convert the arguments.
11296         ExprResult InputInit
11297           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
11298                                                       Context,
11299                                                       FnDecl->getParamDecl(0)),
11300                                       SourceLocation(),
11301                                       Args[1]);
11302         if (InputInit.isInvalid())
11303           return ExprError();
11304 
11305         Args[1] = InputInit.getAs<Expr>();
11306 
11307         // Build the actual expression node.
11308         DeclarationNameInfo OpLocInfo(OpName, LLoc);
11309         OpLocInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
11310         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
11311                                                   Best->FoundDecl,
11312                                                   HadMultipleCandidates,
11313                                                   OpLocInfo.getLoc(),
11314                                                   OpLocInfo.getInfo());
11315         if (FnExpr.isInvalid())
11316           return ExprError();
11317 
11318         // Determine the result type
11319         QualType ResultTy = FnDecl->getReturnType();
11320         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11321         ResultTy = ResultTy.getNonLValueExprType(Context);
11322 
11323         CXXOperatorCallExpr *TheCall =
11324           new (Context) CXXOperatorCallExpr(Context, OO_Subscript,
11325                                             FnExpr.get(), Args,
11326                                             ResultTy, VK, RLoc,
11327                                             false);
11328 
11329         if (CheckCallReturnType(FnDecl->getReturnType(), LLoc, TheCall, FnDecl))
11330           return ExprError();
11331 
11332         return MaybeBindToTemporary(TheCall);
11333       } else {
11334         // We matched a built-in operator. Convert the arguments, then
11335         // break out so that we will build the appropriate built-in
11336         // operator node.
11337         ExprResult ArgsRes0 =
11338           PerformImplicitConversion(Args[0], Best->BuiltinTypes.ParamTypes[0],
11339                                     Best->Conversions[0], AA_Passing);
11340         if (ArgsRes0.isInvalid())
11341           return ExprError();
11342         Args[0] = ArgsRes0.get();
11343 
11344         ExprResult ArgsRes1 =
11345           PerformImplicitConversion(Args[1], Best->BuiltinTypes.ParamTypes[1],
11346                                     Best->Conversions[1], AA_Passing);
11347         if (ArgsRes1.isInvalid())
11348           return ExprError();
11349         Args[1] = ArgsRes1.get();
11350 
11351         break;
11352       }
11353     }
11354 
11355     case OR_No_Viable_Function: {
11356       if (CandidateSet.empty())
11357         Diag(LLoc, diag::err_ovl_no_oper)
11358           << Args[0]->getType() << /*subscript*/ 0
11359           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11360       else
11361         Diag(LLoc, diag::err_ovl_no_viable_subscript)
11362           << Args[0]->getType()
11363           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11364       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
11365                                   "[]", LLoc);
11366       return ExprError();
11367     }
11368 
11369     case OR_Ambiguous:
11370       Diag(LLoc,  diag::err_ovl_ambiguous_oper_binary)
11371           << "[]"
11372           << Args[0]->getType() << Args[1]->getType()
11373           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11374       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
11375                                   "[]", LLoc);
11376       return ExprError();
11377 
11378     case OR_Deleted:
11379       Diag(LLoc, diag::err_ovl_deleted_oper)
11380         << Best->Function->isDeleted() << "[]"
11381         << getDeletedOrUnavailableSuffix(Best->Function)
11382         << Args[0]->getSourceRange() << Args[1]->getSourceRange();
11383       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
11384                                   "[]", LLoc);
11385       return ExprError();
11386     }
11387 
11388   // We matched a built-in operator; build it.
11389   return CreateBuiltinArraySubscriptExpr(Args[0], LLoc, Args[1], RLoc);
11390 }
11391 
11392 /// BuildCallToMemberFunction - Build a call to a member
11393 /// function. MemExpr is the expression that refers to the member
11394 /// function (and includes the object parameter), Args/NumArgs are the
11395 /// arguments to the function call (not including the object
11396 /// parameter). The caller needs to validate that the member
11397 /// expression refers to a non-static member function or an overloaded
11398 /// member function.
11399 ExprResult
11400 Sema::BuildCallToMemberFunction(Scope *S, Expr *MemExprE,
11401                                 SourceLocation LParenLoc,
11402                                 MultiExprArg Args,
11403                                 SourceLocation RParenLoc) {
11404   assert(MemExprE->getType() == Context.BoundMemberTy ||
11405          MemExprE->getType() == Context.OverloadTy);
11406 
11407   // Dig out the member expression. This holds both the object
11408   // argument and the member function we're referring to.
11409   Expr *NakedMemExpr = MemExprE->IgnoreParens();
11410 
11411   // Determine whether this is a call to a pointer-to-member function.
11412   if (BinaryOperator *op = dyn_cast<BinaryOperator>(NakedMemExpr)) {
11413     assert(op->getType() == Context.BoundMemberTy);
11414     assert(op->getOpcode() == BO_PtrMemD || op->getOpcode() == BO_PtrMemI);
11415 
11416     QualType fnType =
11417       op->getRHS()->getType()->castAs<MemberPointerType>()->getPointeeType();
11418 
11419     const FunctionProtoType *proto = fnType->castAs<FunctionProtoType>();
11420     QualType resultType = proto->getCallResultType(Context);
11421     ExprValueKind valueKind = Expr::getValueKindForType(proto->getReturnType());
11422 
11423     // Check that the object type isn't more qualified than the
11424     // member function we're calling.
11425     Qualifiers funcQuals = Qualifiers::fromCVRMask(proto->getTypeQuals());
11426 
11427     QualType objectType = op->getLHS()->getType();
11428     if (op->getOpcode() == BO_PtrMemI)
11429       objectType = objectType->castAs<PointerType>()->getPointeeType();
11430     Qualifiers objectQuals = objectType.getQualifiers();
11431 
11432     Qualifiers difference = objectQuals - funcQuals;
11433     difference.removeObjCGCAttr();
11434     difference.removeAddressSpace();
11435     if (difference) {
11436       std::string qualsString = difference.getAsString();
11437       Diag(LParenLoc, diag::err_pointer_to_member_call_drops_quals)
11438         << fnType.getUnqualifiedType()
11439         << qualsString
11440         << (qualsString.find(' ') == std::string::npos ? 1 : 2);
11441     }
11442 
11443     if (resultType->isMemberPointerType())
11444       if (Context.getTargetInfo().getCXXABI().isMicrosoft())
11445         RequireCompleteType(LParenLoc, resultType, 0);
11446 
11447     CXXMemberCallExpr *call
11448       = new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
11449                                         resultType, valueKind, RParenLoc);
11450 
11451     if (CheckCallReturnType(proto->getReturnType(), op->getRHS()->getLocStart(),
11452                             call, nullptr))
11453       return ExprError();
11454 
11455     if (ConvertArgumentsForCall(call, op, nullptr, proto, Args, RParenLoc))
11456       return ExprError();
11457 
11458     if (CheckOtherCall(call, proto))
11459       return ExprError();
11460 
11461     return MaybeBindToTemporary(call);
11462   }
11463 
11464   UnbridgedCastsSet UnbridgedCasts;
11465   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
11466     return ExprError();
11467 
11468   MemberExpr *MemExpr;
11469   CXXMethodDecl *Method = nullptr;
11470   DeclAccessPair FoundDecl = DeclAccessPair::make(nullptr, AS_public);
11471   NestedNameSpecifier *Qualifier = nullptr;
11472   if (isa<MemberExpr>(NakedMemExpr)) {
11473     MemExpr = cast<MemberExpr>(NakedMemExpr);
11474     Method = cast<CXXMethodDecl>(MemExpr->getMemberDecl());
11475     FoundDecl = MemExpr->getFoundDecl();
11476     Qualifier = MemExpr->getQualifier();
11477     UnbridgedCasts.restore();
11478   } else {
11479     UnresolvedMemberExpr *UnresExpr = cast<UnresolvedMemberExpr>(NakedMemExpr);
11480     Qualifier = UnresExpr->getQualifier();
11481 
11482     QualType ObjectType = UnresExpr->getBaseType();
11483     Expr::Classification ObjectClassification
11484       = UnresExpr->isArrow()? Expr::Classification::makeSimpleLValue()
11485                             : UnresExpr->getBase()->Classify(Context);
11486 
11487     // Add overload candidates
11488     OverloadCandidateSet CandidateSet(UnresExpr->getMemberLoc(),
11489                                       OverloadCandidateSet::CSK_Normal);
11490 
11491     // FIXME: avoid copy.
11492     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
11493     if (UnresExpr->hasExplicitTemplateArgs()) {
11494       UnresExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
11495       TemplateArgs = &TemplateArgsBuffer;
11496     }
11497 
11498     for (UnresolvedMemberExpr::decls_iterator I = UnresExpr->decls_begin(),
11499            E = UnresExpr->decls_end(); I != E; ++I) {
11500 
11501       NamedDecl *Func = *I;
11502       CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(Func->getDeclContext());
11503       if (isa<UsingShadowDecl>(Func))
11504         Func = cast<UsingShadowDecl>(Func)->getTargetDecl();
11505 
11506 
11507       // Microsoft supports direct constructor calls.
11508       if (getLangOpts().MicrosoftExt && isa<CXXConstructorDecl>(Func)) {
11509         AddOverloadCandidate(cast<CXXConstructorDecl>(Func), I.getPair(),
11510                              Args, CandidateSet);
11511       } else if ((Method = dyn_cast<CXXMethodDecl>(Func))) {
11512         // If explicit template arguments were provided, we can't call a
11513         // non-template member function.
11514         if (TemplateArgs)
11515           continue;
11516 
11517         AddMethodCandidate(Method, I.getPair(), ActingDC, ObjectType,
11518                            ObjectClassification, Args, CandidateSet,
11519                            /*SuppressUserConversions=*/false);
11520       } else {
11521         AddMethodTemplateCandidate(cast<FunctionTemplateDecl>(Func),
11522                                    I.getPair(), ActingDC, TemplateArgs,
11523                                    ObjectType,  ObjectClassification,
11524                                    Args, CandidateSet,
11525                                    /*SuppressUsedConversions=*/false);
11526       }
11527     }
11528 
11529     DeclarationName DeclName = UnresExpr->getMemberName();
11530 
11531     UnbridgedCasts.restore();
11532 
11533     OverloadCandidateSet::iterator Best;
11534     switch (CandidateSet.BestViableFunction(*this, UnresExpr->getLocStart(),
11535                                             Best)) {
11536     case OR_Success:
11537       Method = cast<CXXMethodDecl>(Best->Function);
11538       FoundDecl = Best->FoundDecl;
11539       CheckUnresolvedMemberAccess(UnresExpr, Best->FoundDecl);
11540       if (DiagnoseUseOfDecl(Best->FoundDecl, UnresExpr->getNameLoc()))
11541         return ExprError();
11542       // If FoundDecl is different from Method (such as if one is a template
11543       // and the other a specialization), make sure DiagnoseUseOfDecl is
11544       // called on both.
11545       // FIXME: This would be more comprehensively addressed by modifying
11546       // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
11547       // being used.
11548       if (Method != FoundDecl.getDecl() &&
11549                       DiagnoseUseOfDecl(Method, UnresExpr->getNameLoc()))
11550         return ExprError();
11551       break;
11552 
11553     case OR_No_Viable_Function:
11554       Diag(UnresExpr->getMemberLoc(),
11555            diag::err_ovl_no_viable_member_function_in_call)
11556         << DeclName << MemExprE->getSourceRange();
11557       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11558       // FIXME: Leaking incoming expressions!
11559       return ExprError();
11560 
11561     case OR_Ambiguous:
11562       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_ambiguous_member_call)
11563         << DeclName << MemExprE->getSourceRange();
11564       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11565       // FIXME: Leaking incoming expressions!
11566       return ExprError();
11567 
11568     case OR_Deleted:
11569       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_deleted_member_call)
11570         << Best->Function->isDeleted()
11571         << DeclName
11572         << getDeletedOrUnavailableSuffix(Best->Function)
11573         << MemExprE->getSourceRange();
11574       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11575       // FIXME: Leaking incoming expressions!
11576       return ExprError();
11577     }
11578 
11579     MemExprE = FixOverloadedFunctionReference(MemExprE, FoundDecl, Method);
11580 
11581     // If overload resolution picked a static member, build a
11582     // non-member call based on that function.
11583     if (Method->isStatic()) {
11584       return BuildResolvedCallExpr(MemExprE, Method, LParenLoc, Args,
11585                                    RParenLoc);
11586     }
11587 
11588     MemExpr = cast<MemberExpr>(MemExprE->IgnoreParens());
11589   }
11590 
11591   QualType ResultType = Method->getReturnType();
11592   ExprValueKind VK = Expr::getValueKindForType(ResultType);
11593   ResultType = ResultType.getNonLValueExprType(Context);
11594 
11595   assert(Method && "Member call to something that isn't a method?");
11596   CXXMemberCallExpr *TheCall =
11597     new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
11598                                     ResultType, VK, RParenLoc);
11599 
11600   // Check for a valid return type.
11601   if (CheckCallReturnType(Method->getReturnType(), MemExpr->getMemberLoc(),
11602                           TheCall, Method))
11603     return ExprError();
11604 
11605   // Convert the object argument (for a non-static member function call).
11606   // We only need to do this if there was actually an overload; otherwise
11607   // it was done at lookup.
11608   if (!Method->isStatic()) {
11609     ExprResult ObjectArg =
11610       PerformObjectArgumentInitialization(MemExpr->getBase(), Qualifier,
11611                                           FoundDecl, Method);
11612     if (ObjectArg.isInvalid())
11613       return ExprError();
11614     MemExpr->setBase(ObjectArg.get());
11615   }
11616 
11617   // Convert the rest of the arguments
11618   const FunctionProtoType *Proto =
11619     Method->getType()->getAs<FunctionProtoType>();
11620   if (ConvertArgumentsForCall(TheCall, MemExpr, Method, Proto, Args,
11621                               RParenLoc))
11622     return ExprError();
11623 
11624   DiagnoseSentinelCalls(Method, LParenLoc, Args);
11625 
11626   if (CheckFunctionCall(Method, TheCall, Proto))
11627     return ExprError();
11628 
11629   if ((isa<CXXConstructorDecl>(CurContext) ||
11630        isa<CXXDestructorDecl>(CurContext)) &&
11631       TheCall->getMethodDecl()->isPure()) {
11632     const CXXMethodDecl *MD = TheCall->getMethodDecl();
11633 
11634     if (isa<CXXThisExpr>(MemExpr->getBase()->IgnoreParenCasts())) {
11635       Diag(MemExpr->getLocStart(),
11636            diag::warn_call_to_pure_virtual_member_function_from_ctor_dtor)
11637         << MD->getDeclName() << isa<CXXDestructorDecl>(CurContext)
11638         << MD->getParent()->getDeclName();
11639 
11640       Diag(MD->getLocStart(), diag::note_previous_decl) << MD->getDeclName();
11641     }
11642   }
11643   return MaybeBindToTemporary(TheCall);
11644 }
11645 
11646 /// BuildCallToObjectOfClassType - Build a call to an object of class
11647 /// type (C++ [over.call.object]), which can end up invoking an
11648 /// overloaded function call operator (@c operator()) or performing a
11649 /// user-defined conversion on the object argument.
11650 ExprResult
11651 Sema::BuildCallToObjectOfClassType(Scope *S, Expr *Obj,
11652                                    SourceLocation LParenLoc,
11653                                    MultiExprArg Args,
11654                                    SourceLocation RParenLoc) {
11655   if (checkPlaceholderForOverload(*this, Obj))
11656     return ExprError();
11657   ExprResult Object = Obj;
11658 
11659   UnbridgedCastsSet UnbridgedCasts;
11660   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
11661     return ExprError();
11662 
11663   assert(Object.get()->getType()->isRecordType() && "Requires object type argument");
11664   const RecordType *Record = Object.get()->getType()->getAs<RecordType>();
11665 
11666   // C++ [over.call.object]p1:
11667   //  If the primary-expression E in the function call syntax
11668   //  evaluates to a class object of type "cv T", then the set of
11669   //  candidate functions includes at least the function call
11670   //  operators of T. The function call operators of T are obtained by
11671   //  ordinary lookup of the name operator() in the context of
11672   //  (E).operator().
11673   OverloadCandidateSet CandidateSet(LParenLoc,
11674                                     OverloadCandidateSet::CSK_Operator);
11675   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(OO_Call);
11676 
11677   if (RequireCompleteType(LParenLoc, Object.get()->getType(),
11678                           diag::err_incomplete_object_call, Object.get()))
11679     return true;
11680 
11681   LookupResult R(*this, OpName, LParenLoc, LookupOrdinaryName);
11682   LookupQualifiedName(R, Record->getDecl());
11683   R.suppressDiagnostics();
11684 
11685   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
11686        Oper != OperEnd; ++Oper) {
11687     AddMethodCandidate(Oper.getPair(), Object.get()->getType(),
11688                        Object.get()->Classify(Context),
11689                        Args, CandidateSet,
11690                        /*SuppressUserConversions=*/ false);
11691   }
11692 
11693   // C++ [over.call.object]p2:
11694   //   In addition, for each (non-explicit in C++0x) conversion function
11695   //   declared in T of the form
11696   //
11697   //        operator conversion-type-id () cv-qualifier;
11698   //
11699   //   where cv-qualifier is the same cv-qualification as, or a
11700   //   greater cv-qualification than, cv, and where conversion-type-id
11701   //   denotes the type "pointer to function of (P1,...,Pn) returning
11702   //   R", or the type "reference to pointer to function of
11703   //   (P1,...,Pn) returning R", or the type "reference to function
11704   //   of (P1,...,Pn) returning R", a surrogate call function [...]
11705   //   is also considered as a candidate function. Similarly,
11706   //   surrogate call functions are added to the set of candidate
11707   //   functions for each conversion function declared in an
11708   //   accessible base class provided the function is not hidden
11709   //   within T by another intervening declaration.
11710   std::pair<CXXRecordDecl::conversion_iterator,
11711             CXXRecordDecl::conversion_iterator> Conversions
11712     = cast<CXXRecordDecl>(Record->getDecl())->getVisibleConversionFunctions();
11713   for (CXXRecordDecl::conversion_iterator
11714          I = Conversions.first, E = Conversions.second; I != E; ++I) {
11715     NamedDecl *D = *I;
11716     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
11717     if (isa<UsingShadowDecl>(D))
11718       D = cast<UsingShadowDecl>(D)->getTargetDecl();
11719 
11720     // Skip over templated conversion functions; they aren't
11721     // surrogates.
11722     if (isa<FunctionTemplateDecl>(D))
11723       continue;
11724 
11725     CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
11726     if (!Conv->isExplicit()) {
11727       // Strip the reference type (if any) and then the pointer type (if
11728       // any) to get down to what might be a function type.
11729       QualType ConvType = Conv->getConversionType().getNonReferenceType();
11730       if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
11731         ConvType = ConvPtrType->getPointeeType();
11732 
11733       if (const FunctionProtoType *Proto = ConvType->getAs<FunctionProtoType>())
11734       {
11735         AddSurrogateCandidate(Conv, I.getPair(), ActingContext, Proto,
11736                               Object.get(), Args, CandidateSet);
11737       }
11738     }
11739   }
11740 
11741   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11742 
11743   // Perform overload resolution.
11744   OverloadCandidateSet::iterator Best;
11745   switch (CandidateSet.BestViableFunction(*this, Object.get()->getLocStart(),
11746                              Best)) {
11747   case OR_Success:
11748     // Overload resolution succeeded; we'll build the appropriate call
11749     // below.
11750     break;
11751 
11752   case OR_No_Viable_Function:
11753     if (CandidateSet.empty())
11754       Diag(Object.get()->getLocStart(), diag::err_ovl_no_oper)
11755         << Object.get()->getType() << /*call*/ 1
11756         << Object.get()->getSourceRange();
11757     else
11758       Diag(Object.get()->getLocStart(),
11759            diag::err_ovl_no_viable_object_call)
11760         << Object.get()->getType() << Object.get()->getSourceRange();
11761     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11762     break;
11763 
11764   case OR_Ambiguous:
11765     Diag(Object.get()->getLocStart(),
11766          diag::err_ovl_ambiguous_object_call)
11767       << Object.get()->getType() << Object.get()->getSourceRange();
11768     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
11769     break;
11770 
11771   case OR_Deleted:
11772     Diag(Object.get()->getLocStart(),
11773          diag::err_ovl_deleted_object_call)
11774       << Best->Function->isDeleted()
11775       << Object.get()->getType()
11776       << getDeletedOrUnavailableSuffix(Best->Function)
11777       << Object.get()->getSourceRange();
11778     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11779     break;
11780   }
11781 
11782   if (Best == CandidateSet.end())
11783     return true;
11784 
11785   UnbridgedCasts.restore();
11786 
11787   if (Best->Function == nullptr) {
11788     // Since there is no function declaration, this is one of the
11789     // surrogate candidates. Dig out the conversion function.
11790     CXXConversionDecl *Conv
11791       = cast<CXXConversionDecl>(
11792                          Best->Conversions[0].UserDefined.ConversionFunction);
11793 
11794     CheckMemberOperatorAccess(LParenLoc, Object.get(), nullptr,
11795                               Best->FoundDecl);
11796     if (DiagnoseUseOfDecl(Best->FoundDecl, LParenLoc))
11797       return ExprError();
11798     assert(Conv == Best->FoundDecl.getDecl() &&
11799              "Found Decl & conversion-to-functionptr should be same, right?!");
11800     // We selected one of the surrogate functions that converts the
11801     // object parameter to a function pointer. Perform the conversion
11802     // on the object argument, then let ActOnCallExpr finish the job.
11803 
11804     // Create an implicit member expr to refer to the conversion operator.
11805     // and then call it.
11806     ExprResult Call = BuildCXXMemberCallExpr(Object.get(), Best->FoundDecl,
11807                                              Conv, HadMultipleCandidates);
11808     if (Call.isInvalid())
11809       return ExprError();
11810     // Record usage of conversion in an implicit cast.
11811     Call = ImplicitCastExpr::Create(Context, Call.get()->getType(),
11812                                     CK_UserDefinedConversion, Call.get(),
11813                                     nullptr, VK_RValue);
11814 
11815     return ActOnCallExpr(S, Call.get(), LParenLoc, Args, RParenLoc);
11816   }
11817 
11818   CheckMemberOperatorAccess(LParenLoc, Object.get(), nullptr, Best->FoundDecl);
11819 
11820   // We found an overloaded operator(). Build a CXXOperatorCallExpr
11821   // that calls this method, using Object for the implicit object
11822   // parameter and passing along the remaining arguments.
11823   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
11824 
11825   // An error diagnostic has already been printed when parsing the declaration.
11826   if (Method->isInvalidDecl())
11827     return ExprError();
11828 
11829   const FunctionProtoType *Proto =
11830     Method->getType()->getAs<FunctionProtoType>();
11831 
11832   unsigned NumParams = Proto->getNumParams();
11833 
11834   DeclarationNameInfo OpLocInfo(
11835                Context.DeclarationNames.getCXXOperatorName(OO_Call), LParenLoc);
11836   OpLocInfo.setCXXOperatorNameRange(SourceRange(LParenLoc, RParenLoc));
11837   ExprResult NewFn = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
11838                                            HadMultipleCandidates,
11839                                            OpLocInfo.getLoc(),
11840                                            OpLocInfo.getInfo());
11841   if (NewFn.isInvalid())
11842     return true;
11843 
11844   // Build the full argument list for the method call (the implicit object
11845   // parameter is placed at the beginning of the list).
11846   std::unique_ptr<Expr * []> MethodArgs(new Expr *[Args.size() + 1]);
11847   MethodArgs[0] = Object.get();
11848   std::copy(Args.begin(), Args.end(), &MethodArgs[1]);
11849 
11850   // Once we've built TheCall, all of the expressions are properly
11851   // owned.
11852   QualType ResultTy = Method->getReturnType();
11853   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11854   ResultTy = ResultTy.getNonLValueExprType(Context);
11855 
11856   CXXOperatorCallExpr *TheCall = new (Context)
11857       CXXOperatorCallExpr(Context, OO_Call, NewFn.get(),
11858                           llvm::makeArrayRef(MethodArgs.get(), Args.size() + 1),
11859                           ResultTy, VK, RParenLoc, false);
11860   MethodArgs.reset();
11861 
11862   if (CheckCallReturnType(Method->getReturnType(), LParenLoc, TheCall, Method))
11863     return true;
11864 
11865   // We may have default arguments. If so, we need to allocate more
11866   // slots in the call for them.
11867   if (Args.size() < NumParams)
11868     TheCall->setNumArgs(Context, NumParams + 1);
11869 
11870   bool IsError = false;
11871 
11872   // Initialize the implicit object parameter.
11873   ExprResult ObjRes =
11874     PerformObjectArgumentInitialization(Object.get(), /*Qualifier=*/nullptr,
11875                                         Best->FoundDecl, Method);
11876   if (ObjRes.isInvalid())
11877     IsError = true;
11878   else
11879     Object = ObjRes;
11880   TheCall->setArg(0, Object.get());
11881 
11882   // Check the argument types.
11883   for (unsigned i = 0; i != NumParams; i++) {
11884     Expr *Arg;
11885     if (i < Args.size()) {
11886       Arg = Args[i];
11887 
11888       // Pass the argument.
11889 
11890       ExprResult InputInit
11891         = PerformCopyInitialization(InitializedEntity::InitializeParameter(
11892                                                     Context,
11893                                                     Method->getParamDecl(i)),
11894                                     SourceLocation(), Arg);
11895 
11896       IsError |= InputInit.isInvalid();
11897       Arg = InputInit.getAs<Expr>();
11898     } else {
11899       ExprResult DefArg
11900         = BuildCXXDefaultArgExpr(LParenLoc, Method, Method->getParamDecl(i));
11901       if (DefArg.isInvalid()) {
11902         IsError = true;
11903         break;
11904       }
11905 
11906       Arg = DefArg.getAs<Expr>();
11907     }
11908 
11909     TheCall->setArg(i + 1, Arg);
11910   }
11911 
11912   // If this is a variadic call, handle args passed through "...".
11913   if (Proto->isVariadic()) {
11914     // Promote the arguments (C99 6.5.2.2p7).
11915     for (unsigned i = NumParams, e = Args.size(); i < e; i++) {
11916       ExprResult Arg = DefaultVariadicArgumentPromotion(Args[i], VariadicMethod,
11917                                                         nullptr);
11918       IsError |= Arg.isInvalid();
11919       TheCall->setArg(i + 1, Arg.get());
11920     }
11921   }
11922 
11923   if (IsError) return true;
11924 
11925   DiagnoseSentinelCalls(Method, LParenLoc, Args);
11926 
11927   if (CheckFunctionCall(Method, TheCall, Proto))
11928     return true;
11929 
11930   return MaybeBindToTemporary(TheCall);
11931 }
11932 
11933 /// BuildOverloadedArrowExpr - Build a call to an overloaded @c operator->
11934 ///  (if one exists), where @c Base is an expression of class type and
11935 /// @c Member is the name of the member we're trying to find.
11936 ExprResult
11937 Sema::BuildOverloadedArrowExpr(Scope *S, Expr *Base, SourceLocation OpLoc,
11938                                bool *NoArrowOperatorFound) {
11939   assert(Base->getType()->isRecordType() &&
11940          "left-hand side must have class type");
11941 
11942   if (checkPlaceholderForOverload(*this, Base))
11943     return ExprError();
11944 
11945   SourceLocation Loc = Base->getExprLoc();
11946 
11947   // C++ [over.ref]p1:
11948   //
11949   //   [...] An expression x->m is interpreted as (x.operator->())->m
11950   //   for a class object x of type T if T::operator->() exists and if
11951   //   the operator is selected as the best match function by the
11952   //   overload resolution mechanism (13.3).
11953   DeclarationName OpName =
11954     Context.DeclarationNames.getCXXOperatorName(OO_Arrow);
11955   OverloadCandidateSet CandidateSet(Loc, OverloadCandidateSet::CSK_Operator);
11956   const RecordType *BaseRecord = Base->getType()->getAs<RecordType>();
11957 
11958   if (RequireCompleteType(Loc, Base->getType(),
11959                           diag::err_typecheck_incomplete_tag, Base))
11960     return ExprError();
11961 
11962   LookupResult R(*this, OpName, OpLoc, LookupOrdinaryName);
11963   LookupQualifiedName(R, BaseRecord->getDecl());
11964   R.suppressDiagnostics();
11965 
11966   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
11967        Oper != OperEnd; ++Oper) {
11968     AddMethodCandidate(Oper.getPair(), Base->getType(), Base->Classify(Context),
11969                        None, CandidateSet, /*SuppressUserConversions=*/false);
11970   }
11971 
11972   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11973 
11974   // Perform overload resolution.
11975   OverloadCandidateSet::iterator Best;
11976   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
11977   case OR_Success:
11978     // Overload resolution succeeded; we'll build the call below.
11979     break;
11980 
11981   case OR_No_Viable_Function:
11982     if (CandidateSet.empty()) {
11983       QualType BaseType = Base->getType();
11984       if (NoArrowOperatorFound) {
11985         // Report this specific error to the caller instead of emitting a
11986         // diagnostic, as requested.
11987         *NoArrowOperatorFound = true;
11988         return ExprError();
11989       }
11990       Diag(OpLoc, diag::err_typecheck_member_reference_arrow)
11991         << BaseType << Base->getSourceRange();
11992       if (BaseType->isRecordType() && !BaseType->isPointerType()) {
11993         Diag(OpLoc, diag::note_typecheck_member_reference_suggestion)
11994           << FixItHint::CreateReplacement(OpLoc, ".");
11995       }
11996     } else
11997       Diag(OpLoc, diag::err_ovl_no_viable_oper)
11998         << "operator->" << Base->getSourceRange();
11999     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
12000     return ExprError();
12001 
12002   case OR_Ambiguous:
12003     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
12004       << "->" << Base->getType() << Base->getSourceRange();
12005     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Base);
12006     return ExprError();
12007 
12008   case OR_Deleted:
12009     Diag(OpLoc,  diag::err_ovl_deleted_oper)
12010       << Best->Function->isDeleted()
12011       << "->"
12012       << getDeletedOrUnavailableSuffix(Best->Function)
12013       << Base->getSourceRange();
12014     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
12015     return ExprError();
12016   }
12017 
12018   CheckMemberOperatorAccess(OpLoc, Base, nullptr, Best->FoundDecl);
12019 
12020   // Convert the object parameter.
12021   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
12022   ExprResult BaseResult =
12023     PerformObjectArgumentInitialization(Base, /*Qualifier=*/nullptr,
12024                                         Best->FoundDecl, Method);
12025   if (BaseResult.isInvalid())
12026     return ExprError();
12027   Base = BaseResult.get();
12028 
12029   // Build the operator call.
12030   ExprResult FnExpr = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
12031                                             HadMultipleCandidates, OpLoc);
12032   if (FnExpr.isInvalid())
12033     return ExprError();
12034 
12035   QualType ResultTy = Method->getReturnType();
12036   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
12037   ResultTy = ResultTy.getNonLValueExprType(Context);
12038   CXXOperatorCallExpr *TheCall =
12039     new (Context) CXXOperatorCallExpr(Context, OO_Arrow, FnExpr.get(),
12040                                       Base, ResultTy, VK, OpLoc, false);
12041 
12042   if (CheckCallReturnType(Method->getReturnType(), OpLoc, TheCall, Method))
12043           return ExprError();
12044 
12045   return MaybeBindToTemporary(TheCall);
12046 }
12047 
12048 /// BuildLiteralOperatorCall - Build a UserDefinedLiteral by creating a call to
12049 /// a literal operator described by the provided lookup results.
12050 ExprResult Sema::BuildLiteralOperatorCall(LookupResult &R,
12051                                           DeclarationNameInfo &SuffixInfo,
12052                                           ArrayRef<Expr*> Args,
12053                                           SourceLocation LitEndLoc,
12054                                        TemplateArgumentListInfo *TemplateArgs) {
12055   SourceLocation UDSuffixLoc = SuffixInfo.getCXXLiteralOperatorNameLoc();
12056 
12057   OverloadCandidateSet CandidateSet(UDSuffixLoc,
12058                                     OverloadCandidateSet::CSK_Normal);
12059   AddFunctionCandidates(R.asUnresolvedSet(), Args, CandidateSet, true,
12060                         TemplateArgs);
12061 
12062   bool HadMultipleCandidates = (CandidateSet.size() > 1);
12063 
12064   // Perform overload resolution. This will usually be trivial, but might need
12065   // to perform substitutions for a literal operator template.
12066   OverloadCandidateSet::iterator Best;
12067   switch (CandidateSet.BestViableFunction(*this, UDSuffixLoc, Best)) {
12068   case OR_Success:
12069   case OR_Deleted:
12070     break;
12071 
12072   case OR_No_Viable_Function:
12073     Diag(UDSuffixLoc, diag::err_ovl_no_viable_function_in_call)
12074       << R.getLookupName();
12075     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
12076     return ExprError();
12077 
12078   case OR_Ambiguous:
12079     Diag(R.getNameLoc(), diag::err_ovl_ambiguous_call) << R.getLookupName();
12080     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
12081     return ExprError();
12082   }
12083 
12084   FunctionDecl *FD = Best->Function;
12085   ExprResult Fn = CreateFunctionRefExpr(*this, FD, Best->FoundDecl,
12086                                         HadMultipleCandidates,
12087                                         SuffixInfo.getLoc(),
12088                                         SuffixInfo.getInfo());
12089   if (Fn.isInvalid())
12090     return true;
12091 
12092   // Check the argument types. This should almost always be a no-op, except
12093   // that array-to-pointer decay is applied to string literals.
12094   Expr *ConvArgs[2];
12095   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
12096     ExprResult InputInit = PerformCopyInitialization(
12097       InitializedEntity::InitializeParameter(Context, FD->getParamDecl(ArgIdx)),
12098       SourceLocation(), Args[ArgIdx]);
12099     if (InputInit.isInvalid())
12100       return true;
12101     ConvArgs[ArgIdx] = InputInit.get();
12102   }
12103 
12104   QualType ResultTy = FD->getReturnType();
12105   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
12106   ResultTy = ResultTy.getNonLValueExprType(Context);
12107 
12108   UserDefinedLiteral *UDL =
12109     new (Context) UserDefinedLiteral(Context, Fn.get(),
12110                                      llvm::makeArrayRef(ConvArgs, Args.size()),
12111                                      ResultTy, VK, LitEndLoc, UDSuffixLoc);
12112 
12113   if (CheckCallReturnType(FD->getReturnType(), UDSuffixLoc, UDL, FD))
12114     return ExprError();
12115 
12116   if (CheckFunctionCall(FD, UDL, nullptr))
12117     return ExprError();
12118 
12119   return MaybeBindToTemporary(UDL);
12120 }
12121 
12122 /// Build a call to 'begin' or 'end' for a C++11 for-range statement. If the
12123 /// given LookupResult is non-empty, it is assumed to describe a member which
12124 /// will be invoked. Otherwise, the function will be found via argument
12125 /// dependent lookup.
12126 /// CallExpr is set to a valid expression and FRS_Success returned on success,
12127 /// otherwise CallExpr is set to ExprError() and some non-success value
12128 /// is returned.
12129 Sema::ForRangeStatus
12130 Sema::BuildForRangeBeginEndCall(Scope *S, SourceLocation Loc,
12131                                 SourceLocation RangeLoc, VarDecl *Decl,
12132                                 BeginEndFunction BEF,
12133                                 const DeclarationNameInfo &NameInfo,
12134                                 LookupResult &MemberLookup,
12135                                 OverloadCandidateSet *CandidateSet,
12136                                 Expr *Range, ExprResult *CallExpr) {
12137   CandidateSet->clear();
12138   if (!MemberLookup.empty()) {
12139     ExprResult MemberRef =
12140         BuildMemberReferenceExpr(Range, Range->getType(), Loc,
12141                                  /*IsPtr=*/false, CXXScopeSpec(),
12142                                  /*TemplateKWLoc=*/SourceLocation(),
12143                                  /*FirstQualifierInScope=*/nullptr,
12144                                  MemberLookup,
12145                                  /*TemplateArgs=*/nullptr);
12146     if (MemberRef.isInvalid()) {
12147       *CallExpr = ExprError();
12148       Diag(Range->getLocStart(), diag::note_in_for_range)
12149           << RangeLoc << BEF << Range->getType();
12150       return FRS_DiagnosticIssued;
12151     }
12152     *CallExpr = ActOnCallExpr(S, MemberRef.get(), Loc, None, Loc, nullptr);
12153     if (CallExpr->isInvalid()) {
12154       *CallExpr = ExprError();
12155       Diag(Range->getLocStart(), diag::note_in_for_range)
12156           << RangeLoc << BEF << Range->getType();
12157       return FRS_DiagnosticIssued;
12158     }
12159   } else {
12160     UnresolvedSet<0> FoundNames;
12161     UnresolvedLookupExpr *Fn =
12162       UnresolvedLookupExpr::Create(Context, /*NamingClass=*/nullptr,
12163                                    NestedNameSpecifierLoc(), NameInfo,
12164                                    /*NeedsADL=*/true, /*Overloaded=*/false,
12165                                    FoundNames.begin(), FoundNames.end());
12166 
12167     bool CandidateSetError = buildOverloadedCallSet(S, Fn, Fn, Range, Loc,
12168                                                     CandidateSet, CallExpr);
12169     if (CandidateSet->empty() || CandidateSetError) {
12170       *CallExpr = ExprError();
12171       return FRS_NoViableFunction;
12172     }
12173     OverloadCandidateSet::iterator Best;
12174     OverloadingResult OverloadResult =
12175         CandidateSet->BestViableFunction(*this, Fn->getLocStart(), Best);
12176 
12177     if (OverloadResult == OR_No_Viable_Function) {
12178       *CallExpr = ExprError();
12179       return FRS_NoViableFunction;
12180     }
12181     *CallExpr = FinishOverloadedCallExpr(*this, S, Fn, Fn, Loc, Range,
12182                                          Loc, nullptr, CandidateSet, &Best,
12183                                          OverloadResult,
12184                                          /*AllowTypoCorrection=*/false);
12185     if (CallExpr->isInvalid() || OverloadResult != OR_Success) {
12186       *CallExpr = ExprError();
12187       Diag(Range->getLocStart(), diag::note_in_for_range)
12188           << RangeLoc << BEF << Range->getType();
12189       return FRS_DiagnosticIssued;
12190     }
12191   }
12192   return FRS_Success;
12193 }
12194 
12195 
12196 /// FixOverloadedFunctionReference - E is an expression that refers to
12197 /// a C++ overloaded function (possibly with some parentheses and
12198 /// perhaps a '&' around it). We have resolved the overloaded function
12199 /// to the function declaration Fn, so patch up the expression E to
12200 /// refer (possibly indirectly) to Fn. Returns the new expr.
12201 Expr *Sema::FixOverloadedFunctionReference(Expr *E, DeclAccessPair Found,
12202                                            FunctionDecl *Fn) {
12203   if (ParenExpr *PE = dyn_cast<ParenExpr>(E)) {
12204     Expr *SubExpr = FixOverloadedFunctionReference(PE->getSubExpr(),
12205                                                    Found, Fn);
12206     if (SubExpr == PE->getSubExpr())
12207       return PE;
12208 
12209     return new (Context) ParenExpr(PE->getLParen(), PE->getRParen(), SubExpr);
12210   }
12211 
12212   if (ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(E)) {
12213     Expr *SubExpr = FixOverloadedFunctionReference(ICE->getSubExpr(),
12214                                                    Found, Fn);
12215     assert(Context.hasSameType(ICE->getSubExpr()->getType(),
12216                                SubExpr->getType()) &&
12217            "Implicit cast type cannot be determined from overload");
12218     assert(ICE->path_empty() && "fixing up hierarchy conversion?");
12219     if (SubExpr == ICE->getSubExpr())
12220       return ICE;
12221 
12222     return ImplicitCastExpr::Create(Context, ICE->getType(),
12223                                     ICE->getCastKind(),
12224                                     SubExpr, nullptr,
12225                                     ICE->getValueKind());
12226   }
12227 
12228   if (UnaryOperator *UnOp = dyn_cast<UnaryOperator>(E)) {
12229     assert(UnOp->getOpcode() == UO_AddrOf &&
12230            "Can only take the address of an overloaded function");
12231     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
12232       if (Method->isStatic()) {
12233         // Do nothing: static member functions aren't any different
12234         // from non-member functions.
12235       } else {
12236         // Fix the subexpression, which really has to be an
12237         // UnresolvedLookupExpr holding an overloaded member function
12238         // or template.
12239         Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
12240                                                        Found, Fn);
12241         if (SubExpr == UnOp->getSubExpr())
12242           return UnOp;
12243 
12244         assert(isa<DeclRefExpr>(SubExpr)
12245                && "fixed to something other than a decl ref");
12246         assert(cast<DeclRefExpr>(SubExpr)->getQualifier()
12247                && "fixed to a member ref with no nested name qualifier");
12248 
12249         // We have taken the address of a pointer to member
12250         // function. Perform the computation here so that we get the
12251         // appropriate pointer to member type.
12252         QualType ClassType
12253           = Context.getTypeDeclType(cast<RecordDecl>(Method->getDeclContext()));
12254         QualType MemPtrType
12255           = Context.getMemberPointerType(Fn->getType(), ClassType.getTypePtr());
12256 
12257         return new (Context) UnaryOperator(SubExpr, UO_AddrOf, MemPtrType,
12258                                            VK_RValue, OK_Ordinary,
12259                                            UnOp->getOperatorLoc());
12260       }
12261     }
12262     Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
12263                                                    Found, Fn);
12264     if (SubExpr == UnOp->getSubExpr())
12265       return UnOp;
12266 
12267     return new (Context) UnaryOperator(SubExpr, UO_AddrOf,
12268                                      Context.getPointerType(SubExpr->getType()),
12269                                        VK_RValue, OK_Ordinary,
12270                                        UnOp->getOperatorLoc());
12271   }
12272 
12273   if (UnresolvedLookupExpr *ULE = dyn_cast<UnresolvedLookupExpr>(E)) {
12274     // FIXME: avoid copy.
12275     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
12276     if (ULE->hasExplicitTemplateArgs()) {
12277       ULE->copyTemplateArgumentsInto(TemplateArgsBuffer);
12278       TemplateArgs = &TemplateArgsBuffer;
12279     }
12280 
12281     DeclRefExpr *DRE = DeclRefExpr::Create(Context,
12282                                            ULE->getQualifierLoc(),
12283                                            ULE->getTemplateKeywordLoc(),
12284                                            Fn,
12285                                            /*enclosing*/ false, // FIXME?
12286                                            ULE->getNameLoc(),
12287                                            Fn->getType(),
12288                                            VK_LValue,
12289                                            Found.getDecl(),
12290                                            TemplateArgs);
12291     MarkDeclRefReferenced(DRE);
12292     DRE->setHadMultipleCandidates(ULE->getNumDecls() > 1);
12293     return DRE;
12294   }
12295 
12296   if (UnresolvedMemberExpr *MemExpr = dyn_cast<UnresolvedMemberExpr>(E)) {
12297     // FIXME: avoid copy.
12298     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = nullptr;
12299     if (MemExpr->hasExplicitTemplateArgs()) {
12300       MemExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
12301       TemplateArgs = &TemplateArgsBuffer;
12302     }
12303 
12304     Expr *Base;
12305 
12306     // If we're filling in a static method where we used to have an
12307     // implicit member access, rewrite to a simple decl ref.
12308     if (MemExpr->isImplicitAccess()) {
12309       if (cast<CXXMethodDecl>(Fn)->isStatic()) {
12310         DeclRefExpr *DRE = DeclRefExpr::Create(Context,
12311                                                MemExpr->getQualifierLoc(),
12312                                                MemExpr->getTemplateKeywordLoc(),
12313                                                Fn,
12314                                                /*enclosing*/ false,
12315                                                MemExpr->getMemberLoc(),
12316                                                Fn->getType(),
12317                                                VK_LValue,
12318                                                Found.getDecl(),
12319                                                TemplateArgs);
12320         MarkDeclRefReferenced(DRE);
12321         DRE->setHadMultipleCandidates(MemExpr->getNumDecls() > 1);
12322         return DRE;
12323       } else {
12324         SourceLocation Loc = MemExpr->getMemberLoc();
12325         if (MemExpr->getQualifier())
12326           Loc = MemExpr->getQualifierLoc().getBeginLoc();
12327         CheckCXXThisCapture(Loc);
12328         Base = new (Context) CXXThisExpr(Loc,
12329                                          MemExpr->getBaseType(),
12330                                          /*isImplicit=*/true);
12331       }
12332     } else
12333       Base = MemExpr->getBase();
12334 
12335     ExprValueKind valueKind;
12336     QualType type;
12337     if (cast<CXXMethodDecl>(Fn)->isStatic()) {
12338       valueKind = VK_LValue;
12339       type = Fn->getType();
12340     } else {
12341       valueKind = VK_RValue;
12342       type = Context.BoundMemberTy;
12343     }
12344 
12345     MemberExpr *ME = MemberExpr::Create(Context, Base,
12346                                         MemExpr->isArrow(),
12347                                         MemExpr->getQualifierLoc(),
12348                                         MemExpr->getTemplateKeywordLoc(),
12349                                         Fn,
12350                                         Found,
12351                                         MemExpr->getMemberNameInfo(),
12352                                         TemplateArgs,
12353                                         type, valueKind, OK_Ordinary);
12354     ME->setHadMultipleCandidates(true);
12355     MarkMemberReferenced(ME);
12356     return ME;
12357   }
12358 
12359   llvm_unreachable("Invalid reference to overloaded function");
12360 }
12361 
12362 ExprResult Sema::FixOverloadedFunctionReference(ExprResult E,
12363                                                 DeclAccessPair Found,
12364                                                 FunctionDecl *Fn) {
12365   return FixOverloadedFunctionReference(E.get(), Found, Fn);
12366 }
12367 
12368 } // end namespace clang
12369