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/PartialDiagnostic.h"
24 #include "clang/Lex/Preprocessor.h"
25 #include "clang/Sema/Initialization.h"
26 #include "clang/Sema/Lookup.h"
27 #include "clang/Sema/SemaInternal.h"
28 #include "clang/Sema/Template.h"
29 #include "clang/Sema/TemplateDeduction.h"
30 #include "llvm/ADT/DenseSet.h"
31 #include "llvm/ADT/STLExtras.h"
32 #include "llvm/ADT/SmallPtrSet.h"
33 #include "llvm/ADT/SmallString.h"
34 #include <algorithm>
35 
36 namespace clang {
37 using namespace sema;
38 
39 /// A convenience routine for creating a decayed reference to a function.
40 static ExprResult
41 CreateFunctionRefExpr(Sema &S, FunctionDecl *Fn, NamedDecl *FoundDecl,
42                       bool HadMultipleCandidates,
43                       SourceLocation Loc = SourceLocation(),
44                       const DeclarationNameLoc &LocInfo = DeclarationNameLoc()){
45   if (S.DiagnoseUseOfDecl(FoundDecl, Loc))
46     return ExprError();
47   // If FoundDecl is different from Fn (such as if one is a template
48   // and the other a specialization), make sure DiagnoseUseOfDecl is
49   // called on both.
50   // FIXME: This would be more comprehensively addressed by modifying
51   // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
52   // being used.
53   if (FoundDecl != Fn && S.DiagnoseUseOfDecl(Fn, Loc))
54     return ExprError();
55   DeclRefExpr *DRE = new (S.Context) DeclRefExpr(Fn, false, Fn->getType(),
56                                                  VK_LValue, Loc, LocInfo);
57   if (HadMultipleCandidates)
58     DRE->setHadMultipleCandidates(true);
59 
60   S.MarkDeclRefReferenced(DRE);
61 
62   ExprResult E = S.Owned(DRE);
63   E = S.DefaultFunctionArrayConversion(E.take());
64   if (E.isInvalid())
65     return ExprError();
66   return E;
67 }
68 
69 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
70                                  bool InOverloadResolution,
71                                  StandardConversionSequence &SCS,
72                                  bool CStyle,
73                                  bool AllowObjCWritebackConversion);
74 
75 static bool IsTransparentUnionStandardConversion(Sema &S, Expr* From,
76                                                  QualType &ToType,
77                                                  bool InOverloadResolution,
78                                                  StandardConversionSequence &SCS,
79                                                  bool CStyle);
80 static OverloadingResult
81 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
82                         UserDefinedConversionSequence& User,
83                         OverloadCandidateSet& Conversions,
84                         bool AllowExplicit);
85 
86 
87 static ImplicitConversionSequence::CompareKind
88 CompareStandardConversionSequences(Sema &S,
89                                    const StandardConversionSequence& SCS1,
90                                    const StandardConversionSequence& SCS2);
91 
92 static ImplicitConversionSequence::CompareKind
93 CompareQualificationConversions(Sema &S,
94                                 const StandardConversionSequence& SCS1,
95                                 const StandardConversionSequence& SCS2);
96 
97 static ImplicitConversionSequence::CompareKind
98 CompareDerivedToBaseConversions(Sema &S,
99                                 const StandardConversionSequence& SCS1,
100                                 const StandardConversionSequence& SCS2);
101 
102 
103 
104 /// GetConversionCategory - Retrieve the implicit conversion
105 /// category corresponding to the given implicit conversion kind.
106 ImplicitConversionCategory
107 GetConversionCategory(ImplicitConversionKind Kind) {
108   static const ImplicitConversionCategory
109     Category[(int)ICK_Num_Conversion_Kinds] = {
110     ICC_Identity,
111     ICC_Lvalue_Transformation,
112     ICC_Lvalue_Transformation,
113     ICC_Lvalue_Transformation,
114     ICC_Identity,
115     ICC_Qualification_Adjustment,
116     ICC_Promotion,
117     ICC_Promotion,
118     ICC_Promotion,
119     ICC_Conversion,
120     ICC_Conversion,
121     ICC_Conversion,
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   };
133   return Category[(int)Kind];
134 }
135 
136 /// GetConversionRank - Retrieve the implicit conversion rank
137 /// corresponding to the given implicit conversion kind.
138 ImplicitConversionRank GetConversionRank(ImplicitConversionKind Kind) {
139   static const ImplicitConversionRank
140     Rank[(int)ICK_Num_Conversion_Kinds] = {
141     ICR_Exact_Match,
142     ICR_Exact_Match,
143     ICR_Exact_Match,
144     ICR_Exact_Match,
145     ICR_Exact_Match,
146     ICR_Exact_Match,
147     ICR_Promotion,
148     ICR_Promotion,
149     ICR_Promotion,
150     ICR_Conversion,
151     ICR_Conversion,
152     ICR_Conversion,
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_Complex_Real_Conversion,
162     ICR_Conversion,
163     ICR_Conversion,
164     ICR_Writeback_Conversion
165   };
166   return Rank[(int)Kind];
167 }
168 
169 /// GetImplicitConversionName - Return the name of this kind of
170 /// implicit conversion.
171 const char* GetImplicitConversionName(ImplicitConversionKind Kind) {
172   static const char* const Name[(int)ICK_Num_Conversion_Kinds] = {
173     "No conversion",
174     "Lvalue-to-rvalue",
175     "Array-to-pointer",
176     "Function-to-pointer",
177     "Noreturn adjustment",
178     "Qualification",
179     "Integral promotion",
180     "Floating point promotion",
181     "Complex promotion",
182     "Integral conversion",
183     "Floating conversion",
184     "Complex conversion",
185     "Floating-integral conversion",
186     "Pointer conversion",
187     "Pointer-to-member conversion",
188     "Boolean conversion",
189     "Compatible-types conversion",
190     "Derived-to-base conversion",
191     "Vector conversion",
192     "Vector splat",
193     "Complex-real conversion",
194     "Block Pointer conversion",
195     "Transparent Union Conversion"
196     "Writeback conversion"
197   };
198   return Name[Kind];
199 }
200 
201 /// StandardConversionSequence - Set the standard conversion
202 /// sequence to the identity conversion.
203 void StandardConversionSequence::setAsIdentityConversion() {
204   First = ICK_Identity;
205   Second = ICK_Identity;
206   Third = ICK_Identity;
207   DeprecatedStringLiteralToCharPtr = false;
208   QualificationIncludesObjCLifetime = false;
209   ReferenceBinding = false;
210   DirectBinding = false;
211   IsLvalueReference = true;
212   BindsToFunctionLvalue = false;
213   BindsToRvalue = false;
214   BindsImplicitObjectArgumentWithoutRefQualifier = false;
215   ObjCLifetimeConversionBinding = false;
216   CopyConstructor = 0;
217 }
218 
219 /// getRank - Retrieve the rank of this standard conversion sequence
220 /// (C++ 13.3.3.1.1p3). The rank is the largest rank of each of the
221 /// implicit conversions.
222 ImplicitConversionRank StandardConversionSequence::getRank() const {
223   ImplicitConversionRank Rank = ICR_Exact_Match;
224   if  (GetConversionRank(First) > Rank)
225     Rank = GetConversionRank(First);
226   if  (GetConversionRank(Second) > Rank)
227     Rank = GetConversionRank(Second);
228   if  (GetConversionRank(Third) > Rank)
229     Rank = GetConversionRank(Third);
230   return Rank;
231 }
232 
233 /// isPointerConversionToBool - Determines whether this conversion is
234 /// a conversion of a pointer or pointer-to-member to bool. This is
235 /// used as part of the ranking of standard conversion sequences
236 /// (C++ 13.3.3.2p4).
237 bool StandardConversionSequence::isPointerConversionToBool() const {
238   // Note that FromType has not necessarily been transformed by the
239   // array-to-pointer or function-to-pointer implicit conversions, so
240   // check for their presence as well as checking whether FromType is
241   // a pointer.
242   if (getToType(1)->isBooleanType() &&
243       (getFromType()->isPointerType() ||
244        getFromType()->isObjCObjectPointerType() ||
245        getFromType()->isBlockPointerType() ||
246        getFromType()->isNullPtrType() ||
247        First == ICK_Array_To_Pointer || First == ICK_Function_To_Pointer))
248     return true;
249 
250   return false;
251 }
252 
253 /// isPointerConversionToVoidPointer - Determines whether this
254 /// conversion is a conversion of a pointer to a void pointer. This is
255 /// used as part of the ranking of standard conversion sequences (C++
256 /// 13.3.3.2p4).
257 bool
258 StandardConversionSequence::
259 isPointerConversionToVoidPointer(ASTContext& Context) const {
260   QualType FromType = getFromType();
261   QualType ToType = getToType(1);
262 
263   // Note that FromType has not necessarily been transformed by the
264   // array-to-pointer implicit conversion, so check for its presence
265   // and redo the conversion to get a pointer.
266   if (First == ICK_Array_To_Pointer)
267     FromType = Context.getArrayDecayedType(FromType);
268 
269   if (Second == ICK_Pointer_Conversion && FromType->isAnyPointerType())
270     if (const PointerType* ToPtrType = ToType->getAs<PointerType>())
271       return ToPtrType->getPointeeType()->isVoidType();
272 
273   return false;
274 }
275 
276 /// Skip any implicit casts which could be either part of a narrowing conversion
277 /// or after one in an implicit conversion.
278 static const Expr *IgnoreNarrowingConversion(const Expr *Converted) {
279   while (const ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(Converted)) {
280     switch (ICE->getCastKind()) {
281     case CK_NoOp:
282     case CK_IntegralCast:
283     case CK_IntegralToBoolean:
284     case CK_IntegralToFloating:
285     case CK_FloatingToIntegral:
286     case CK_FloatingToBoolean:
287     case CK_FloatingCast:
288       Converted = ICE->getSubExpr();
289       continue;
290 
291     default:
292       return Converted;
293     }
294   }
295 
296   return Converted;
297 }
298 
299 /// Check if this standard conversion sequence represents a narrowing
300 /// conversion, according to C++11 [dcl.init.list]p7.
301 ///
302 /// \param Ctx  The AST context.
303 /// \param Converted  The result of applying this standard conversion sequence.
304 /// \param ConstantValue  If this is an NK_Constant_Narrowing conversion, the
305 ///        value of the expression prior to the narrowing conversion.
306 /// \param ConstantType  If this is an NK_Constant_Narrowing conversion, the
307 ///        type of the expression prior to the narrowing conversion.
308 NarrowingKind
309 StandardConversionSequence::getNarrowingKind(ASTContext &Ctx,
310                                              const Expr *Converted,
311                                              APValue &ConstantValue,
312                                              QualType &ConstantType) const {
313   assert(Ctx.getLangOpts().CPlusPlus && "narrowing check outside C++");
314 
315   // C++11 [dcl.init.list]p7:
316   //   A narrowing conversion is an implicit conversion ...
317   QualType FromType = getToType(0);
318   QualType ToType = getToType(1);
319   switch (Second) {
320   // -- from a floating-point type to an integer type, or
321   //
322   // -- from an integer type or unscoped enumeration type to a floating-point
323   //    type, except where the source is a constant expression and the actual
324   //    value after conversion will fit into the target type and will produce
325   //    the original value when converted back to the original type, or
326   case ICK_Floating_Integral:
327     if (FromType->isRealFloatingType() && ToType->isIntegralType(Ctx)) {
328       return NK_Type_Narrowing;
329     } else if (FromType->isIntegralType(Ctx) && ToType->isRealFloatingType()) {
330       llvm::APSInt IntConstantValue;
331       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
332       if (Initializer &&
333           Initializer->isIntegerConstantExpr(IntConstantValue, Ctx)) {
334         // Convert the integer to the floating type.
335         llvm::APFloat Result(Ctx.getFloatTypeSemantics(ToType));
336         Result.convertFromAPInt(IntConstantValue, IntConstantValue.isSigned(),
337                                 llvm::APFloat::rmNearestTiesToEven);
338         // And back.
339         llvm::APSInt ConvertedValue = IntConstantValue;
340         bool ignored;
341         Result.convertToInteger(ConvertedValue,
342                                 llvm::APFloat::rmTowardZero, &ignored);
343         // If the resulting value is different, this was a narrowing conversion.
344         if (IntConstantValue != ConvertedValue) {
345           ConstantValue = APValue(IntConstantValue);
346           ConstantType = Initializer->getType();
347           return NK_Constant_Narrowing;
348         }
349       } else {
350         // Variables are always narrowings.
351         return NK_Variable_Narrowing;
352       }
353     }
354     return NK_Not_Narrowing;
355 
356   // -- from long double to double or float, or from double to float, except
357   //    where the source is a constant expression and the actual value after
358   //    conversion is within the range of values that can be represented (even
359   //    if it cannot be represented exactly), or
360   case ICK_Floating_Conversion:
361     if (FromType->isRealFloatingType() && ToType->isRealFloatingType() &&
362         Ctx.getFloatingTypeOrder(FromType, ToType) == 1) {
363       // FromType is larger than ToType.
364       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
365       if (Initializer->isCXX11ConstantExpr(Ctx, &ConstantValue)) {
366         // Constant!
367         assert(ConstantValue.isFloat());
368         llvm::APFloat FloatVal = ConstantValue.getFloat();
369         // Convert the source value into the target type.
370         bool ignored;
371         llvm::APFloat::opStatus ConvertStatus = FloatVal.convert(
372           Ctx.getFloatTypeSemantics(ToType),
373           llvm::APFloat::rmNearestTiesToEven, &ignored);
374         // If there was no overflow, the source value is within the range of
375         // values that can be represented.
376         if (ConvertStatus & llvm::APFloat::opOverflow) {
377           ConstantType = Initializer->getType();
378           return NK_Constant_Narrowing;
379         }
380       } else {
381         return NK_Variable_Narrowing;
382       }
383     }
384     return NK_Not_Narrowing;
385 
386   // -- from an integer type or unscoped enumeration type to an integer type
387   //    that cannot represent all the values of the original type, except where
388   //    the source is a constant expression and the actual value after
389   //    conversion will fit into the target type and will produce the original
390   //    value when converted back to the original type.
391   case ICK_Boolean_Conversion:  // Bools are integers too.
392     if (!FromType->isIntegralOrUnscopedEnumerationType()) {
393       // Boolean conversions can be from pointers and pointers to members
394       // [conv.bool], and those aren't considered narrowing conversions.
395       return NK_Not_Narrowing;
396     }  // Otherwise, fall through to the integral case.
397   case ICK_Integral_Conversion: {
398     assert(FromType->isIntegralOrUnscopedEnumerationType());
399     assert(ToType->isIntegralOrUnscopedEnumerationType());
400     const bool FromSigned = FromType->isSignedIntegerOrEnumerationType();
401     const unsigned FromWidth = Ctx.getIntWidth(FromType);
402     const bool ToSigned = ToType->isSignedIntegerOrEnumerationType();
403     const unsigned ToWidth = Ctx.getIntWidth(ToType);
404 
405     if (FromWidth > ToWidth ||
406         (FromWidth == ToWidth && FromSigned != ToSigned) ||
407         (FromSigned && !ToSigned)) {
408       // Not all values of FromType can be represented in ToType.
409       llvm::APSInt InitializerValue;
410       const Expr *Initializer = IgnoreNarrowingConversion(Converted);
411       if (!Initializer->isIntegerConstantExpr(InitializerValue, Ctx)) {
412         // Such conversions on variables are always narrowing.
413         return NK_Variable_Narrowing;
414       }
415       bool Narrowing = false;
416       if (FromWidth < ToWidth) {
417         // Negative -> unsigned is narrowing. Otherwise, more bits is never
418         // narrowing.
419         if (InitializerValue.isSigned() && InitializerValue.isNegative())
420           Narrowing = true;
421       } else {
422         // Add a bit to the InitializerValue so we don't have to worry about
423         // signed vs. unsigned comparisons.
424         InitializerValue = InitializerValue.extend(
425           InitializerValue.getBitWidth() + 1);
426         // Convert the initializer to and from the target width and signed-ness.
427         llvm::APSInt ConvertedValue = InitializerValue;
428         ConvertedValue = ConvertedValue.trunc(ToWidth);
429         ConvertedValue.setIsSigned(ToSigned);
430         ConvertedValue = ConvertedValue.extend(InitializerValue.getBitWidth());
431         ConvertedValue.setIsSigned(InitializerValue.isSigned());
432         // If the result is different, this was a narrowing conversion.
433         if (ConvertedValue != InitializerValue)
434           Narrowing = true;
435       }
436       if (Narrowing) {
437         ConstantType = Initializer->getType();
438         ConstantValue = APValue(InitializerValue);
439         return NK_Constant_Narrowing;
440       }
441     }
442     return NK_Not_Narrowing;
443   }
444 
445   default:
446     // Other kinds of conversions are not narrowings.
447     return NK_Not_Narrowing;
448   }
449 }
450 
451 /// DebugPrint - Print this standard conversion sequence to standard
452 /// error. Useful for debugging overloading issues.
453 void StandardConversionSequence::DebugPrint() const {
454   raw_ostream &OS = llvm::errs();
455   bool PrintedSomething = false;
456   if (First != ICK_Identity) {
457     OS << GetImplicitConversionName(First);
458     PrintedSomething = true;
459   }
460 
461   if (Second != ICK_Identity) {
462     if (PrintedSomething) {
463       OS << " -> ";
464     }
465     OS << GetImplicitConversionName(Second);
466 
467     if (CopyConstructor) {
468       OS << " (by copy constructor)";
469     } else if (DirectBinding) {
470       OS << " (direct reference binding)";
471     } else if (ReferenceBinding) {
472       OS << " (reference binding)";
473     }
474     PrintedSomething = true;
475   }
476 
477   if (Third != ICK_Identity) {
478     if (PrintedSomething) {
479       OS << " -> ";
480     }
481     OS << GetImplicitConversionName(Third);
482     PrintedSomething = true;
483   }
484 
485   if (!PrintedSomething) {
486     OS << "No conversions required";
487   }
488 }
489 
490 /// DebugPrint - Print this user-defined conversion sequence to standard
491 /// error. Useful for debugging overloading issues.
492 void UserDefinedConversionSequence::DebugPrint() const {
493   raw_ostream &OS = llvm::errs();
494   if (Before.First || Before.Second || Before.Third) {
495     Before.DebugPrint();
496     OS << " -> ";
497   }
498   if (ConversionFunction)
499     OS << '\'' << *ConversionFunction << '\'';
500   else
501     OS << "aggregate initialization";
502   if (After.First || After.Second || After.Third) {
503     OS << " -> ";
504     After.DebugPrint();
505   }
506 }
507 
508 /// DebugPrint - Print this implicit conversion sequence to standard
509 /// error. Useful for debugging overloading issues.
510 void ImplicitConversionSequence::DebugPrint() const {
511   raw_ostream &OS = llvm::errs();
512   switch (ConversionKind) {
513   case StandardConversion:
514     OS << "Standard conversion: ";
515     Standard.DebugPrint();
516     break;
517   case UserDefinedConversion:
518     OS << "User-defined conversion: ";
519     UserDefined.DebugPrint();
520     break;
521   case EllipsisConversion:
522     OS << "Ellipsis conversion";
523     break;
524   case AmbiguousConversion:
525     OS << "Ambiguous conversion";
526     break;
527   case BadConversion:
528     OS << "Bad conversion";
529     break;
530   }
531 
532   OS << "\n";
533 }
534 
535 void AmbiguousConversionSequence::construct() {
536   new (&conversions()) ConversionSet();
537 }
538 
539 void AmbiguousConversionSequence::destruct() {
540   conversions().~ConversionSet();
541 }
542 
543 void
544 AmbiguousConversionSequence::copyFrom(const AmbiguousConversionSequence &O) {
545   FromTypePtr = O.FromTypePtr;
546   ToTypePtr = O.ToTypePtr;
547   new (&conversions()) ConversionSet(O.conversions());
548 }
549 
550 namespace {
551   // Structure used by OverloadCandidate::DeductionFailureInfo to store
552   // template argument information.
553   struct DFIArguments {
554     TemplateArgument FirstArg;
555     TemplateArgument SecondArg;
556   };
557   // Structure used by OverloadCandidate::DeductionFailureInfo to store
558   // template parameter and template argument information.
559   struct DFIParamWithArguments : DFIArguments {
560     TemplateParameter Param;
561   };
562 }
563 
564 /// \brief Convert from Sema's representation of template deduction information
565 /// to the form used in overload-candidate information.
566 OverloadCandidate::DeductionFailureInfo
567 static MakeDeductionFailureInfo(ASTContext &Context,
568                                 Sema::TemplateDeductionResult TDK,
569                                 TemplateDeductionInfo &Info) {
570   OverloadCandidate::DeductionFailureInfo Result;
571   Result.Result = static_cast<unsigned>(TDK);
572   Result.HasDiagnostic = false;
573   Result.Data = 0;
574   switch (TDK) {
575   case Sema::TDK_Success:
576   case Sema::TDK_Invalid:
577   case Sema::TDK_InstantiationDepth:
578   case Sema::TDK_TooManyArguments:
579   case Sema::TDK_TooFewArguments:
580     break;
581 
582   case Sema::TDK_Incomplete:
583   case Sema::TDK_InvalidExplicitArguments:
584     Result.Data = Info.Param.getOpaqueValue();
585     break;
586 
587   case Sema::TDK_NonDeducedMismatch: {
588     // FIXME: Should allocate from normal heap so that we can free this later.
589     DFIArguments *Saved = new (Context) DFIArguments;
590     Saved->FirstArg = Info.FirstArg;
591     Saved->SecondArg = Info.SecondArg;
592     Result.Data = Saved;
593     break;
594   }
595 
596   case Sema::TDK_Inconsistent:
597   case Sema::TDK_Underqualified: {
598     // FIXME: Should allocate from normal heap so that we can free this later.
599     DFIParamWithArguments *Saved = new (Context) DFIParamWithArguments;
600     Saved->Param = Info.Param;
601     Saved->FirstArg = Info.FirstArg;
602     Saved->SecondArg = Info.SecondArg;
603     Result.Data = Saved;
604     break;
605   }
606 
607   case Sema::TDK_SubstitutionFailure:
608     Result.Data = Info.take();
609     if (Info.hasSFINAEDiagnostic()) {
610       PartialDiagnosticAt *Diag = new (Result.Diagnostic) PartialDiagnosticAt(
611           SourceLocation(), PartialDiagnostic::NullDiagnostic());
612       Info.takeSFINAEDiagnostic(*Diag);
613       Result.HasDiagnostic = true;
614     }
615     break;
616 
617   case Sema::TDK_FailedOverloadResolution:
618     Result.Data = Info.Expression;
619     break;
620 
621   case Sema::TDK_MiscellaneousDeductionFailure:
622     break;
623   }
624 
625   return Result;
626 }
627 
628 void OverloadCandidate::DeductionFailureInfo::Destroy() {
629   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
630   case Sema::TDK_Success:
631   case Sema::TDK_Invalid:
632   case Sema::TDK_InstantiationDepth:
633   case Sema::TDK_Incomplete:
634   case Sema::TDK_TooManyArguments:
635   case Sema::TDK_TooFewArguments:
636   case Sema::TDK_InvalidExplicitArguments:
637   case Sema::TDK_FailedOverloadResolution:
638     break;
639 
640   case Sema::TDK_Inconsistent:
641   case Sema::TDK_Underqualified:
642   case Sema::TDK_NonDeducedMismatch:
643     // FIXME: Destroy the data?
644     Data = 0;
645     break;
646 
647   case Sema::TDK_SubstitutionFailure:
648     // FIXME: Destroy the template argument list?
649     Data = 0;
650     if (PartialDiagnosticAt *Diag = getSFINAEDiagnostic()) {
651       Diag->~PartialDiagnosticAt();
652       HasDiagnostic = false;
653     }
654     break;
655 
656   // Unhandled
657   case Sema::TDK_MiscellaneousDeductionFailure:
658     break;
659   }
660 }
661 
662 PartialDiagnosticAt *
663 OverloadCandidate::DeductionFailureInfo::getSFINAEDiagnostic() {
664   if (HasDiagnostic)
665     return static_cast<PartialDiagnosticAt*>(static_cast<void*>(Diagnostic));
666   return 0;
667 }
668 
669 TemplateParameter
670 OverloadCandidate::DeductionFailureInfo::getTemplateParameter() {
671   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
672   case Sema::TDK_Success:
673   case Sema::TDK_Invalid:
674   case Sema::TDK_InstantiationDepth:
675   case Sema::TDK_TooManyArguments:
676   case Sema::TDK_TooFewArguments:
677   case Sema::TDK_SubstitutionFailure:
678   case Sema::TDK_NonDeducedMismatch:
679   case Sema::TDK_FailedOverloadResolution:
680     return TemplateParameter();
681 
682   case Sema::TDK_Incomplete:
683   case Sema::TDK_InvalidExplicitArguments:
684     return TemplateParameter::getFromOpaqueValue(Data);
685 
686   case Sema::TDK_Inconsistent:
687   case Sema::TDK_Underqualified:
688     return static_cast<DFIParamWithArguments*>(Data)->Param;
689 
690   // Unhandled
691   case Sema::TDK_MiscellaneousDeductionFailure:
692     break;
693   }
694 
695   return TemplateParameter();
696 }
697 
698 TemplateArgumentList *
699 OverloadCandidate::DeductionFailureInfo::getTemplateArgumentList() {
700   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
701   case Sema::TDK_Success:
702   case Sema::TDK_Invalid:
703   case Sema::TDK_InstantiationDepth:
704   case Sema::TDK_TooManyArguments:
705   case Sema::TDK_TooFewArguments:
706   case Sema::TDK_Incomplete:
707   case Sema::TDK_InvalidExplicitArguments:
708   case Sema::TDK_Inconsistent:
709   case Sema::TDK_Underqualified:
710   case Sema::TDK_NonDeducedMismatch:
711   case Sema::TDK_FailedOverloadResolution:
712     return 0;
713 
714   case Sema::TDK_SubstitutionFailure:
715     return static_cast<TemplateArgumentList*>(Data);
716 
717   // Unhandled
718   case Sema::TDK_MiscellaneousDeductionFailure:
719     break;
720   }
721 
722   return 0;
723 }
724 
725 const TemplateArgument *OverloadCandidate::DeductionFailureInfo::getFirstArg() {
726   switch (static_cast<Sema::TemplateDeductionResult>(Result)) {
727   case Sema::TDK_Success:
728   case Sema::TDK_Invalid:
729   case Sema::TDK_InstantiationDepth:
730   case Sema::TDK_Incomplete:
731   case Sema::TDK_TooManyArguments:
732   case Sema::TDK_TooFewArguments:
733   case Sema::TDK_InvalidExplicitArguments:
734   case Sema::TDK_SubstitutionFailure:
735   case Sema::TDK_FailedOverloadResolution:
736     return 0;
737 
738   case Sema::TDK_Inconsistent:
739   case Sema::TDK_Underqualified:
740   case Sema::TDK_NonDeducedMismatch:
741     return &static_cast<DFIArguments*>(Data)->FirstArg;
742 
743   // Unhandled
744   case Sema::TDK_MiscellaneousDeductionFailure:
745     break;
746   }
747 
748   return 0;
749 }
750 
751 const TemplateArgument *
752 OverloadCandidate::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 0;
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 0;
776 }
777 
778 Expr *
779 OverloadCandidate::DeductionFailureInfo::getExpr() {
780   if (static_cast<Sema::TemplateDeductionResult>(Result) ==
781         Sema::TDK_FailedOverloadResolution)
782     return static_cast<Expr*>(Data);
783 
784   return 0;
785 }
786 
787 void OverloadCandidateSet::destroyCandidates() {
788   for (iterator i = begin(), e = end(); i != e; ++i) {
789     for (unsigned ii = 0, ie = i->NumConversions; ii != ie; ++ii)
790       i->Conversions[ii].~ImplicitConversionSequence();
791     if (!i->Viable && i->FailureKind == ovl_fail_bad_deduction)
792       i->DeductionFailure.Destroy();
793   }
794 }
795 
796 void OverloadCandidateSet::clear() {
797   destroyCandidates();
798   NumInlineSequences = 0;
799   Candidates.clear();
800   Functions.clear();
801 }
802 
803 namespace {
804   class UnbridgedCastsSet {
805     struct Entry {
806       Expr **Addr;
807       Expr *Saved;
808     };
809     SmallVector<Entry, 2> Entries;
810 
811   public:
812     void save(Sema &S, Expr *&E) {
813       assert(E->hasPlaceholderType(BuiltinType::ARCUnbridgedCast));
814       Entry entry = { &E, E };
815       Entries.push_back(entry);
816       E = S.stripARCUnbridgedCast(E);
817     }
818 
819     void restore() {
820       for (SmallVectorImpl<Entry>::iterator
821              i = Entries.begin(), e = Entries.end(); i != e; ++i)
822         *i->Addr = i->Saved;
823     }
824   };
825 }
826 
827 /// checkPlaceholderForOverload - Do any interesting placeholder-like
828 /// preprocessing on the given expression.
829 ///
830 /// \param unbridgedCasts a collection to which to add unbridged casts;
831 ///   without this, they will be immediately diagnosed as errors
832 ///
833 /// Return true on unrecoverable error.
834 static bool checkPlaceholderForOverload(Sema &S, Expr *&E,
835                                         UnbridgedCastsSet *unbridgedCasts = 0) {
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.take();
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 (FunctionTemplateDecl *OldT = dyn_cast<FunctionTemplateDecl>(OldD)) {
936       if (!IsOverload(New, OldT->getTemplatedDecl(), UseMemberUsingDeclRules)) {
937         if (UseMemberUsingDeclRules && OldIsUsingDecl) {
938           HideUsingShadowDecl(S, cast<UsingShadowDecl>(*I));
939           continue;
940         }
941 
942         Match = *I;
943         return Ovl_Match;
944       }
945     } else if (FunctionDecl *OldF = dyn_cast<FunctionDecl>(OldD)) {
946       if (!IsOverload(New, OldF, UseMemberUsingDeclRules)) {
947         if (UseMemberUsingDeclRules && OldIsUsingDecl) {
948           HideUsingShadowDecl(S, cast<UsingShadowDecl>(*I));
949           continue;
950         }
951 
952         if (!shouldLinkPossiblyHiddenDecl(*I, New))
953           continue;
954 
955         Match = *I;
956         return Ovl_Match;
957       }
958     } else if (isa<UsingDecl>(OldD)) {
959       // We can overload with these, which can show up when doing
960       // redeclaration checks for UsingDecls.
961       assert(Old.getLookupKind() == LookupUsingDeclName);
962     } else if (isa<TagDecl>(OldD)) {
963       // We can always overload with tags by hiding them.
964     } else if (isa<UnresolvedUsingValueDecl>(OldD)) {
965       // Optimistically assume that an unresolved using decl will
966       // overload; if it doesn't, we'll have to diagnose during
967       // template instantiation.
968     } else {
969       // (C++ 13p1):
970       //   Only function declarations can be overloaded; object and type
971       //   declarations cannot be overloaded.
972       Match = *I;
973       return Ovl_NonFunction;
974     }
975   }
976 
977   return Ovl_Overload;
978 }
979 
980 static bool canBeOverloaded(const FunctionDecl &D) {
981   if (D.getAttr<OverloadableAttr>())
982     return true;
983   if (D.isExternC())
984     return false;
985 
986   // Main cannot be overloaded (basic.start.main).
987   if (D.isMain())
988     return false;
989 
990   return true;
991 }
992 
993 static bool shouldTryToOverload(Sema &S, FunctionDecl *New, FunctionDecl *Old,
994                                 bool UseUsingDeclRules) {
995   FunctionTemplateDecl *OldTemplate = Old->getDescribedFunctionTemplate();
996   FunctionTemplateDecl *NewTemplate = New->getDescribedFunctionTemplate();
997 
998   // C++ [temp.fct]p2:
999   //   A function template can be overloaded with other function templates
1000   //   and with normal (non-template) functions.
1001   if ((OldTemplate == 0) != (NewTemplate == 0))
1002     return true;
1003 
1004   // Is the function New an overload of the function Old?
1005   QualType OldQType = S.Context.getCanonicalType(Old->getType());
1006   QualType NewQType = S.Context.getCanonicalType(New->getType());
1007 
1008   // Compare the signatures (C++ 1.3.10) of the two functions to
1009   // determine whether they are overloads. If we find any mismatch
1010   // in the signature, they are overloads.
1011 
1012   // If either of these functions is a K&R-style function (no
1013   // prototype), then we consider them to have matching signatures.
1014   if (isa<FunctionNoProtoType>(OldQType.getTypePtr()) ||
1015       isa<FunctionNoProtoType>(NewQType.getTypePtr()))
1016     return false;
1017 
1018   const FunctionProtoType* OldType = cast<FunctionProtoType>(OldQType);
1019   const FunctionProtoType* NewType = cast<FunctionProtoType>(NewQType);
1020 
1021   // The signature of a function includes the types of its
1022   // parameters (C++ 1.3.10), which includes the presence or absence
1023   // of the ellipsis; see C++ DR 357).
1024   if (OldQType != NewQType &&
1025       (OldType->getNumArgs() != NewType->getNumArgs() ||
1026        OldType->isVariadic() != NewType->isVariadic() ||
1027        !S.FunctionArgTypesAreEqual(OldType, NewType)))
1028     return true;
1029 
1030   // C++ [temp.over.link]p4:
1031   //   The signature of a function template consists of its function
1032   //   signature, its return type and its template parameter list. The names
1033   //   of the template parameters are significant only for establishing the
1034   //   relationship between the template parameters and the rest of the
1035   //   signature.
1036   //
1037   // We check the return type and template parameter lists for function
1038   // templates first; the remaining checks follow.
1039   //
1040   // However, we don't consider either of these when deciding whether
1041   // a member introduced by a shadow declaration is hidden.
1042   if (!UseUsingDeclRules && NewTemplate &&
1043       (!S.TemplateParameterListsAreEqual(NewTemplate->getTemplateParameters(),
1044                                          OldTemplate->getTemplateParameters(),
1045                                          false, S.TPL_TemplateMatch) ||
1046        OldType->getResultType() != NewType->getResultType()))
1047     return true;
1048 
1049   // If the function is a class member, its signature includes the
1050   // cv-qualifiers (if any) and ref-qualifier (if any) on the function itself.
1051   //
1052   // As part of this, also check whether one of the member functions
1053   // is static, in which case they are not overloads (C++
1054   // 13.1p2). While not part of the definition of the signature,
1055   // this check is important to determine whether these functions
1056   // can be overloaded.
1057   CXXMethodDecl *OldMethod = dyn_cast<CXXMethodDecl>(Old);
1058   CXXMethodDecl *NewMethod = dyn_cast<CXXMethodDecl>(New);
1059   if (OldMethod && NewMethod &&
1060       !OldMethod->isStatic() && !NewMethod->isStatic()) {
1061     if (OldMethod->getRefQualifier() != NewMethod->getRefQualifier()) {
1062       if (!UseUsingDeclRules &&
1063           (OldMethod->getRefQualifier() == RQ_None ||
1064            NewMethod->getRefQualifier() == RQ_None)) {
1065         // C++0x [over.load]p2:
1066         //   - Member function declarations with the same name and the same
1067         //     parameter-type-list as well as member function template
1068         //     declarations with the same name, the same parameter-type-list, and
1069         //     the same template parameter lists cannot be overloaded if any of
1070         //     them, but not all, have a ref-qualifier (8.3.5).
1071         S.Diag(NewMethod->getLocation(), diag::err_ref_qualifier_overload)
1072           << NewMethod->getRefQualifier() << OldMethod->getRefQualifier();
1073         S.Diag(OldMethod->getLocation(), diag::note_previous_declaration);
1074       }
1075       return true;
1076     }
1077 
1078     // We may not have applied the implicit const for a constexpr member
1079     // function yet (because we haven't yet resolved whether this is a static
1080     // or non-static member function). Add it now, on the assumption that this
1081     // is a redeclaration of OldMethod.
1082     unsigned NewQuals = NewMethod->getTypeQualifiers();
1083     if (NewMethod->isConstexpr() && !isa<CXXConstructorDecl>(NewMethod))
1084       NewQuals |= Qualifiers::Const;
1085     if (OldMethod->getTypeQualifiers() != NewQuals)
1086       return true;
1087   }
1088 
1089   // The signatures match; this is not an overload.
1090   return false;
1091 }
1092 
1093 bool Sema::IsOverload(FunctionDecl *New, FunctionDecl *Old,
1094                       bool UseUsingDeclRules) {
1095   if (!shouldTryToOverload(*this, New, Old, UseUsingDeclRules))
1096     return false;
1097 
1098   // If both of the functions are extern "C", then they are not
1099   // overloads.
1100   if (!canBeOverloaded(*Old) && !canBeOverloaded(*New))
1101     return false;
1102 
1103   return true;
1104 }
1105 
1106 /// \brief Checks availability of the function depending on the current
1107 /// function context. Inside an unavailable function, unavailability is ignored.
1108 ///
1109 /// \returns true if \arg FD is unavailable and current context is inside
1110 /// an available function, false otherwise.
1111 bool Sema::isFunctionConsideredUnavailable(FunctionDecl *FD) {
1112   return FD->isUnavailable() && !cast<Decl>(CurContext)->isUnavailable();
1113 }
1114 
1115 /// \brief Tries a user-defined conversion from From to ToType.
1116 ///
1117 /// Produces an implicit conversion sequence for when a standard conversion
1118 /// is not an option. See TryImplicitConversion for more information.
1119 static ImplicitConversionSequence
1120 TryUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
1121                          bool SuppressUserConversions,
1122                          bool AllowExplicit,
1123                          bool InOverloadResolution,
1124                          bool CStyle,
1125                          bool AllowObjCWritebackConversion) {
1126   ImplicitConversionSequence ICS;
1127 
1128   if (SuppressUserConversions) {
1129     // We're not in the case above, so there is no conversion that
1130     // we can perform.
1131     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1132     return ICS;
1133   }
1134 
1135   // Attempt user-defined conversion.
1136   OverloadCandidateSet Conversions(From->getExprLoc());
1137   OverloadingResult UserDefResult
1138     = IsUserDefinedConversion(S, From, ToType, ICS.UserDefined, Conversions,
1139                               AllowExplicit);
1140 
1141   if (UserDefResult == OR_Success) {
1142     ICS.setUserDefined();
1143     // C++ [over.ics.user]p4:
1144     //   A conversion of an expression of class type to the same class
1145     //   type is given Exact Match rank, and a conversion of an
1146     //   expression of class type to a base class of that type is
1147     //   given Conversion rank, in spite of the fact that a copy
1148     //   constructor (i.e., a user-defined conversion function) is
1149     //   called for those cases.
1150     if (CXXConstructorDecl *Constructor
1151           = dyn_cast<CXXConstructorDecl>(ICS.UserDefined.ConversionFunction)) {
1152       QualType FromCanon
1153         = S.Context.getCanonicalType(From->getType().getUnqualifiedType());
1154       QualType ToCanon
1155         = S.Context.getCanonicalType(ToType).getUnqualifiedType();
1156       if (Constructor->isCopyConstructor() &&
1157           (FromCanon == ToCanon || S.IsDerivedFrom(FromCanon, ToCanon))) {
1158         // Turn this into a "standard" conversion sequence, so that it
1159         // gets ranked with standard conversion sequences.
1160         ICS.setStandard();
1161         ICS.Standard.setAsIdentityConversion();
1162         ICS.Standard.setFromType(From->getType());
1163         ICS.Standard.setAllToTypes(ToType);
1164         ICS.Standard.CopyConstructor = Constructor;
1165         if (ToCanon != FromCanon)
1166           ICS.Standard.Second = ICK_Derived_To_Base;
1167       }
1168     }
1169 
1170     // C++ [over.best.ics]p4:
1171     //   However, when considering the argument of a user-defined
1172     //   conversion function that is a candidate by 13.3.1.3 when
1173     //   invoked for the copying of the temporary in the second step
1174     //   of a class copy-initialization, or by 13.3.1.4, 13.3.1.5, or
1175     //   13.3.1.6 in all cases, only standard conversion sequences and
1176     //   ellipsis conversion sequences are allowed.
1177     if (SuppressUserConversions && ICS.isUserDefined()) {
1178       ICS.setBad(BadConversionSequence::suppressed_user, From, ToType);
1179     }
1180   } else if (UserDefResult == OR_Ambiguous && !SuppressUserConversions) {
1181     ICS.setAmbiguous();
1182     ICS.Ambiguous.setFromType(From->getType());
1183     ICS.Ambiguous.setToType(ToType);
1184     for (OverloadCandidateSet::iterator Cand = Conversions.begin();
1185          Cand != Conversions.end(); ++Cand)
1186       if (Cand->Viable)
1187         ICS.Ambiguous.addConversion(Cand->Function);
1188   } else {
1189     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1190   }
1191 
1192   return ICS;
1193 }
1194 
1195 /// TryImplicitConversion - Attempt to perform an implicit conversion
1196 /// from the given expression (Expr) to the given type (ToType). This
1197 /// function returns an implicit conversion sequence that can be used
1198 /// to perform the initialization. Given
1199 ///
1200 ///   void f(float f);
1201 ///   void g(int i) { f(i); }
1202 ///
1203 /// this routine would produce an implicit conversion sequence to
1204 /// describe the initialization of f from i, which will be a standard
1205 /// conversion sequence containing an lvalue-to-rvalue conversion (C++
1206 /// 4.1) followed by a floating-integral conversion (C++ 4.9).
1207 //
1208 /// Note that this routine only determines how the conversion can be
1209 /// performed; it does not actually perform the conversion. As such,
1210 /// it will not produce any diagnostics if no conversion is available,
1211 /// but will instead return an implicit conversion sequence of kind
1212 /// "BadConversion".
1213 ///
1214 /// If @p SuppressUserConversions, then user-defined conversions are
1215 /// not permitted.
1216 /// If @p AllowExplicit, then explicit user-defined conversions are
1217 /// permitted.
1218 ///
1219 /// \param AllowObjCWritebackConversion Whether we allow the Objective-C
1220 /// writeback conversion, which allows __autoreleasing id* parameters to
1221 /// be initialized with __strong id* or __weak id* arguments.
1222 static ImplicitConversionSequence
1223 TryImplicitConversion(Sema &S, Expr *From, QualType ToType,
1224                       bool SuppressUserConversions,
1225                       bool AllowExplicit,
1226                       bool InOverloadResolution,
1227                       bool CStyle,
1228                       bool AllowObjCWritebackConversion) {
1229   ImplicitConversionSequence ICS;
1230   if (IsStandardConversion(S, From, ToType, InOverloadResolution,
1231                            ICS.Standard, CStyle, AllowObjCWritebackConversion)){
1232     ICS.setStandard();
1233     return ICS;
1234   }
1235 
1236   if (!S.getLangOpts().CPlusPlus) {
1237     ICS.setBad(BadConversionSequence::no_conversion, From, ToType);
1238     return ICS;
1239   }
1240 
1241   // C++ [over.ics.user]p4:
1242   //   A conversion of an expression of class type to the same class
1243   //   type is given Exact Match rank, and a conversion of an
1244   //   expression of class type to a base class of that type is
1245   //   given Conversion rank, in spite of the fact that a copy/move
1246   //   constructor (i.e., a user-defined conversion function) is
1247   //   called for those cases.
1248   QualType FromType = From->getType();
1249   if (ToType->getAs<RecordType>() && FromType->getAs<RecordType>() &&
1250       (S.Context.hasSameUnqualifiedType(FromType, ToType) ||
1251        S.IsDerivedFrom(FromType, ToType))) {
1252     ICS.setStandard();
1253     ICS.Standard.setAsIdentityConversion();
1254     ICS.Standard.setFromType(FromType);
1255     ICS.Standard.setAllToTypes(ToType);
1256 
1257     // We don't actually check at this point whether there is a valid
1258     // copy/move constructor, since overloading just assumes that it
1259     // exists. When we actually perform initialization, we'll find the
1260     // appropriate constructor to copy the returned object, if needed.
1261     ICS.Standard.CopyConstructor = 0;
1262 
1263     // Determine whether this is considered a derived-to-base conversion.
1264     if (!S.Context.hasSameUnqualifiedType(FromType, ToType))
1265       ICS.Standard.Second = ICK_Derived_To_Base;
1266 
1267     return ICS;
1268   }
1269 
1270   return TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
1271                                   AllowExplicit, InOverloadResolution, CStyle,
1272                                   AllowObjCWritebackConversion);
1273 }
1274 
1275 ImplicitConversionSequence
1276 Sema::TryImplicitConversion(Expr *From, QualType ToType,
1277                             bool SuppressUserConversions,
1278                             bool AllowExplicit,
1279                             bool InOverloadResolution,
1280                             bool CStyle,
1281                             bool AllowObjCWritebackConversion) {
1282   return clang::TryImplicitConversion(*this, From, ToType,
1283                                       SuppressUserConversions, AllowExplicit,
1284                                       InOverloadResolution, CStyle,
1285                                       AllowObjCWritebackConversion);
1286 }
1287 
1288 /// PerformImplicitConversion - Perform an implicit conversion of the
1289 /// expression From to the type ToType. Returns the
1290 /// converted expression. Flavor is the kind of conversion we're
1291 /// performing, used in the error message. If @p AllowExplicit,
1292 /// explicit user-defined conversions are permitted.
1293 ExprResult
1294 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1295                                 AssignmentAction Action, bool AllowExplicit) {
1296   ImplicitConversionSequence ICS;
1297   return PerformImplicitConversion(From, ToType, Action, AllowExplicit, ICS);
1298 }
1299 
1300 ExprResult
1301 Sema::PerformImplicitConversion(Expr *From, QualType ToType,
1302                                 AssignmentAction Action, bool AllowExplicit,
1303                                 ImplicitConversionSequence& ICS) {
1304   if (checkPlaceholderForOverload(*this, From))
1305     return ExprError();
1306 
1307   // Objective-C ARC: Determine whether we will allow the writeback conversion.
1308   bool AllowObjCWritebackConversion
1309     = getLangOpts().ObjCAutoRefCount &&
1310       (Action == AA_Passing || Action == AA_Sending);
1311 
1312   ICS = clang::TryImplicitConversion(*this, From, ToType,
1313                                      /*SuppressUserConversions=*/false,
1314                                      AllowExplicit,
1315                                      /*InOverloadResolution=*/false,
1316                                      /*CStyle=*/false,
1317                                      AllowObjCWritebackConversion);
1318   return PerformImplicitConversion(From, ToType, ICS, Action);
1319 }
1320 
1321 /// \brief Determine whether the conversion from FromType to ToType is a valid
1322 /// conversion that strips "noreturn" off the nested function type.
1323 bool Sema::IsNoReturnConversion(QualType FromType, QualType ToType,
1324                                 QualType &ResultTy) {
1325   if (Context.hasSameUnqualifiedType(FromType, ToType))
1326     return false;
1327 
1328   // Permit the conversion F(t __attribute__((noreturn))) -> F(t)
1329   // where F adds one of the following at most once:
1330   //   - a pointer
1331   //   - a member pointer
1332   //   - a block pointer
1333   CanQualType CanTo = Context.getCanonicalType(ToType);
1334   CanQualType CanFrom = Context.getCanonicalType(FromType);
1335   Type::TypeClass TyClass = CanTo->getTypeClass();
1336   if (TyClass != CanFrom->getTypeClass()) return false;
1337   if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto) {
1338     if (TyClass == Type::Pointer) {
1339       CanTo = CanTo.getAs<PointerType>()->getPointeeType();
1340       CanFrom = CanFrom.getAs<PointerType>()->getPointeeType();
1341     } else if (TyClass == Type::BlockPointer) {
1342       CanTo = CanTo.getAs<BlockPointerType>()->getPointeeType();
1343       CanFrom = CanFrom.getAs<BlockPointerType>()->getPointeeType();
1344     } else if (TyClass == Type::MemberPointer) {
1345       CanTo = CanTo.getAs<MemberPointerType>()->getPointeeType();
1346       CanFrom = CanFrom.getAs<MemberPointerType>()->getPointeeType();
1347     } else {
1348       return false;
1349     }
1350 
1351     TyClass = CanTo->getTypeClass();
1352     if (TyClass != CanFrom->getTypeClass()) return false;
1353     if (TyClass != Type::FunctionProto && TyClass != Type::FunctionNoProto)
1354       return false;
1355   }
1356 
1357   const FunctionType *FromFn = cast<FunctionType>(CanFrom);
1358   FunctionType::ExtInfo EInfo = FromFn->getExtInfo();
1359   if (!EInfo.getNoReturn()) return false;
1360 
1361   FromFn = Context.adjustFunctionType(FromFn, EInfo.withNoReturn(false));
1362   assert(QualType(FromFn, 0).isCanonical());
1363   if (QualType(FromFn, 0) != CanTo) return false;
1364 
1365   ResultTy = ToType;
1366   return true;
1367 }
1368 
1369 /// \brief Determine whether the conversion from FromType to ToType is a valid
1370 /// vector conversion.
1371 ///
1372 /// \param ICK Will be set to the vector conversion kind, if this is a vector
1373 /// conversion.
1374 static bool IsVectorConversion(ASTContext &Context, QualType FromType,
1375                                QualType ToType, ImplicitConversionKind &ICK) {
1376   // We need at least one of these types to be a vector type to have a vector
1377   // conversion.
1378   if (!ToType->isVectorType() && !FromType->isVectorType())
1379     return false;
1380 
1381   // Identical types require no conversions.
1382   if (Context.hasSameUnqualifiedType(FromType, ToType))
1383     return false;
1384 
1385   // There are no conversions between extended vector types, only identity.
1386   if (ToType->isExtVectorType()) {
1387     // There are no conversions between extended vector types other than the
1388     // identity conversion.
1389     if (FromType->isExtVectorType())
1390       return false;
1391 
1392     // Vector splat from any arithmetic type to a vector.
1393     if (FromType->isArithmeticType()) {
1394       ICK = ICK_Vector_Splat;
1395       return true;
1396     }
1397   }
1398 
1399   // We can perform the conversion between vector types in the following cases:
1400   // 1)vector types are equivalent AltiVec and GCC vector types
1401   // 2)lax vector conversions are permitted and the vector types are of the
1402   //   same size
1403   if (ToType->isVectorType() && FromType->isVectorType()) {
1404     if (Context.areCompatibleVectorTypes(FromType, ToType) ||
1405         (Context.getLangOpts().LaxVectorConversions &&
1406          (Context.getTypeSize(FromType) == Context.getTypeSize(ToType)))) {
1407       ICK = ICK_Vector_Conversion;
1408       return true;
1409     }
1410   }
1411 
1412   return false;
1413 }
1414 
1415 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
1416                                 bool InOverloadResolution,
1417                                 StandardConversionSequence &SCS,
1418                                 bool CStyle);
1419 
1420 /// IsStandardConversion - Determines whether there is a standard
1421 /// conversion sequence (C++ [conv], C++ [over.ics.scs]) from the
1422 /// expression From to the type ToType. Standard conversion sequences
1423 /// only consider non-class types; for conversions that involve class
1424 /// types, use TryImplicitConversion. If a conversion exists, SCS will
1425 /// contain the standard conversion sequence required to perform this
1426 /// conversion and this routine will return true. Otherwise, this
1427 /// routine will return false and the value of SCS is unspecified.
1428 static bool IsStandardConversion(Sema &S, Expr* From, QualType ToType,
1429                                  bool InOverloadResolution,
1430                                  StandardConversionSequence &SCS,
1431                                  bool CStyle,
1432                                  bool AllowObjCWritebackConversion) {
1433   QualType FromType = From->getType();
1434 
1435   // Standard conversions (C++ [conv])
1436   SCS.setAsIdentityConversion();
1437   SCS.DeprecatedStringLiteralToCharPtr = false;
1438   SCS.IncompatibleObjC = false;
1439   SCS.setFromType(FromType);
1440   SCS.CopyConstructor = 0;
1441 
1442   // There are no standard conversions for class types in C++, so
1443   // abort early. When overloading in C, however, we do permit
1444   if (FromType->isRecordType() || ToType->isRecordType()) {
1445     if (S.getLangOpts().CPlusPlus)
1446       return false;
1447 
1448     // When we're overloading in C, we allow, as standard conversions,
1449   }
1450 
1451   // The first conversion can be an lvalue-to-rvalue conversion,
1452   // array-to-pointer conversion, or function-to-pointer conversion
1453   // (C++ 4p1).
1454 
1455   if (FromType == S.Context.OverloadTy) {
1456     DeclAccessPair AccessPair;
1457     if (FunctionDecl *Fn
1458           = S.ResolveAddressOfOverloadedFunction(From, ToType, false,
1459                                                  AccessPair)) {
1460       // We were able to resolve the address of the overloaded function,
1461       // so we can convert to the type of that function.
1462       FromType = Fn->getType();
1463 
1464       // we can sometimes resolve &foo<int> regardless of ToType, so check
1465       // if the type matches (identity) or we are converting to bool
1466       if (!S.Context.hasSameUnqualifiedType(
1467                       S.ExtractUnqualifiedFunctionType(ToType), FromType)) {
1468         QualType resultTy;
1469         // if the function type matches except for [[noreturn]], it's ok
1470         if (!S.IsNoReturnConversion(FromType,
1471               S.ExtractUnqualifiedFunctionType(ToType), resultTy))
1472           // otherwise, only a boolean conversion is standard
1473           if (!ToType->isBooleanType())
1474             return false;
1475       }
1476 
1477       // Check if the "from" expression is taking the address of an overloaded
1478       // function and recompute the FromType accordingly. Take advantage of the
1479       // fact that non-static member functions *must* have such an address-of
1480       // expression.
1481       CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn);
1482       if (Method && !Method->isStatic()) {
1483         assert(isa<UnaryOperator>(From->IgnoreParens()) &&
1484                "Non-unary operator on non-static member address");
1485         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode()
1486                == UO_AddrOf &&
1487                "Non-address-of operator on non-static member address");
1488         const Type *ClassType
1489           = S.Context.getTypeDeclType(Method->getParent()).getTypePtr();
1490         FromType = S.Context.getMemberPointerType(FromType, ClassType);
1491       } else if (isa<UnaryOperator>(From->IgnoreParens())) {
1492         assert(cast<UnaryOperator>(From->IgnoreParens())->getOpcode() ==
1493                UO_AddrOf &&
1494                "Non-address-of operator for overloaded function expression");
1495         FromType = S.Context.getPointerType(FromType);
1496       }
1497 
1498       // Check that we've computed the proper type after overload resolution.
1499       assert(S.Context.hasSameType(
1500         FromType,
1501         S.FixOverloadedFunctionReference(From, AccessPair, Fn)->getType()));
1502     } else {
1503       return false;
1504     }
1505   }
1506   // Lvalue-to-rvalue conversion (C++11 4.1):
1507   //   A glvalue (3.10) of a non-function, non-array type T can
1508   //   be converted to a prvalue.
1509   bool argIsLValue = From->isGLValue();
1510   if (argIsLValue &&
1511       !FromType->isFunctionType() && !FromType->isArrayType() &&
1512       S.Context.getCanonicalType(FromType) != S.Context.OverloadTy) {
1513     SCS.First = ICK_Lvalue_To_Rvalue;
1514 
1515     // C11 6.3.2.1p2:
1516     //   ... if the lvalue has atomic type, the value has the non-atomic version
1517     //   of the type of the lvalue ...
1518     if (const AtomicType *Atomic = FromType->getAs<AtomicType>())
1519       FromType = Atomic->getValueType();
1520 
1521     // If T is a non-class type, the type of the rvalue is the
1522     // cv-unqualified version of T. Otherwise, the type of the rvalue
1523     // is T (C++ 4.1p1). C++ can't get here with class types; in C, we
1524     // just strip the qualifiers because they don't matter.
1525     FromType = FromType.getUnqualifiedType();
1526   } else if (FromType->isArrayType()) {
1527     // Array-to-pointer conversion (C++ 4.2)
1528     SCS.First = ICK_Array_To_Pointer;
1529 
1530     // An lvalue or rvalue of type "array of N T" or "array of unknown
1531     // bound of T" can be converted to an rvalue of type "pointer to
1532     // T" (C++ 4.2p1).
1533     FromType = S.Context.getArrayDecayedType(FromType);
1534 
1535     if (S.IsStringLiteralToNonConstPointerConversion(From, ToType)) {
1536       // This conversion is deprecated. (C++ D.4).
1537       SCS.DeprecatedStringLiteralToCharPtr = true;
1538 
1539       // For the purpose of ranking in overload resolution
1540       // (13.3.3.1.1), this conversion is considered an
1541       // array-to-pointer conversion followed by a qualification
1542       // conversion (4.4). (C++ 4.2p2)
1543       SCS.Second = ICK_Identity;
1544       SCS.Third = ICK_Qualification;
1545       SCS.QualificationIncludesObjCLifetime = false;
1546       SCS.setAllToTypes(FromType);
1547       return true;
1548     }
1549   } else if (FromType->isFunctionType() && argIsLValue) {
1550     // Function-to-pointer conversion (C++ 4.3).
1551     SCS.First = ICK_Function_To_Pointer;
1552 
1553     // An lvalue of function type T can be converted to an rvalue of
1554     // type "pointer to T." The result is a pointer to the
1555     // function. (C++ 4.3p1).
1556     FromType = S.Context.getPointerType(FromType);
1557   } else {
1558     // We don't require any conversions for the first step.
1559     SCS.First = ICK_Identity;
1560   }
1561   SCS.setToType(0, FromType);
1562 
1563   // The second conversion can be an integral promotion, floating
1564   // point promotion, integral conversion, floating point conversion,
1565   // floating-integral conversion, pointer conversion,
1566   // pointer-to-member conversion, or boolean conversion (C++ 4p1).
1567   // For overloading in C, this can also be a "compatible-type"
1568   // conversion.
1569   bool IncompatibleObjC = false;
1570   ImplicitConversionKind SecondICK = ICK_Identity;
1571   if (S.Context.hasSameUnqualifiedType(FromType, ToType)) {
1572     // The unqualified versions of the types are the same: there's no
1573     // conversion to do.
1574     SCS.Second = ICK_Identity;
1575   } else if (S.IsIntegralPromotion(From, FromType, ToType)) {
1576     // Integral promotion (C++ 4.5).
1577     SCS.Second = ICK_Integral_Promotion;
1578     FromType = ToType.getUnqualifiedType();
1579   } else if (S.IsFloatingPointPromotion(FromType, ToType)) {
1580     // Floating point promotion (C++ 4.6).
1581     SCS.Second = ICK_Floating_Promotion;
1582     FromType = ToType.getUnqualifiedType();
1583   } else if (S.IsComplexPromotion(FromType, ToType)) {
1584     // Complex promotion (Clang extension)
1585     SCS.Second = ICK_Complex_Promotion;
1586     FromType = ToType.getUnqualifiedType();
1587   } else if (ToType->isBooleanType() &&
1588              (FromType->isArithmeticType() ||
1589               FromType->isAnyPointerType() ||
1590               FromType->isBlockPointerType() ||
1591               FromType->isMemberPointerType() ||
1592               FromType->isNullPtrType())) {
1593     // Boolean conversions (C++ 4.12).
1594     SCS.Second = ICK_Boolean_Conversion;
1595     FromType = S.Context.BoolTy;
1596   } else if (FromType->isIntegralOrUnscopedEnumerationType() &&
1597              ToType->isIntegralType(S.Context)) {
1598     // Integral conversions (C++ 4.7).
1599     SCS.Second = ICK_Integral_Conversion;
1600     FromType = ToType.getUnqualifiedType();
1601   } else if (FromType->isAnyComplexType() && ToType->isAnyComplexType()) {
1602     // Complex conversions (C99 6.3.1.6)
1603     SCS.Second = ICK_Complex_Conversion;
1604     FromType = ToType.getUnqualifiedType();
1605   } else if ((FromType->isAnyComplexType() && ToType->isArithmeticType()) ||
1606              (ToType->isAnyComplexType() && FromType->isArithmeticType())) {
1607     // Complex-real conversions (C99 6.3.1.7)
1608     SCS.Second = ICK_Complex_Real;
1609     FromType = ToType.getUnqualifiedType();
1610   } else if (FromType->isRealFloatingType() && ToType->isRealFloatingType()) {
1611     // Floating point conversions (C++ 4.8).
1612     SCS.Second = ICK_Floating_Conversion;
1613     FromType = ToType.getUnqualifiedType();
1614   } else if ((FromType->isRealFloatingType() &&
1615               ToType->isIntegralType(S.Context)) ||
1616              (FromType->isIntegralOrUnscopedEnumerationType() &&
1617               ToType->isRealFloatingType())) {
1618     // Floating-integral conversions (C++ 4.9).
1619     SCS.Second = ICK_Floating_Integral;
1620     FromType = ToType.getUnqualifiedType();
1621   } else if (S.IsBlockPointerConversion(FromType, ToType, FromType)) {
1622     SCS.Second = ICK_Block_Pointer_Conversion;
1623   } else if (AllowObjCWritebackConversion &&
1624              S.isObjCWritebackConversion(FromType, ToType, FromType)) {
1625     SCS.Second = ICK_Writeback_Conversion;
1626   } else if (S.IsPointerConversion(From, FromType, ToType, InOverloadResolution,
1627                                    FromType, IncompatibleObjC)) {
1628     // Pointer conversions (C++ 4.10).
1629     SCS.Second = ICK_Pointer_Conversion;
1630     SCS.IncompatibleObjC = IncompatibleObjC;
1631     FromType = FromType.getUnqualifiedType();
1632   } else if (S.IsMemberPointerConversion(From, FromType, ToType,
1633                                          InOverloadResolution, FromType)) {
1634     // Pointer to member conversions (4.11).
1635     SCS.Second = ICK_Pointer_Member;
1636   } else if (IsVectorConversion(S.Context, FromType, ToType, SecondICK)) {
1637     SCS.Second = SecondICK;
1638     FromType = ToType.getUnqualifiedType();
1639   } else if (!S.getLangOpts().CPlusPlus &&
1640              S.Context.typesAreCompatible(ToType, FromType)) {
1641     // Compatible conversions (Clang extension for C function overloading)
1642     SCS.Second = ICK_Compatible_Conversion;
1643     FromType = ToType.getUnqualifiedType();
1644   } else if (S.IsNoReturnConversion(FromType, ToType, FromType)) {
1645     // Treat a conversion that strips "noreturn" as an identity conversion.
1646     SCS.Second = ICK_NoReturn_Adjustment;
1647   } else if (IsTransparentUnionStandardConversion(S, From, ToType,
1648                                              InOverloadResolution,
1649                                              SCS, CStyle)) {
1650     SCS.Second = ICK_TransparentUnionConversion;
1651     FromType = ToType;
1652   } else if (tryAtomicConversion(S, From, ToType, InOverloadResolution, SCS,
1653                                  CStyle)) {
1654     // tryAtomicConversion has updated the standard conversion sequence
1655     // appropriately.
1656     return true;
1657   } else if (ToType->isEventT() &&
1658              From->isIntegerConstantExpr(S.getASTContext()) &&
1659              (From->EvaluateKnownConstInt(S.getASTContext()) == 0)) {
1660     SCS.Second = ICK_Zero_Event_Conversion;
1661     FromType = ToType;
1662   } else {
1663     // No second conversion required.
1664     SCS.Second = ICK_Identity;
1665   }
1666   SCS.setToType(1, FromType);
1667 
1668   QualType CanonFrom;
1669   QualType CanonTo;
1670   // The third conversion can be a qualification conversion (C++ 4p1).
1671   bool ObjCLifetimeConversion;
1672   if (S.IsQualificationConversion(FromType, ToType, CStyle,
1673                                   ObjCLifetimeConversion)) {
1674     SCS.Third = ICK_Qualification;
1675     SCS.QualificationIncludesObjCLifetime = ObjCLifetimeConversion;
1676     FromType = ToType;
1677     CanonFrom = S.Context.getCanonicalType(FromType);
1678     CanonTo = S.Context.getCanonicalType(ToType);
1679   } else {
1680     // No conversion required
1681     SCS.Third = ICK_Identity;
1682 
1683     // C++ [over.best.ics]p6:
1684     //   [...] Any difference in top-level cv-qualification is
1685     //   subsumed by the initialization itself and does not constitute
1686     //   a conversion. [...]
1687     CanonFrom = S.Context.getCanonicalType(FromType);
1688     CanonTo = S.Context.getCanonicalType(ToType);
1689     if (CanonFrom.getLocalUnqualifiedType()
1690                                        == CanonTo.getLocalUnqualifiedType() &&
1691         CanonFrom.getLocalQualifiers() != CanonTo.getLocalQualifiers()) {
1692       FromType = ToType;
1693       CanonFrom = CanonTo;
1694     }
1695   }
1696   SCS.setToType(2, FromType);
1697 
1698   // If we have not converted the argument type to the parameter type,
1699   // this is a bad conversion sequence.
1700   if (CanonFrom != CanonTo)
1701     return false;
1702 
1703   return true;
1704 }
1705 
1706 static bool
1707 IsTransparentUnionStandardConversion(Sema &S, Expr* From,
1708                                      QualType &ToType,
1709                                      bool InOverloadResolution,
1710                                      StandardConversionSequence &SCS,
1711                                      bool CStyle) {
1712 
1713   const RecordType *UT = ToType->getAsUnionType();
1714   if (!UT || !UT->getDecl()->hasAttr<TransparentUnionAttr>())
1715     return false;
1716   // The field to initialize within the transparent union.
1717   RecordDecl *UD = UT->getDecl();
1718   // It's compatible if the expression matches any of the fields.
1719   for (RecordDecl::field_iterator it = UD->field_begin(),
1720        itend = UD->field_end();
1721        it != itend; ++it) {
1722     if (IsStandardConversion(S, From, it->getType(), InOverloadResolution, SCS,
1723                              CStyle, /*ObjCWritebackConversion=*/false)) {
1724       ToType = it->getType();
1725       return true;
1726     }
1727   }
1728   return false;
1729 }
1730 
1731 /// IsIntegralPromotion - Determines whether the conversion from the
1732 /// expression From (whose potentially-adjusted type is FromType) to
1733 /// ToType is an integral promotion (C++ 4.5). If so, returns true and
1734 /// sets PromotedType to the promoted type.
1735 bool Sema::IsIntegralPromotion(Expr *From, QualType FromType, QualType ToType) {
1736   const BuiltinType *To = ToType->getAs<BuiltinType>();
1737   // All integers are built-in.
1738   if (!To) {
1739     return false;
1740   }
1741 
1742   // An rvalue of type char, signed char, unsigned char, short int, or
1743   // unsigned short int can be converted to an rvalue of type int if
1744   // int can represent all the values of the source type; otherwise,
1745   // the source rvalue can be converted to an rvalue of type unsigned
1746   // int (C++ 4.5p1).
1747   if (FromType->isPromotableIntegerType() && !FromType->isBooleanType() &&
1748       !FromType->isEnumeralType()) {
1749     if (// We can promote any signed, promotable integer type to an int
1750         (FromType->isSignedIntegerType() ||
1751          // We can promote any unsigned integer type whose size is
1752          // less than int to an int.
1753          (!FromType->isSignedIntegerType() &&
1754           Context.getTypeSize(FromType) < Context.getTypeSize(ToType)))) {
1755       return To->getKind() == BuiltinType::Int;
1756     }
1757 
1758     return To->getKind() == BuiltinType::UInt;
1759   }
1760 
1761   // C++11 [conv.prom]p3:
1762   //   A prvalue of an unscoped enumeration type whose underlying type is not
1763   //   fixed (7.2) can be converted to an rvalue a prvalue of the first of the
1764   //   following types that can represent all the values of the enumeration
1765   //   (i.e., the values in the range bmin to bmax as described in 7.2): int,
1766   //   unsigned int, long int, unsigned long int, long long int, or unsigned
1767   //   long long int. If none of the types in that list can represent all the
1768   //   values of the enumeration, an rvalue a prvalue of an unscoped enumeration
1769   //   type can be converted to an rvalue a prvalue of the extended integer type
1770   //   with lowest integer conversion rank (4.13) greater than the rank of long
1771   //   long in which all the values of the enumeration can be represented. If
1772   //   there are two such extended types, the signed one is chosen.
1773   // C++11 [conv.prom]p4:
1774   //   A prvalue of an unscoped enumeration type whose underlying type is fixed
1775   //   can be converted to a prvalue of its underlying type. Moreover, if
1776   //   integral promotion can be applied to its underlying type, a prvalue of an
1777   //   unscoped enumeration type whose underlying type is fixed can also be
1778   //   converted to a prvalue of the promoted underlying type.
1779   if (const EnumType *FromEnumType = FromType->getAs<EnumType>()) {
1780     // C++0x 7.2p9: Note that this implicit enum to int conversion is not
1781     // provided for a scoped enumeration.
1782     if (FromEnumType->getDecl()->isScoped())
1783       return false;
1784 
1785     // We can perform an integral promotion to the underlying type of the enum,
1786     // even if that's not the promoted type.
1787     if (FromEnumType->getDecl()->isFixed()) {
1788       QualType Underlying = FromEnumType->getDecl()->getIntegerType();
1789       return Context.hasSameUnqualifiedType(Underlying, ToType) ||
1790              IsIntegralPromotion(From, Underlying, ToType);
1791     }
1792 
1793     // We have already pre-calculated the promotion type, so this is trivial.
1794     if (ToType->isIntegerType() &&
1795         !RequireCompleteType(From->getLocStart(), FromType, 0))
1796       return Context.hasSameUnqualifiedType(ToType,
1797                                 FromEnumType->getDecl()->getPromotionType());
1798   }
1799 
1800   // C++0x [conv.prom]p2:
1801   //   A prvalue of type char16_t, char32_t, or wchar_t (3.9.1) can be converted
1802   //   to an rvalue a prvalue of the first of the following types that can
1803   //   represent all the values of its underlying type: int, unsigned int,
1804   //   long int, unsigned long int, long long int, or unsigned long long int.
1805   //   If none of the types in that list can represent all the values of its
1806   //   underlying type, an rvalue a prvalue of type char16_t, char32_t,
1807   //   or wchar_t can be converted to an rvalue a prvalue of its underlying
1808   //   type.
1809   if (FromType->isAnyCharacterType() && !FromType->isCharType() &&
1810       ToType->isIntegerType()) {
1811     // Determine whether the type we're converting from is signed or
1812     // unsigned.
1813     bool FromIsSigned = FromType->isSignedIntegerType();
1814     uint64_t FromSize = Context.getTypeSize(FromType);
1815 
1816     // The types we'll try to promote to, in the appropriate
1817     // order. Try each of these types.
1818     QualType PromoteTypes[6] = {
1819       Context.IntTy, Context.UnsignedIntTy,
1820       Context.LongTy, Context.UnsignedLongTy ,
1821       Context.LongLongTy, Context.UnsignedLongLongTy
1822     };
1823     for (int Idx = 0; Idx < 6; ++Idx) {
1824       uint64_t ToSize = Context.getTypeSize(PromoteTypes[Idx]);
1825       if (FromSize < ToSize ||
1826           (FromSize == ToSize &&
1827            FromIsSigned == PromoteTypes[Idx]->isSignedIntegerType())) {
1828         // We found the type that we can promote to. If this is the
1829         // type we wanted, we have a promotion. Otherwise, no
1830         // promotion.
1831         return Context.hasSameUnqualifiedType(ToType, PromoteTypes[Idx]);
1832       }
1833     }
1834   }
1835 
1836   // An rvalue for an integral bit-field (9.6) can be converted to an
1837   // rvalue of type int if int can represent all the values of the
1838   // bit-field; otherwise, it can be converted to unsigned int if
1839   // unsigned int can represent all the values of the bit-field. If
1840   // the bit-field is larger yet, no integral promotion applies to
1841   // it. If the bit-field has an enumerated type, it is treated as any
1842   // other value of that type for promotion purposes (C++ 4.5p3).
1843   // FIXME: We should delay checking of bit-fields until we actually perform the
1844   // conversion.
1845   using llvm::APSInt;
1846   if (From)
1847     if (FieldDecl *MemberDecl = From->getSourceBitField()) {
1848       APSInt BitWidth;
1849       if (FromType->isIntegralType(Context) &&
1850           MemberDecl->getBitWidth()->isIntegerConstantExpr(BitWidth, Context)) {
1851         APSInt ToSize(BitWidth.getBitWidth(), BitWidth.isUnsigned());
1852         ToSize = Context.getTypeSize(ToType);
1853 
1854         // Are we promoting to an int from a bitfield that fits in an int?
1855         if (BitWidth < ToSize ||
1856             (FromType->isSignedIntegerType() && BitWidth <= ToSize)) {
1857           return To->getKind() == BuiltinType::Int;
1858         }
1859 
1860         // Are we promoting to an unsigned int from an unsigned bitfield
1861         // that fits into an unsigned int?
1862         if (FromType->isUnsignedIntegerType() && BitWidth <= ToSize) {
1863           return To->getKind() == BuiltinType::UInt;
1864         }
1865 
1866         return false;
1867       }
1868     }
1869 
1870   // An rvalue of type bool can be converted to an rvalue of type int,
1871   // with false becoming zero and true becoming one (C++ 4.5p4).
1872   if (FromType->isBooleanType() && To->getKind() == BuiltinType::Int) {
1873     return true;
1874   }
1875 
1876   return false;
1877 }
1878 
1879 /// IsFloatingPointPromotion - Determines whether the conversion from
1880 /// FromType to ToType is a floating point promotion (C++ 4.6). If so,
1881 /// returns true and sets PromotedType to the promoted type.
1882 bool Sema::IsFloatingPointPromotion(QualType FromType, QualType ToType) {
1883   if (const BuiltinType *FromBuiltin = FromType->getAs<BuiltinType>())
1884     if (const BuiltinType *ToBuiltin = ToType->getAs<BuiltinType>()) {
1885       /// An rvalue of type float can be converted to an rvalue of type
1886       /// double. (C++ 4.6p1).
1887       if (FromBuiltin->getKind() == BuiltinType::Float &&
1888           ToBuiltin->getKind() == BuiltinType::Double)
1889         return true;
1890 
1891       // C99 6.3.1.5p1:
1892       //   When a float is promoted to double or long double, or a
1893       //   double is promoted to long double [...].
1894       if (!getLangOpts().CPlusPlus &&
1895           (FromBuiltin->getKind() == BuiltinType::Float ||
1896            FromBuiltin->getKind() == BuiltinType::Double) &&
1897           (ToBuiltin->getKind() == BuiltinType::LongDouble))
1898         return true;
1899 
1900       // Half can be promoted to float.
1901       if (!getLangOpts().NativeHalfType &&
1902            FromBuiltin->getKind() == BuiltinType::Half &&
1903           ToBuiltin->getKind() == BuiltinType::Float)
1904         return true;
1905     }
1906 
1907   return false;
1908 }
1909 
1910 /// \brief Determine if a conversion is a complex promotion.
1911 ///
1912 /// A complex promotion is defined as a complex -> complex conversion
1913 /// where the conversion between the underlying real types is a
1914 /// floating-point or integral promotion.
1915 bool Sema::IsComplexPromotion(QualType FromType, QualType ToType) {
1916   const ComplexType *FromComplex = FromType->getAs<ComplexType>();
1917   if (!FromComplex)
1918     return false;
1919 
1920   const ComplexType *ToComplex = ToType->getAs<ComplexType>();
1921   if (!ToComplex)
1922     return false;
1923 
1924   return IsFloatingPointPromotion(FromComplex->getElementType(),
1925                                   ToComplex->getElementType()) ||
1926     IsIntegralPromotion(0, FromComplex->getElementType(),
1927                         ToComplex->getElementType());
1928 }
1929 
1930 /// BuildSimilarlyQualifiedPointerType - In a pointer conversion from
1931 /// the pointer type FromPtr to a pointer to type ToPointee, with the
1932 /// same type qualifiers as FromPtr has on its pointee type. ToType,
1933 /// if non-empty, will be a pointer to ToType that may or may not have
1934 /// the right set of qualifiers on its pointee.
1935 ///
1936 static QualType
1937 BuildSimilarlyQualifiedPointerType(const Type *FromPtr,
1938                                    QualType ToPointee, QualType ToType,
1939                                    ASTContext &Context,
1940                                    bool StripObjCLifetime = false) {
1941   assert((FromPtr->getTypeClass() == Type::Pointer ||
1942           FromPtr->getTypeClass() == Type::ObjCObjectPointer) &&
1943          "Invalid similarly-qualified pointer type");
1944 
1945   /// Conversions to 'id' subsume cv-qualifier conversions.
1946   if (ToType->isObjCIdType() || ToType->isObjCQualifiedIdType())
1947     return ToType.getUnqualifiedType();
1948 
1949   QualType CanonFromPointee
1950     = Context.getCanonicalType(FromPtr->getPointeeType());
1951   QualType CanonToPointee = Context.getCanonicalType(ToPointee);
1952   Qualifiers Quals = CanonFromPointee.getQualifiers();
1953 
1954   if (StripObjCLifetime)
1955     Quals.removeObjCLifetime();
1956 
1957   // Exact qualifier match -> return the pointer type we're converting to.
1958   if (CanonToPointee.getLocalQualifiers() == Quals) {
1959     // ToType is exactly what we need. Return it.
1960     if (!ToType.isNull())
1961       return ToType.getUnqualifiedType();
1962 
1963     // Build a pointer to ToPointee. It has the right qualifiers
1964     // already.
1965     if (isa<ObjCObjectPointerType>(ToType))
1966       return Context.getObjCObjectPointerType(ToPointee);
1967     return Context.getPointerType(ToPointee);
1968   }
1969 
1970   // Just build a canonical type that has the right qualifiers.
1971   QualType QualifiedCanonToPointee
1972     = Context.getQualifiedType(CanonToPointee.getLocalUnqualifiedType(), Quals);
1973 
1974   if (isa<ObjCObjectPointerType>(ToType))
1975     return Context.getObjCObjectPointerType(QualifiedCanonToPointee);
1976   return Context.getPointerType(QualifiedCanonToPointee);
1977 }
1978 
1979 static bool isNullPointerConstantForConversion(Expr *Expr,
1980                                                bool InOverloadResolution,
1981                                                ASTContext &Context) {
1982   // Handle value-dependent integral null pointer constants correctly.
1983   // http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_active.html#903
1984   if (Expr->isValueDependent() && !Expr->isTypeDependent() &&
1985       Expr->getType()->isIntegerType() && !Expr->getType()->isEnumeralType())
1986     return !InOverloadResolution;
1987 
1988   return Expr->isNullPointerConstant(Context,
1989                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
1990                                         : Expr::NPC_ValueDependentIsNull);
1991 }
1992 
1993 /// IsPointerConversion - Determines whether the conversion of the
1994 /// expression From, which has the (possibly adjusted) type FromType,
1995 /// can be converted to the type ToType via a pointer conversion (C++
1996 /// 4.10). If so, returns true and places the converted type (that
1997 /// might differ from ToType in its cv-qualifiers at some level) into
1998 /// ConvertedType.
1999 ///
2000 /// This routine also supports conversions to and from block pointers
2001 /// and conversions with Objective-C's 'id', 'id<protocols...>', and
2002 /// pointers to interfaces. FIXME: Once we've determined the
2003 /// appropriate overloading rules for Objective-C, we may want to
2004 /// split the Objective-C checks into a different routine; however,
2005 /// GCC seems to consider all of these conversions to be pointer
2006 /// conversions, so for now they live here. IncompatibleObjC will be
2007 /// set if the conversion is an allowed Objective-C conversion that
2008 /// should result in a warning.
2009 bool Sema::IsPointerConversion(Expr *From, QualType FromType, QualType ToType,
2010                                bool InOverloadResolution,
2011                                QualType& ConvertedType,
2012                                bool &IncompatibleObjC) {
2013   IncompatibleObjC = false;
2014   if (isObjCPointerConversion(FromType, ToType, ConvertedType,
2015                               IncompatibleObjC))
2016     return true;
2017 
2018   // Conversion from a null pointer constant to any Objective-C pointer type.
2019   if (ToType->isObjCObjectPointerType() &&
2020       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2021     ConvertedType = ToType;
2022     return true;
2023   }
2024 
2025   // Blocks: Block pointers can be converted to void*.
2026   if (FromType->isBlockPointerType() && ToType->isPointerType() &&
2027       ToType->getAs<PointerType>()->getPointeeType()->isVoidType()) {
2028     ConvertedType = ToType;
2029     return true;
2030   }
2031   // Blocks: A null pointer constant can be converted to a block
2032   // pointer type.
2033   if (ToType->isBlockPointerType() &&
2034       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2035     ConvertedType = ToType;
2036     return true;
2037   }
2038 
2039   // If the left-hand-side is nullptr_t, the right side can be a null
2040   // pointer constant.
2041   if (ToType->isNullPtrType() &&
2042       isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2043     ConvertedType = ToType;
2044     return true;
2045   }
2046 
2047   const PointerType* ToTypePtr = ToType->getAs<PointerType>();
2048   if (!ToTypePtr)
2049     return false;
2050 
2051   // A null pointer constant can be converted to a pointer type (C++ 4.10p1).
2052   if (isNullPointerConstantForConversion(From, InOverloadResolution, Context)) {
2053     ConvertedType = ToType;
2054     return true;
2055   }
2056 
2057   // Beyond this point, both types need to be pointers
2058   // , including objective-c pointers.
2059   QualType ToPointeeType = ToTypePtr->getPointeeType();
2060   if (FromType->isObjCObjectPointerType() && ToPointeeType->isVoidType() &&
2061       !getLangOpts().ObjCAutoRefCount) {
2062     ConvertedType = BuildSimilarlyQualifiedPointerType(
2063                                       FromType->getAs<ObjCObjectPointerType>(),
2064                                                        ToPointeeType,
2065                                                        ToType, Context);
2066     return true;
2067   }
2068   const PointerType *FromTypePtr = FromType->getAs<PointerType>();
2069   if (!FromTypePtr)
2070     return false;
2071 
2072   QualType FromPointeeType = FromTypePtr->getPointeeType();
2073 
2074   // If the unqualified pointee types are the same, this can't be a
2075   // pointer conversion, so don't do all of the work below.
2076   if (Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType))
2077     return false;
2078 
2079   // An rvalue of type "pointer to cv T," where T is an object type,
2080   // can be converted to an rvalue of type "pointer to cv void" (C++
2081   // 4.10p2).
2082   if (FromPointeeType->isIncompleteOrObjectType() &&
2083       ToPointeeType->isVoidType()) {
2084     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2085                                                        ToPointeeType,
2086                                                        ToType, Context,
2087                                                    /*StripObjCLifetime=*/true);
2088     return true;
2089   }
2090 
2091   // MSVC allows implicit function to void* type conversion.
2092   if (getLangOpts().MicrosoftExt && FromPointeeType->isFunctionType() &&
2093       ToPointeeType->isVoidType()) {
2094     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2095                                                        ToPointeeType,
2096                                                        ToType, Context);
2097     return true;
2098   }
2099 
2100   // When we're overloading in C, we allow a special kind of pointer
2101   // conversion for compatible-but-not-identical pointee types.
2102   if (!getLangOpts().CPlusPlus &&
2103       Context.typesAreCompatible(FromPointeeType, ToPointeeType)) {
2104     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2105                                                        ToPointeeType,
2106                                                        ToType, Context);
2107     return true;
2108   }
2109 
2110   // C++ [conv.ptr]p3:
2111   //
2112   //   An rvalue of type "pointer to cv D," where D is a class type,
2113   //   can be converted to an rvalue of type "pointer to cv B," where
2114   //   B is a base class (clause 10) of D. If B is an inaccessible
2115   //   (clause 11) or ambiguous (10.2) base class of D, a program that
2116   //   necessitates this conversion is ill-formed. The result of the
2117   //   conversion is a pointer to the base class sub-object of the
2118   //   derived class object. The null pointer value is converted to
2119   //   the null pointer value of the destination type.
2120   //
2121   // Note that we do not check for ambiguity or inaccessibility
2122   // here. That is handled by CheckPointerConversion.
2123   if (getLangOpts().CPlusPlus &&
2124       FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2125       !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType) &&
2126       !RequireCompleteType(From->getLocStart(), FromPointeeType, 0) &&
2127       IsDerivedFrom(FromPointeeType, ToPointeeType)) {
2128     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2129                                                        ToPointeeType,
2130                                                        ToType, Context);
2131     return true;
2132   }
2133 
2134   if (FromPointeeType->isVectorType() && ToPointeeType->isVectorType() &&
2135       Context.areCompatibleVectorTypes(FromPointeeType, ToPointeeType)) {
2136     ConvertedType = BuildSimilarlyQualifiedPointerType(FromTypePtr,
2137                                                        ToPointeeType,
2138                                                        ToType, Context);
2139     return true;
2140   }
2141 
2142   return false;
2143 }
2144 
2145 /// \brief Adopt the given qualifiers for the given type.
2146 static QualType AdoptQualifiers(ASTContext &Context, QualType T, Qualifiers Qs){
2147   Qualifiers TQs = T.getQualifiers();
2148 
2149   // Check whether qualifiers already match.
2150   if (TQs == Qs)
2151     return T;
2152 
2153   if (Qs.compatiblyIncludes(TQs))
2154     return Context.getQualifiedType(T, Qs);
2155 
2156   return Context.getQualifiedType(T.getUnqualifiedType(), Qs);
2157 }
2158 
2159 /// isObjCPointerConversion - Determines whether this is an
2160 /// Objective-C pointer conversion. Subroutine of IsPointerConversion,
2161 /// with the same arguments and return values.
2162 bool Sema::isObjCPointerConversion(QualType FromType, QualType ToType,
2163                                    QualType& ConvertedType,
2164                                    bool &IncompatibleObjC) {
2165   if (!getLangOpts().ObjC1)
2166     return false;
2167 
2168   // The set of qualifiers on the type we're converting from.
2169   Qualifiers FromQualifiers = FromType.getQualifiers();
2170 
2171   // First, we handle all conversions on ObjC object pointer types.
2172   const ObjCObjectPointerType* ToObjCPtr =
2173     ToType->getAs<ObjCObjectPointerType>();
2174   const ObjCObjectPointerType *FromObjCPtr =
2175     FromType->getAs<ObjCObjectPointerType>();
2176 
2177   if (ToObjCPtr && FromObjCPtr) {
2178     // If the pointee types are the same (ignoring qualifications),
2179     // then this is not a pointer conversion.
2180     if (Context.hasSameUnqualifiedType(ToObjCPtr->getPointeeType(),
2181                                        FromObjCPtr->getPointeeType()))
2182       return false;
2183 
2184     // Check for compatible
2185     // Objective C++: We're able to convert between "id" or "Class" and a
2186     // pointer to any interface (in both directions).
2187     if (ToObjCPtr->isObjCBuiltinType() && FromObjCPtr->isObjCBuiltinType()) {
2188       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2189       return true;
2190     }
2191     // Conversions with Objective-C's id<...>.
2192     if ((FromObjCPtr->isObjCQualifiedIdType() ||
2193          ToObjCPtr->isObjCQualifiedIdType()) &&
2194         Context.ObjCQualifiedIdTypesAreCompatible(ToType, FromType,
2195                                                   /*compare=*/false)) {
2196       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2197       return true;
2198     }
2199     // Objective C++: We're able to convert from a pointer to an
2200     // interface to a pointer to a different interface.
2201     if (Context.canAssignObjCInterfaces(ToObjCPtr, FromObjCPtr)) {
2202       const ObjCInterfaceType* LHS = ToObjCPtr->getInterfaceType();
2203       const ObjCInterfaceType* RHS = FromObjCPtr->getInterfaceType();
2204       if (getLangOpts().CPlusPlus && LHS && RHS &&
2205           !ToObjCPtr->getPointeeType().isAtLeastAsQualifiedAs(
2206                                                 FromObjCPtr->getPointeeType()))
2207         return false;
2208       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2209                                                    ToObjCPtr->getPointeeType(),
2210                                                          ToType, Context);
2211       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2212       return true;
2213     }
2214 
2215     if (Context.canAssignObjCInterfaces(FromObjCPtr, ToObjCPtr)) {
2216       // Okay: this is some kind of implicit downcast of Objective-C
2217       // interfaces, which is permitted. However, we're going to
2218       // complain about it.
2219       IncompatibleObjC = true;
2220       ConvertedType = BuildSimilarlyQualifiedPointerType(FromObjCPtr,
2221                                                    ToObjCPtr->getPointeeType(),
2222                                                          ToType, Context);
2223       ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2224       return true;
2225     }
2226   }
2227   // Beyond this point, both types need to be C pointers or block pointers.
2228   QualType ToPointeeType;
2229   if (const PointerType *ToCPtr = ToType->getAs<PointerType>())
2230     ToPointeeType = ToCPtr->getPointeeType();
2231   else if (const BlockPointerType *ToBlockPtr =
2232             ToType->getAs<BlockPointerType>()) {
2233     // Objective C++: We're able to convert from a pointer to any object
2234     // to a block pointer type.
2235     if (FromObjCPtr && FromObjCPtr->isObjCBuiltinType()) {
2236       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2237       return true;
2238     }
2239     ToPointeeType = ToBlockPtr->getPointeeType();
2240   }
2241   else if (FromType->getAs<BlockPointerType>() &&
2242            ToObjCPtr && ToObjCPtr->isObjCBuiltinType()) {
2243     // Objective C++: We're able to convert from a block pointer type to a
2244     // pointer to any object.
2245     ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2246     return true;
2247   }
2248   else
2249     return false;
2250 
2251   QualType FromPointeeType;
2252   if (const PointerType *FromCPtr = FromType->getAs<PointerType>())
2253     FromPointeeType = FromCPtr->getPointeeType();
2254   else if (const BlockPointerType *FromBlockPtr =
2255            FromType->getAs<BlockPointerType>())
2256     FromPointeeType = FromBlockPtr->getPointeeType();
2257   else
2258     return false;
2259 
2260   // If we have pointers to pointers, recursively check whether this
2261   // is an Objective-C conversion.
2262   if (FromPointeeType->isPointerType() && ToPointeeType->isPointerType() &&
2263       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2264                               IncompatibleObjC)) {
2265     // We always complain about this conversion.
2266     IncompatibleObjC = true;
2267     ConvertedType = Context.getPointerType(ConvertedType);
2268     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2269     return true;
2270   }
2271   // Allow conversion of pointee being objective-c pointer to another one;
2272   // as in I* to id.
2273   if (FromPointeeType->getAs<ObjCObjectPointerType>() &&
2274       ToPointeeType->getAs<ObjCObjectPointerType>() &&
2275       isObjCPointerConversion(FromPointeeType, ToPointeeType, ConvertedType,
2276                               IncompatibleObjC)) {
2277 
2278     ConvertedType = Context.getPointerType(ConvertedType);
2279     ConvertedType = AdoptQualifiers(Context, ConvertedType, FromQualifiers);
2280     return true;
2281   }
2282 
2283   // If we have pointers to functions or blocks, check whether the only
2284   // differences in the argument and result types are in Objective-C
2285   // pointer conversions. If so, we permit the conversion (but
2286   // complain about it).
2287   const FunctionProtoType *FromFunctionType
2288     = FromPointeeType->getAs<FunctionProtoType>();
2289   const FunctionProtoType *ToFunctionType
2290     = ToPointeeType->getAs<FunctionProtoType>();
2291   if (FromFunctionType && ToFunctionType) {
2292     // If the function types are exactly the same, this isn't an
2293     // Objective-C pointer conversion.
2294     if (Context.getCanonicalType(FromPointeeType)
2295           == Context.getCanonicalType(ToPointeeType))
2296       return false;
2297 
2298     // Perform the quick checks that will tell us whether these
2299     // function types are obviously different.
2300     if (FromFunctionType->getNumArgs() != ToFunctionType->getNumArgs() ||
2301         FromFunctionType->isVariadic() != ToFunctionType->isVariadic() ||
2302         FromFunctionType->getTypeQuals() != ToFunctionType->getTypeQuals())
2303       return false;
2304 
2305     bool HasObjCConversion = false;
2306     if (Context.getCanonicalType(FromFunctionType->getResultType())
2307           == Context.getCanonicalType(ToFunctionType->getResultType())) {
2308       // Okay, the types match exactly. Nothing to do.
2309     } else if (isObjCPointerConversion(FromFunctionType->getResultType(),
2310                                        ToFunctionType->getResultType(),
2311                                        ConvertedType, IncompatibleObjC)) {
2312       // Okay, we have an Objective-C pointer conversion.
2313       HasObjCConversion = true;
2314     } else {
2315       // Function types are too different. Abort.
2316       return false;
2317     }
2318 
2319     // Check argument types.
2320     for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumArgs();
2321          ArgIdx != NumArgs; ++ArgIdx) {
2322       QualType FromArgType = FromFunctionType->getArgType(ArgIdx);
2323       QualType ToArgType = ToFunctionType->getArgType(ArgIdx);
2324       if (Context.getCanonicalType(FromArgType)
2325             == Context.getCanonicalType(ToArgType)) {
2326         // Okay, the types match exactly. Nothing to do.
2327       } else if (isObjCPointerConversion(FromArgType, ToArgType,
2328                                          ConvertedType, IncompatibleObjC)) {
2329         // Okay, we have an Objective-C pointer conversion.
2330         HasObjCConversion = true;
2331       } else {
2332         // Argument types are too different. Abort.
2333         return false;
2334       }
2335     }
2336 
2337     if (HasObjCConversion) {
2338       // We had an Objective-C conversion. Allow this pointer
2339       // conversion, but complain about it.
2340       ConvertedType = AdoptQualifiers(Context, ToType, FromQualifiers);
2341       IncompatibleObjC = true;
2342       return true;
2343     }
2344   }
2345 
2346   return false;
2347 }
2348 
2349 /// \brief Determine whether this is an Objective-C writeback conversion,
2350 /// used for parameter passing when performing automatic reference counting.
2351 ///
2352 /// \param FromType The type we're converting form.
2353 ///
2354 /// \param ToType The type we're converting to.
2355 ///
2356 /// \param ConvertedType The type that will be produced after applying
2357 /// this conversion.
2358 bool Sema::isObjCWritebackConversion(QualType FromType, QualType ToType,
2359                                      QualType &ConvertedType) {
2360   if (!getLangOpts().ObjCAutoRefCount ||
2361       Context.hasSameUnqualifiedType(FromType, ToType))
2362     return false;
2363 
2364   // Parameter must be a pointer to __autoreleasing (with no other qualifiers).
2365   QualType ToPointee;
2366   if (const PointerType *ToPointer = ToType->getAs<PointerType>())
2367     ToPointee = ToPointer->getPointeeType();
2368   else
2369     return false;
2370 
2371   Qualifiers ToQuals = ToPointee.getQualifiers();
2372   if (!ToPointee->isObjCLifetimeType() ||
2373       ToQuals.getObjCLifetime() != Qualifiers::OCL_Autoreleasing ||
2374       !ToQuals.withoutObjCLifetime().empty())
2375     return false;
2376 
2377   // Argument must be a pointer to __strong to __weak.
2378   QualType FromPointee;
2379   if (const PointerType *FromPointer = FromType->getAs<PointerType>())
2380     FromPointee = FromPointer->getPointeeType();
2381   else
2382     return false;
2383 
2384   Qualifiers FromQuals = FromPointee.getQualifiers();
2385   if (!FromPointee->isObjCLifetimeType() ||
2386       (FromQuals.getObjCLifetime() != Qualifiers::OCL_Strong &&
2387        FromQuals.getObjCLifetime() != Qualifiers::OCL_Weak))
2388     return false;
2389 
2390   // Make sure that we have compatible qualifiers.
2391   FromQuals.setObjCLifetime(Qualifiers::OCL_Autoreleasing);
2392   if (!ToQuals.compatiblyIncludes(FromQuals))
2393     return false;
2394 
2395   // Remove qualifiers from the pointee type we're converting from; they
2396   // aren't used in the compatibility check belong, and we'll be adding back
2397   // qualifiers (with __autoreleasing) if the compatibility check succeeds.
2398   FromPointee = FromPointee.getUnqualifiedType();
2399 
2400   // The unqualified form of the pointee types must be compatible.
2401   ToPointee = ToPointee.getUnqualifiedType();
2402   bool IncompatibleObjC;
2403   if (Context.typesAreCompatible(FromPointee, ToPointee))
2404     FromPointee = ToPointee;
2405   else if (!isObjCPointerConversion(FromPointee, ToPointee, FromPointee,
2406                                     IncompatibleObjC))
2407     return false;
2408 
2409   /// \brief Construct the type we're converting to, which is a pointer to
2410   /// __autoreleasing pointee.
2411   FromPointee = Context.getQualifiedType(FromPointee, FromQuals);
2412   ConvertedType = Context.getPointerType(FromPointee);
2413   return true;
2414 }
2415 
2416 bool Sema::IsBlockPointerConversion(QualType FromType, QualType ToType,
2417                                     QualType& ConvertedType) {
2418   QualType ToPointeeType;
2419   if (const BlockPointerType *ToBlockPtr =
2420         ToType->getAs<BlockPointerType>())
2421     ToPointeeType = ToBlockPtr->getPointeeType();
2422   else
2423     return false;
2424 
2425   QualType FromPointeeType;
2426   if (const BlockPointerType *FromBlockPtr =
2427       FromType->getAs<BlockPointerType>())
2428     FromPointeeType = FromBlockPtr->getPointeeType();
2429   else
2430     return false;
2431   // We have pointer to blocks, check whether the only
2432   // differences in the argument and result types are in Objective-C
2433   // pointer conversions. If so, we permit the conversion.
2434 
2435   const FunctionProtoType *FromFunctionType
2436     = FromPointeeType->getAs<FunctionProtoType>();
2437   const FunctionProtoType *ToFunctionType
2438     = ToPointeeType->getAs<FunctionProtoType>();
2439 
2440   if (!FromFunctionType || !ToFunctionType)
2441     return false;
2442 
2443   if (Context.hasSameType(FromPointeeType, ToPointeeType))
2444     return true;
2445 
2446   // Perform the quick checks that will tell us whether these
2447   // function types are obviously different.
2448   if (FromFunctionType->getNumArgs() != ToFunctionType->getNumArgs() ||
2449       FromFunctionType->isVariadic() != ToFunctionType->isVariadic())
2450     return false;
2451 
2452   FunctionType::ExtInfo FromEInfo = FromFunctionType->getExtInfo();
2453   FunctionType::ExtInfo ToEInfo = ToFunctionType->getExtInfo();
2454   if (FromEInfo != ToEInfo)
2455     return false;
2456 
2457   bool IncompatibleObjC = false;
2458   if (Context.hasSameType(FromFunctionType->getResultType(),
2459                           ToFunctionType->getResultType())) {
2460     // Okay, the types match exactly. Nothing to do.
2461   } else {
2462     QualType RHS = FromFunctionType->getResultType();
2463     QualType LHS = ToFunctionType->getResultType();
2464     if ((!getLangOpts().CPlusPlus || !RHS->isRecordType()) &&
2465         !RHS.hasQualifiers() && LHS.hasQualifiers())
2466        LHS = LHS.getUnqualifiedType();
2467 
2468      if (Context.hasSameType(RHS,LHS)) {
2469        // OK exact match.
2470      } else if (isObjCPointerConversion(RHS, LHS,
2471                                         ConvertedType, IncompatibleObjC)) {
2472      if (IncompatibleObjC)
2473        return false;
2474      // Okay, we have an Objective-C pointer conversion.
2475      }
2476      else
2477        return false;
2478    }
2479 
2480    // Check argument types.
2481    for (unsigned ArgIdx = 0, NumArgs = FromFunctionType->getNumArgs();
2482         ArgIdx != NumArgs; ++ArgIdx) {
2483      IncompatibleObjC = false;
2484      QualType FromArgType = FromFunctionType->getArgType(ArgIdx);
2485      QualType ToArgType = ToFunctionType->getArgType(ArgIdx);
2486      if (Context.hasSameType(FromArgType, ToArgType)) {
2487        // Okay, the types match exactly. Nothing to do.
2488      } else if (isObjCPointerConversion(ToArgType, FromArgType,
2489                                         ConvertedType, IncompatibleObjC)) {
2490        if (IncompatibleObjC)
2491          return false;
2492        // Okay, we have an Objective-C pointer conversion.
2493      } else
2494        // Argument types are too different. Abort.
2495        return false;
2496    }
2497    if (LangOpts.ObjCAutoRefCount &&
2498        !Context.FunctionTypesMatchOnNSConsumedAttrs(FromFunctionType,
2499                                                     ToFunctionType))
2500      return false;
2501 
2502    ConvertedType = ToType;
2503    return true;
2504 }
2505 
2506 enum {
2507   ft_default,
2508   ft_different_class,
2509   ft_parameter_arity,
2510   ft_parameter_mismatch,
2511   ft_return_type,
2512   ft_qualifer_mismatch
2513 };
2514 
2515 /// HandleFunctionTypeMismatch - Gives diagnostic information for differeing
2516 /// function types.  Catches different number of parameter, mismatch in
2517 /// parameter types, and different return types.
2518 void Sema::HandleFunctionTypeMismatch(PartialDiagnostic &PDiag,
2519                                       QualType FromType, QualType ToType) {
2520   // If either type is not valid, include no extra info.
2521   if (FromType.isNull() || ToType.isNull()) {
2522     PDiag << ft_default;
2523     return;
2524   }
2525 
2526   // Get the function type from the pointers.
2527   if (FromType->isMemberPointerType() && ToType->isMemberPointerType()) {
2528     const MemberPointerType *FromMember = FromType->getAs<MemberPointerType>(),
2529                             *ToMember = ToType->getAs<MemberPointerType>();
2530     if (FromMember->getClass() != ToMember->getClass()) {
2531       PDiag << ft_different_class << QualType(ToMember->getClass(), 0)
2532             << QualType(FromMember->getClass(), 0);
2533       return;
2534     }
2535     FromType = FromMember->getPointeeType();
2536     ToType = ToMember->getPointeeType();
2537   }
2538 
2539   if (FromType->isPointerType())
2540     FromType = FromType->getPointeeType();
2541   if (ToType->isPointerType())
2542     ToType = ToType->getPointeeType();
2543 
2544   // Remove references.
2545   FromType = FromType.getNonReferenceType();
2546   ToType = ToType.getNonReferenceType();
2547 
2548   // Don't print extra info for non-specialized template functions.
2549   if (FromType->isInstantiationDependentType() &&
2550       !FromType->getAs<TemplateSpecializationType>()) {
2551     PDiag << ft_default;
2552     return;
2553   }
2554 
2555   // No extra info for same types.
2556   if (Context.hasSameType(FromType, ToType)) {
2557     PDiag << ft_default;
2558     return;
2559   }
2560 
2561   const FunctionProtoType *FromFunction = FromType->getAs<FunctionProtoType>(),
2562                           *ToFunction = ToType->getAs<FunctionProtoType>();
2563 
2564   // Both types need to be function types.
2565   if (!FromFunction || !ToFunction) {
2566     PDiag << ft_default;
2567     return;
2568   }
2569 
2570   if (FromFunction->getNumArgs() != ToFunction->getNumArgs()) {
2571     PDiag << ft_parameter_arity << ToFunction->getNumArgs()
2572           << FromFunction->getNumArgs();
2573     return;
2574   }
2575 
2576   // Handle different parameter types.
2577   unsigned ArgPos;
2578   if (!FunctionArgTypesAreEqual(FromFunction, ToFunction, &ArgPos)) {
2579     PDiag << ft_parameter_mismatch << ArgPos + 1
2580           << ToFunction->getArgType(ArgPos)
2581           << FromFunction->getArgType(ArgPos);
2582     return;
2583   }
2584 
2585   // Handle different return type.
2586   if (!Context.hasSameType(FromFunction->getResultType(),
2587                            ToFunction->getResultType())) {
2588     PDiag << ft_return_type << ToFunction->getResultType()
2589           << FromFunction->getResultType();
2590     return;
2591   }
2592 
2593   unsigned FromQuals = FromFunction->getTypeQuals(),
2594            ToQuals = ToFunction->getTypeQuals();
2595   if (FromQuals != ToQuals) {
2596     PDiag << ft_qualifer_mismatch << ToQuals << FromQuals;
2597     return;
2598   }
2599 
2600   // Unable to find a difference, so add no extra info.
2601   PDiag << ft_default;
2602 }
2603 
2604 /// FunctionArgTypesAreEqual - This routine checks two function proto types
2605 /// for equality of their argument types. Caller has already checked that
2606 /// they have same number of arguments.  If the parameters are different,
2607 /// ArgPos will have the parameter index of the first different parameter.
2608 bool Sema::FunctionArgTypesAreEqual(const FunctionProtoType *OldType,
2609                                     const FunctionProtoType *NewType,
2610                                     unsigned *ArgPos) {
2611   for (FunctionProtoType::arg_type_iterator O = OldType->arg_type_begin(),
2612        N = NewType->arg_type_begin(),
2613        E = OldType->arg_type_end(); O && (O != E); ++O, ++N) {
2614     if (!Context.hasSameType(*O, *N)) {
2615       if (ArgPos) *ArgPos = O - OldType->arg_type_begin();
2616       return false;
2617     }
2618   }
2619   return true;
2620 }
2621 
2622 /// CheckPointerConversion - Check the pointer conversion from the
2623 /// expression From to the type ToType. This routine checks for
2624 /// ambiguous or inaccessible derived-to-base pointer
2625 /// conversions for which IsPointerConversion has already returned
2626 /// true. It returns true and produces a diagnostic if there was an
2627 /// error, or returns false otherwise.
2628 bool Sema::CheckPointerConversion(Expr *From, QualType ToType,
2629                                   CastKind &Kind,
2630                                   CXXCastPath& BasePath,
2631                                   bool IgnoreBaseAccess) {
2632   QualType FromType = From->getType();
2633   bool IsCStyleOrFunctionalCast = IgnoreBaseAccess;
2634 
2635   Kind = CK_BitCast;
2636 
2637   if (!IsCStyleOrFunctionalCast && !FromType->isAnyPointerType() &&
2638       From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNotNull) ==
2639       Expr::NPCK_ZeroExpression) {
2640     if (Context.hasSameUnqualifiedType(From->getType(), Context.BoolTy))
2641       DiagRuntimeBehavior(From->getExprLoc(), From,
2642                           PDiag(diag::warn_impcast_bool_to_null_pointer)
2643                             << ToType << From->getSourceRange());
2644     else if (!isUnevaluatedContext())
2645       Diag(From->getExprLoc(), diag::warn_non_literal_null_pointer)
2646         << ToType << From->getSourceRange();
2647   }
2648   if (const PointerType *ToPtrType = ToType->getAs<PointerType>()) {
2649     if (const PointerType *FromPtrType = FromType->getAs<PointerType>()) {
2650       QualType FromPointeeType = FromPtrType->getPointeeType(),
2651                ToPointeeType   = ToPtrType->getPointeeType();
2652 
2653       if (FromPointeeType->isRecordType() && ToPointeeType->isRecordType() &&
2654           !Context.hasSameUnqualifiedType(FromPointeeType, ToPointeeType)) {
2655         // We must have a derived-to-base conversion. Check an
2656         // ambiguous or inaccessible conversion.
2657         if (CheckDerivedToBaseConversion(FromPointeeType, ToPointeeType,
2658                                          From->getExprLoc(),
2659                                          From->getSourceRange(), &BasePath,
2660                                          IgnoreBaseAccess))
2661           return true;
2662 
2663         // The conversion was successful.
2664         Kind = CK_DerivedToBase;
2665       }
2666     }
2667   } else if (const ObjCObjectPointerType *ToPtrType =
2668                ToType->getAs<ObjCObjectPointerType>()) {
2669     if (const ObjCObjectPointerType *FromPtrType =
2670           FromType->getAs<ObjCObjectPointerType>()) {
2671       // Objective-C++ conversions are always okay.
2672       // FIXME: We should have a different class of conversions for the
2673       // Objective-C++ implicit conversions.
2674       if (FromPtrType->isObjCBuiltinType() || ToPtrType->isObjCBuiltinType())
2675         return false;
2676     } else if (FromType->isBlockPointerType()) {
2677       Kind = CK_BlockPointerToObjCPointerCast;
2678     } else {
2679       Kind = CK_CPointerToObjCPointerCast;
2680     }
2681   } else if (ToType->isBlockPointerType()) {
2682     if (!FromType->isBlockPointerType())
2683       Kind = CK_AnyPointerToBlockPointerCast;
2684   }
2685 
2686   // We shouldn't fall into this case unless it's valid for other
2687   // reasons.
2688   if (From->isNullPointerConstant(Context, Expr::NPC_ValueDependentIsNull))
2689     Kind = CK_NullToPointer;
2690 
2691   return false;
2692 }
2693 
2694 /// IsMemberPointerConversion - Determines whether the conversion of the
2695 /// expression From, which has the (possibly adjusted) type FromType, can be
2696 /// converted to the type ToType via a member pointer conversion (C++ 4.11).
2697 /// If so, returns true and places the converted type (that might differ from
2698 /// ToType in its cv-qualifiers at some level) into ConvertedType.
2699 bool Sema::IsMemberPointerConversion(Expr *From, QualType FromType,
2700                                      QualType ToType,
2701                                      bool InOverloadResolution,
2702                                      QualType &ConvertedType) {
2703   const MemberPointerType *ToTypePtr = ToType->getAs<MemberPointerType>();
2704   if (!ToTypePtr)
2705     return false;
2706 
2707   // A null pointer constant can be converted to a member pointer (C++ 4.11p1)
2708   if (From->isNullPointerConstant(Context,
2709                     InOverloadResolution? Expr::NPC_ValueDependentIsNotNull
2710                                         : Expr::NPC_ValueDependentIsNull)) {
2711     ConvertedType = ToType;
2712     return true;
2713   }
2714 
2715   // Otherwise, both types have to be member pointers.
2716   const MemberPointerType *FromTypePtr = FromType->getAs<MemberPointerType>();
2717   if (!FromTypePtr)
2718     return false;
2719 
2720   // A pointer to member of B can be converted to a pointer to member of D,
2721   // where D is derived from B (C++ 4.11p2).
2722   QualType FromClass(FromTypePtr->getClass(), 0);
2723   QualType ToClass(ToTypePtr->getClass(), 0);
2724 
2725   if (!Context.hasSameUnqualifiedType(FromClass, ToClass) &&
2726       !RequireCompleteType(From->getLocStart(), ToClass, 0) &&
2727       IsDerivedFrom(ToClass, FromClass)) {
2728     ConvertedType = Context.getMemberPointerType(FromTypePtr->getPointeeType(),
2729                                                  ToClass.getTypePtr());
2730     return true;
2731   }
2732 
2733   return false;
2734 }
2735 
2736 /// CheckMemberPointerConversion - Check the member pointer conversion from the
2737 /// expression From to the type ToType. This routine checks for ambiguous or
2738 /// virtual or inaccessible base-to-derived member pointer conversions
2739 /// for which IsMemberPointerConversion has already returned true. It returns
2740 /// true and produces a diagnostic if there was an error, or returns false
2741 /// otherwise.
2742 bool Sema::CheckMemberPointerConversion(Expr *From, QualType ToType,
2743                                         CastKind &Kind,
2744                                         CXXCastPath &BasePath,
2745                                         bool IgnoreBaseAccess) {
2746   QualType FromType = From->getType();
2747   const MemberPointerType *FromPtrType = FromType->getAs<MemberPointerType>();
2748   if (!FromPtrType) {
2749     // This must be a null pointer to member pointer conversion
2750     assert(From->isNullPointerConstant(Context,
2751                                        Expr::NPC_ValueDependentIsNull) &&
2752            "Expr must be null pointer constant!");
2753     Kind = CK_NullToMemberPointer;
2754     return false;
2755   }
2756 
2757   const MemberPointerType *ToPtrType = ToType->getAs<MemberPointerType>();
2758   assert(ToPtrType && "No member pointer cast has a target type "
2759                       "that is not a member pointer.");
2760 
2761   QualType FromClass = QualType(FromPtrType->getClass(), 0);
2762   QualType ToClass   = QualType(ToPtrType->getClass(), 0);
2763 
2764   // FIXME: What about dependent types?
2765   assert(FromClass->isRecordType() && "Pointer into non-class.");
2766   assert(ToClass->isRecordType() && "Pointer into non-class.");
2767 
2768   CXXBasePaths Paths(/*FindAmbiguities=*/true, /*RecordPaths=*/true,
2769                      /*DetectVirtual=*/true);
2770   bool DerivationOkay = IsDerivedFrom(ToClass, FromClass, Paths);
2771   assert(DerivationOkay &&
2772          "Should not have been called if derivation isn't OK.");
2773   (void)DerivationOkay;
2774 
2775   if (Paths.isAmbiguous(Context.getCanonicalType(FromClass).
2776                                   getUnqualifiedType())) {
2777     std::string PathDisplayStr = getAmbiguousPathsDisplayString(Paths);
2778     Diag(From->getExprLoc(), diag::err_ambiguous_memptr_conv)
2779       << 0 << FromClass << ToClass << PathDisplayStr << From->getSourceRange();
2780     return true;
2781   }
2782 
2783   if (const RecordType *VBase = Paths.getDetectedVirtual()) {
2784     Diag(From->getExprLoc(), diag::err_memptr_conv_via_virtual)
2785       << FromClass << ToClass << QualType(VBase, 0)
2786       << From->getSourceRange();
2787     return true;
2788   }
2789 
2790   if (!IgnoreBaseAccess)
2791     CheckBaseClassAccess(From->getExprLoc(), FromClass, ToClass,
2792                          Paths.front(),
2793                          diag::err_downcast_from_inaccessible_base);
2794 
2795   // Must be a base to derived member conversion.
2796   BuildBasePathArray(Paths, BasePath);
2797   Kind = CK_BaseToDerivedMemberPointer;
2798   return false;
2799 }
2800 
2801 /// IsQualificationConversion - Determines whether the conversion from
2802 /// an rvalue of type FromType to ToType is a qualification conversion
2803 /// (C++ 4.4).
2804 ///
2805 /// \param ObjCLifetimeConversion Output parameter that will be set to indicate
2806 /// when the qualification conversion involves a change in the Objective-C
2807 /// object lifetime.
2808 bool
2809 Sema::IsQualificationConversion(QualType FromType, QualType ToType,
2810                                 bool CStyle, bool &ObjCLifetimeConversion) {
2811   FromType = Context.getCanonicalType(FromType);
2812   ToType = Context.getCanonicalType(ToType);
2813   ObjCLifetimeConversion = false;
2814 
2815   // If FromType and ToType are the same type, this is not a
2816   // qualification conversion.
2817   if (FromType.getUnqualifiedType() == ToType.getUnqualifiedType())
2818     return false;
2819 
2820   // (C++ 4.4p4):
2821   //   A conversion can add cv-qualifiers at levels other than the first
2822   //   in multi-level pointers, subject to the following rules: [...]
2823   bool PreviousToQualsIncludeConst = true;
2824   bool UnwrappedAnyPointer = false;
2825   while (Context.UnwrapSimilarPointerTypes(FromType, ToType)) {
2826     // Within each iteration of the loop, we check the qualifiers to
2827     // determine if this still looks like a qualification
2828     // conversion. Then, if all is well, we unwrap one more level of
2829     // pointers or pointers-to-members and do it all again
2830     // until there are no more pointers or pointers-to-members left to
2831     // unwrap.
2832     UnwrappedAnyPointer = true;
2833 
2834     Qualifiers FromQuals = FromType.getQualifiers();
2835     Qualifiers ToQuals = ToType.getQualifiers();
2836 
2837     // Objective-C ARC:
2838     //   Check Objective-C lifetime conversions.
2839     if (FromQuals.getObjCLifetime() != ToQuals.getObjCLifetime() &&
2840         UnwrappedAnyPointer) {
2841       if (ToQuals.compatiblyIncludesObjCLifetime(FromQuals)) {
2842         ObjCLifetimeConversion = true;
2843         FromQuals.removeObjCLifetime();
2844         ToQuals.removeObjCLifetime();
2845       } else {
2846         // Qualification conversions cannot cast between different
2847         // Objective-C lifetime qualifiers.
2848         return false;
2849       }
2850     }
2851 
2852     // Allow addition/removal of GC attributes but not changing GC attributes.
2853     if (FromQuals.getObjCGCAttr() != ToQuals.getObjCGCAttr() &&
2854         (!FromQuals.hasObjCGCAttr() || !ToQuals.hasObjCGCAttr())) {
2855       FromQuals.removeObjCGCAttr();
2856       ToQuals.removeObjCGCAttr();
2857     }
2858 
2859     //   -- for every j > 0, if const is in cv 1,j then const is in cv
2860     //      2,j, and similarly for volatile.
2861     if (!CStyle && !ToQuals.compatiblyIncludes(FromQuals))
2862       return false;
2863 
2864     //   -- if the cv 1,j and cv 2,j are different, then const is in
2865     //      every cv for 0 < k < j.
2866     if (!CStyle && FromQuals.getCVRQualifiers() != ToQuals.getCVRQualifiers()
2867         && !PreviousToQualsIncludeConst)
2868       return false;
2869 
2870     // Keep track of whether all prior cv-qualifiers in the "to" type
2871     // include const.
2872     PreviousToQualsIncludeConst
2873       = PreviousToQualsIncludeConst && ToQuals.hasConst();
2874   }
2875 
2876   // We are left with FromType and ToType being the pointee types
2877   // after unwrapping the original FromType and ToType the same number
2878   // of types. If we unwrapped any pointers, and if FromType and
2879   // ToType have the same unqualified type (since we checked
2880   // qualifiers above), then this is a qualification conversion.
2881   return UnwrappedAnyPointer && Context.hasSameUnqualifiedType(FromType,ToType);
2882 }
2883 
2884 /// \brief - Determine whether this is a conversion from a scalar type to an
2885 /// atomic type.
2886 ///
2887 /// If successful, updates \c SCS's second and third steps in the conversion
2888 /// sequence to finish the conversion.
2889 static bool tryAtomicConversion(Sema &S, Expr *From, QualType ToType,
2890                                 bool InOverloadResolution,
2891                                 StandardConversionSequence &SCS,
2892                                 bool CStyle) {
2893   const AtomicType *ToAtomic = ToType->getAs<AtomicType>();
2894   if (!ToAtomic)
2895     return false;
2896 
2897   StandardConversionSequence InnerSCS;
2898   if (!IsStandardConversion(S, From, ToAtomic->getValueType(),
2899                             InOverloadResolution, InnerSCS,
2900                             CStyle, /*AllowObjCWritebackConversion=*/false))
2901     return false;
2902 
2903   SCS.Second = InnerSCS.Second;
2904   SCS.setToType(1, InnerSCS.getToType(1));
2905   SCS.Third = InnerSCS.Third;
2906   SCS.QualificationIncludesObjCLifetime
2907     = InnerSCS.QualificationIncludesObjCLifetime;
2908   SCS.setToType(2, InnerSCS.getToType(2));
2909   return true;
2910 }
2911 
2912 static bool isFirstArgumentCompatibleWithType(ASTContext &Context,
2913                                               CXXConstructorDecl *Constructor,
2914                                               QualType Type) {
2915   const FunctionProtoType *CtorType =
2916       Constructor->getType()->getAs<FunctionProtoType>();
2917   if (CtorType->getNumArgs() > 0) {
2918     QualType FirstArg = CtorType->getArgType(0);
2919     if (Context.hasSameUnqualifiedType(Type, FirstArg.getNonReferenceType()))
2920       return true;
2921   }
2922   return false;
2923 }
2924 
2925 static OverloadingResult
2926 IsInitializerListConstructorConversion(Sema &S, Expr *From, QualType ToType,
2927                                        CXXRecordDecl *To,
2928                                        UserDefinedConversionSequence &User,
2929                                        OverloadCandidateSet &CandidateSet,
2930                                        bool AllowExplicit) {
2931   DeclContext::lookup_result R = S.LookupConstructors(To);
2932   for (DeclContext::lookup_iterator Con = R.begin(), ConEnd = R.end();
2933        Con != ConEnd; ++Con) {
2934     NamedDecl *D = *Con;
2935     DeclAccessPair FoundDecl = DeclAccessPair::make(D, D->getAccess());
2936 
2937     // Find the constructor (which may be a template).
2938     CXXConstructorDecl *Constructor = 0;
2939     FunctionTemplateDecl *ConstructorTmpl
2940       = dyn_cast<FunctionTemplateDecl>(D);
2941     if (ConstructorTmpl)
2942       Constructor
2943         = cast<CXXConstructorDecl>(ConstructorTmpl->getTemplatedDecl());
2944     else
2945       Constructor = cast<CXXConstructorDecl>(D);
2946 
2947     bool Usable = !Constructor->isInvalidDecl() &&
2948                   S.isInitListConstructor(Constructor) &&
2949                   (AllowExplicit || !Constructor->isExplicit());
2950     if (Usable) {
2951       // If the first argument is (a reference to) the target type,
2952       // suppress conversions.
2953       bool SuppressUserConversions =
2954           isFirstArgumentCompatibleWithType(S.Context, Constructor, ToType);
2955       if (ConstructorTmpl)
2956         S.AddTemplateOverloadCandidate(ConstructorTmpl, FoundDecl,
2957                                        /*ExplicitArgs*/ 0,
2958                                        From, CandidateSet,
2959                                        SuppressUserConversions);
2960       else
2961         S.AddOverloadCandidate(Constructor, FoundDecl,
2962                                From, CandidateSet,
2963                                SuppressUserConversions);
2964     }
2965   }
2966 
2967   bool HadMultipleCandidates = (CandidateSet.size() > 1);
2968 
2969   OverloadCandidateSet::iterator Best;
2970   switch (CandidateSet.BestViableFunction(S, From->getLocStart(), Best, true)) {
2971   case OR_Success: {
2972     // Record the standard conversion we used and the conversion function.
2973     CXXConstructorDecl *Constructor = cast<CXXConstructorDecl>(Best->Function);
2974     QualType ThisType = Constructor->getThisType(S.Context);
2975     // Initializer lists don't have conversions as such.
2976     User.Before.setAsIdentityConversion();
2977     User.HadMultipleCandidates = HadMultipleCandidates;
2978     User.ConversionFunction = Constructor;
2979     User.FoundConversionFunction = Best->FoundDecl;
2980     User.After.setAsIdentityConversion();
2981     User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
2982     User.After.setAllToTypes(ToType);
2983     return OR_Success;
2984   }
2985 
2986   case OR_No_Viable_Function:
2987     return OR_No_Viable_Function;
2988   case OR_Deleted:
2989     return OR_Deleted;
2990   case OR_Ambiguous:
2991     return OR_Ambiguous;
2992   }
2993 
2994   llvm_unreachable("Invalid OverloadResult!");
2995 }
2996 
2997 /// Determines whether there is a user-defined conversion sequence
2998 /// (C++ [over.ics.user]) that converts expression From to the type
2999 /// ToType. If such a conversion exists, User will contain the
3000 /// user-defined conversion sequence that performs such a conversion
3001 /// and this routine will return true. Otherwise, this routine returns
3002 /// false and User is unspecified.
3003 ///
3004 /// \param AllowExplicit  true if the conversion should consider C++0x
3005 /// "explicit" conversion functions as well as non-explicit conversion
3006 /// functions (C++0x [class.conv.fct]p2).
3007 static OverloadingResult
3008 IsUserDefinedConversion(Sema &S, Expr *From, QualType ToType,
3009                         UserDefinedConversionSequence &User,
3010                         OverloadCandidateSet &CandidateSet,
3011                         bool AllowExplicit) {
3012   // Whether we will only visit constructors.
3013   bool ConstructorsOnly = false;
3014 
3015   // If the type we are conversion to is a class type, enumerate its
3016   // constructors.
3017   if (const RecordType *ToRecordType = ToType->getAs<RecordType>()) {
3018     // C++ [over.match.ctor]p1:
3019     //   When objects of class type are direct-initialized (8.5), or
3020     //   copy-initialized from an expression of the same or a
3021     //   derived class type (8.5), overload resolution selects the
3022     //   constructor. [...] For copy-initialization, the candidate
3023     //   functions are all the converting constructors (12.3.1) of
3024     //   that class. The argument list is the expression-list within
3025     //   the parentheses of the initializer.
3026     if (S.Context.hasSameUnqualifiedType(ToType, From->getType()) ||
3027         (From->getType()->getAs<RecordType>() &&
3028          S.IsDerivedFrom(From->getType(), ToType)))
3029       ConstructorsOnly = true;
3030 
3031     S.RequireCompleteType(From->getExprLoc(), ToType, 0);
3032     // RequireCompleteType may have returned true due to some invalid decl
3033     // during template instantiation, but ToType may be complete enough now
3034     // to try to recover.
3035     if (ToType->isIncompleteType()) {
3036       // We're not going to find any constructors.
3037     } else if (CXXRecordDecl *ToRecordDecl
3038                  = dyn_cast<CXXRecordDecl>(ToRecordType->getDecl())) {
3039 
3040       Expr **Args = &From;
3041       unsigned NumArgs = 1;
3042       bool ListInitializing = false;
3043       if (InitListExpr *InitList = dyn_cast<InitListExpr>(From)) {
3044         // But first, see if there is an init-list-contructor that will work.
3045         OverloadingResult Result = IsInitializerListConstructorConversion(
3046             S, From, ToType, ToRecordDecl, User, CandidateSet, AllowExplicit);
3047         if (Result != OR_No_Viable_Function)
3048           return Result;
3049         // Never mind.
3050         CandidateSet.clear();
3051 
3052         // If we're list-initializing, we pass the individual elements as
3053         // arguments, not the entire list.
3054         Args = InitList->getInits();
3055         NumArgs = InitList->getNumInits();
3056         ListInitializing = true;
3057       }
3058 
3059       DeclContext::lookup_result R = S.LookupConstructors(ToRecordDecl);
3060       for (DeclContext::lookup_iterator Con = R.begin(), ConEnd = R.end();
3061            Con != ConEnd; ++Con) {
3062         NamedDecl *D = *Con;
3063         DeclAccessPair FoundDecl = DeclAccessPair::make(D, D->getAccess());
3064 
3065         // Find the constructor (which may be a template).
3066         CXXConstructorDecl *Constructor = 0;
3067         FunctionTemplateDecl *ConstructorTmpl
3068           = dyn_cast<FunctionTemplateDecl>(D);
3069         if (ConstructorTmpl)
3070           Constructor
3071             = cast<CXXConstructorDecl>(ConstructorTmpl->getTemplatedDecl());
3072         else
3073           Constructor = cast<CXXConstructorDecl>(D);
3074 
3075         bool Usable = !Constructor->isInvalidDecl();
3076         if (ListInitializing)
3077           Usable = Usable && (AllowExplicit || !Constructor->isExplicit());
3078         else
3079           Usable = Usable &&Constructor->isConvertingConstructor(AllowExplicit);
3080         if (Usable) {
3081           bool SuppressUserConversions = !ConstructorsOnly;
3082           if (SuppressUserConversions && ListInitializing) {
3083             SuppressUserConversions = false;
3084             if (NumArgs == 1) {
3085               // If the first argument is (a reference to) the target type,
3086               // suppress conversions.
3087               SuppressUserConversions = isFirstArgumentCompatibleWithType(
3088                                                 S.Context, Constructor, ToType);
3089             }
3090           }
3091           if (ConstructorTmpl)
3092             S.AddTemplateOverloadCandidate(ConstructorTmpl, FoundDecl,
3093                                            /*ExplicitArgs*/ 0,
3094                                            llvm::makeArrayRef(Args, NumArgs),
3095                                            CandidateSet, SuppressUserConversions);
3096           else
3097             // Allow one user-defined conversion when user specifies a
3098             // From->ToType conversion via an static cast (c-style, etc).
3099             S.AddOverloadCandidate(Constructor, FoundDecl,
3100                                    llvm::makeArrayRef(Args, NumArgs),
3101                                    CandidateSet, SuppressUserConversions);
3102         }
3103       }
3104     }
3105   }
3106 
3107   // Enumerate conversion functions, if we're allowed to.
3108   if (ConstructorsOnly || isa<InitListExpr>(From)) {
3109   } else if (S.RequireCompleteType(From->getLocStart(), From->getType(), 0)) {
3110     // No conversion functions from incomplete types.
3111   } else if (const RecordType *FromRecordType
3112                                    = From->getType()->getAs<RecordType>()) {
3113     if (CXXRecordDecl *FromRecordDecl
3114          = dyn_cast<CXXRecordDecl>(FromRecordType->getDecl())) {
3115       // Add all of the conversion functions as candidates.
3116       std::pair<CXXRecordDecl::conversion_iterator,
3117                 CXXRecordDecl::conversion_iterator>
3118         Conversions = FromRecordDecl->getVisibleConversionFunctions();
3119       for (CXXRecordDecl::conversion_iterator
3120              I = Conversions.first, E = Conversions.second; I != E; ++I) {
3121         DeclAccessPair FoundDecl = I.getPair();
3122         NamedDecl *D = FoundDecl.getDecl();
3123         CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
3124         if (isa<UsingShadowDecl>(D))
3125           D = cast<UsingShadowDecl>(D)->getTargetDecl();
3126 
3127         CXXConversionDecl *Conv;
3128         FunctionTemplateDecl *ConvTemplate;
3129         if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
3130           Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
3131         else
3132           Conv = cast<CXXConversionDecl>(D);
3133 
3134         if (AllowExplicit || !Conv->isExplicit()) {
3135           if (ConvTemplate)
3136             S.AddTemplateConversionCandidate(ConvTemplate, FoundDecl,
3137                                              ActingContext, From, ToType,
3138                                              CandidateSet);
3139           else
3140             S.AddConversionCandidate(Conv, FoundDecl, ActingContext,
3141                                      From, ToType, CandidateSet);
3142         }
3143       }
3144     }
3145   }
3146 
3147   bool HadMultipleCandidates = (CandidateSet.size() > 1);
3148 
3149   OverloadCandidateSet::iterator Best;
3150   switch (CandidateSet.BestViableFunction(S, From->getLocStart(), Best, true)) {
3151   case OR_Success:
3152     // Record the standard conversion we used and the conversion function.
3153     if (CXXConstructorDecl *Constructor
3154           = dyn_cast<CXXConstructorDecl>(Best->Function)) {
3155       // C++ [over.ics.user]p1:
3156       //   If the user-defined conversion is specified by a
3157       //   constructor (12.3.1), the initial standard conversion
3158       //   sequence converts the source type to the type required by
3159       //   the argument of the constructor.
3160       //
3161       QualType ThisType = Constructor->getThisType(S.Context);
3162       if (isa<InitListExpr>(From)) {
3163         // Initializer lists don't have conversions as such.
3164         User.Before.setAsIdentityConversion();
3165       } else {
3166         if (Best->Conversions[0].isEllipsis())
3167           User.EllipsisConversion = true;
3168         else {
3169           User.Before = Best->Conversions[0].Standard;
3170           User.EllipsisConversion = false;
3171         }
3172       }
3173       User.HadMultipleCandidates = HadMultipleCandidates;
3174       User.ConversionFunction = Constructor;
3175       User.FoundConversionFunction = Best->FoundDecl;
3176       User.After.setAsIdentityConversion();
3177       User.After.setFromType(ThisType->getAs<PointerType>()->getPointeeType());
3178       User.After.setAllToTypes(ToType);
3179       return OR_Success;
3180     }
3181     if (CXXConversionDecl *Conversion
3182                  = dyn_cast<CXXConversionDecl>(Best->Function)) {
3183       // C++ [over.ics.user]p1:
3184       //
3185       //   [...] If the user-defined conversion is specified by a
3186       //   conversion function (12.3.2), the initial standard
3187       //   conversion sequence converts the source type to the
3188       //   implicit object parameter of the conversion function.
3189       User.Before = Best->Conversions[0].Standard;
3190       User.HadMultipleCandidates = HadMultipleCandidates;
3191       User.ConversionFunction = Conversion;
3192       User.FoundConversionFunction = Best->FoundDecl;
3193       User.EllipsisConversion = false;
3194 
3195       // C++ [over.ics.user]p2:
3196       //   The second standard conversion sequence converts the
3197       //   result of the user-defined conversion to the target type
3198       //   for the sequence. Since an implicit conversion sequence
3199       //   is an initialization, the special rules for
3200       //   initialization by user-defined conversion apply when
3201       //   selecting the best user-defined conversion for a
3202       //   user-defined conversion sequence (see 13.3.3 and
3203       //   13.3.3.1).
3204       User.After = Best->FinalConversion;
3205       return OR_Success;
3206     }
3207     llvm_unreachable("Not a constructor or conversion function?");
3208 
3209   case OR_No_Viable_Function:
3210     return OR_No_Viable_Function;
3211   case OR_Deleted:
3212     // No conversion here! We're done.
3213     return OR_Deleted;
3214 
3215   case OR_Ambiguous:
3216     return OR_Ambiguous;
3217   }
3218 
3219   llvm_unreachable("Invalid OverloadResult!");
3220 }
3221 
3222 bool
3223 Sema::DiagnoseMultipleUserDefinedConversion(Expr *From, QualType ToType) {
3224   ImplicitConversionSequence ICS;
3225   OverloadCandidateSet CandidateSet(From->getExprLoc());
3226   OverloadingResult OvResult =
3227     IsUserDefinedConversion(*this, From, ToType, ICS.UserDefined,
3228                             CandidateSet, false);
3229   if (OvResult == OR_Ambiguous)
3230     Diag(From->getLocStart(),
3231          diag::err_typecheck_ambiguous_condition)
3232           << From->getType() << ToType << From->getSourceRange();
3233   else if (OvResult == OR_No_Viable_Function && !CandidateSet.empty())
3234     Diag(From->getLocStart(),
3235          diag::err_typecheck_nonviable_condition)
3236     << From->getType() << ToType << From->getSourceRange();
3237   else
3238     return false;
3239   CandidateSet.NoteCandidates(*this, OCD_AllCandidates, From);
3240   return true;
3241 }
3242 
3243 /// \brief Compare the user-defined conversion functions or constructors
3244 /// of two user-defined conversion sequences to determine whether any ordering
3245 /// is possible.
3246 static ImplicitConversionSequence::CompareKind
3247 compareConversionFunctions(Sema &S,
3248                            FunctionDecl *Function1,
3249                            FunctionDecl *Function2) {
3250   if (!S.getLangOpts().ObjC1 || !S.getLangOpts().CPlusPlus11)
3251     return ImplicitConversionSequence::Indistinguishable;
3252 
3253   // Objective-C++:
3254   //   If both conversion functions are implicitly-declared conversions from
3255   //   a lambda closure type to a function pointer and a block pointer,
3256   //   respectively, always prefer the conversion to a function pointer,
3257   //   because the function pointer is more lightweight and is more likely
3258   //   to keep code working.
3259   CXXConversionDecl *Conv1 = dyn_cast<CXXConversionDecl>(Function1);
3260   if (!Conv1)
3261     return ImplicitConversionSequence::Indistinguishable;
3262 
3263   CXXConversionDecl *Conv2 = dyn_cast<CXXConversionDecl>(Function2);
3264   if (!Conv2)
3265     return ImplicitConversionSequence::Indistinguishable;
3266 
3267   if (Conv1->getParent()->isLambda() && Conv2->getParent()->isLambda()) {
3268     bool Block1 = Conv1->getConversionType()->isBlockPointerType();
3269     bool Block2 = Conv2->getConversionType()->isBlockPointerType();
3270     if (Block1 != Block2)
3271       return Block1? ImplicitConversionSequence::Worse
3272                    : ImplicitConversionSequence::Better;
3273   }
3274 
3275   return ImplicitConversionSequence::Indistinguishable;
3276 }
3277 
3278 /// CompareImplicitConversionSequences - Compare two implicit
3279 /// conversion sequences to determine whether one is better than the
3280 /// other or if they are indistinguishable (C++ 13.3.3.2).
3281 static ImplicitConversionSequence::CompareKind
3282 CompareImplicitConversionSequences(Sema &S,
3283                                    const ImplicitConversionSequence& ICS1,
3284                                    const ImplicitConversionSequence& ICS2)
3285 {
3286   // (C++ 13.3.3.2p2): When comparing the basic forms of implicit
3287   // conversion sequences (as defined in 13.3.3.1)
3288   //   -- a standard conversion sequence (13.3.3.1.1) is a better
3289   //      conversion sequence than a user-defined conversion sequence or
3290   //      an ellipsis conversion sequence, and
3291   //   -- a user-defined conversion sequence (13.3.3.1.2) is a better
3292   //      conversion sequence than an ellipsis conversion sequence
3293   //      (13.3.3.1.3).
3294   //
3295   // C++0x [over.best.ics]p10:
3296   //   For the purpose of ranking implicit conversion sequences as
3297   //   described in 13.3.3.2, the ambiguous conversion sequence is
3298   //   treated as a user-defined sequence that is indistinguishable
3299   //   from any other user-defined conversion sequence.
3300   if (ICS1.getKindRank() < ICS2.getKindRank())
3301     return ImplicitConversionSequence::Better;
3302   if (ICS2.getKindRank() < ICS1.getKindRank())
3303     return ImplicitConversionSequence::Worse;
3304 
3305   // The following checks require both conversion sequences to be of
3306   // the same kind.
3307   if (ICS1.getKind() != ICS2.getKind())
3308     return ImplicitConversionSequence::Indistinguishable;
3309 
3310   ImplicitConversionSequence::CompareKind Result =
3311       ImplicitConversionSequence::Indistinguishable;
3312 
3313   // Two implicit conversion sequences of the same form are
3314   // indistinguishable conversion sequences unless one of the
3315   // following rules apply: (C++ 13.3.3.2p3):
3316   if (ICS1.isStandard())
3317     Result = CompareStandardConversionSequences(S,
3318                                                 ICS1.Standard, ICS2.Standard);
3319   else if (ICS1.isUserDefined()) {
3320     // User-defined conversion sequence U1 is a better conversion
3321     // sequence than another user-defined conversion sequence U2 if
3322     // they contain the same user-defined conversion function or
3323     // constructor and if the second standard conversion sequence of
3324     // U1 is better than the second standard conversion sequence of
3325     // U2 (C++ 13.3.3.2p3).
3326     if (ICS1.UserDefined.ConversionFunction ==
3327           ICS2.UserDefined.ConversionFunction)
3328       Result = CompareStandardConversionSequences(S,
3329                                                   ICS1.UserDefined.After,
3330                                                   ICS2.UserDefined.After);
3331     else
3332       Result = compareConversionFunctions(S,
3333                                           ICS1.UserDefined.ConversionFunction,
3334                                           ICS2.UserDefined.ConversionFunction);
3335   }
3336 
3337   // List-initialization sequence L1 is a better conversion sequence than
3338   // list-initialization sequence L2 if L1 converts to std::initializer_list<X>
3339   // for some X and L2 does not.
3340   if (Result == ImplicitConversionSequence::Indistinguishable &&
3341       !ICS1.isBad() &&
3342       ICS1.isListInitializationSequence() &&
3343       ICS2.isListInitializationSequence()) {
3344     if (ICS1.isStdInitializerListElement() &&
3345         !ICS2.isStdInitializerListElement())
3346       return ImplicitConversionSequence::Better;
3347     if (!ICS1.isStdInitializerListElement() &&
3348         ICS2.isStdInitializerListElement())
3349       return ImplicitConversionSequence::Worse;
3350   }
3351 
3352   return Result;
3353 }
3354 
3355 static bool hasSimilarType(ASTContext &Context, QualType T1, QualType T2) {
3356   while (Context.UnwrapSimilarPointerTypes(T1, T2)) {
3357     Qualifiers Quals;
3358     T1 = Context.getUnqualifiedArrayType(T1, Quals);
3359     T2 = Context.getUnqualifiedArrayType(T2, Quals);
3360   }
3361 
3362   return Context.hasSameUnqualifiedType(T1, T2);
3363 }
3364 
3365 // Per 13.3.3.2p3, compare the given standard conversion sequences to
3366 // determine if one is a proper subset of the other.
3367 static ImplicitConversionSequence::CompareKind
3368 compareStandardConversionSubsets(ASTContext &Context,
3369                                  const StandardConversionSequence& SCS1,
3370                                  const StandardConversionSequence& SCS2) {
3371   ImplicitConversionSequence::CompareKind Result
3372     = ImplicitConversionSequence::Indistinguishable;
3373 
3374   // the identity conversion sequence is considered to be a subsequence of
3375   // any non-identity conversion sequence
3376   if (SCS1.isIdentityConversion() && !SCS2.isIdentityConversion())
3377     return ImplicitConversionSequence::Better;
3378   else if (!SCS1.isIdentityConversion() && SCS2.isIdentityConversion())
3379     return ImplicitConversionSequence::Worse;
3380 
3381   if (SCS1.Second != SCS2.Second) {
3382     if (SCS1.Second == ICK_Identity)
3383       Result = ImplicitConversionSequence::Better;
3384     else if (SCS2.Second == ICK_Identity)
3385       Result = ImplicitConversionSequence::Worse;
3386     else
3387       return ImplicitConversionSequence::Indistinguishable;
3388   } else if (!hasSimilarType(Context, SCS1.getToType(1), SCS2.getToType(1)))
3389     return ImplicitConversionSequence::Indistinguishable;
3390 
3391   if (SCS1.Third == SCS2.Third) {
3392     return Context.hasSameType(SCS1.getToType(2), SCS2.getToType(2))? Result
3393                              : ImplicitConversionSequence::Indistinguishable;
3394   }
3395 
3396   if (SCS1.Third == ICK_Identity)
3397     return Result == ImplicitConversionSequence::Worse
3398              ? ImplicitConversionSequence::Indistinguishable
3399              : ImplicitConversionSequence::Better;
3400 
3401   if (SCS2.Third == ICK_Identity)
3402     return Result == ImplicitConversionSequence::Better
3403              ? ImplicitConversionSequence::Indistinguishable
3404              : ImplicitConversionSequence::Worse;
3405 
3406   return ImplicitConversionSequence::Indistinguishable;
3407 }
3408 
3409 /// \brief Determine whether one of the given reference bindings is better
3410 /// than the other based on what kind of bindings they are.
3411 static bool isBetterReferenceBindingKind(const StandardConversionSequence &SCS1,
3412                                        const StandardConversionSequence &SCS2) {
3413   // C++0x [over.ics.rank]p3b4:
3414   //   -- S1 and S2 are reference bindings (8.5.3) and neither refers to an
3415   //      implicit object parameter of a non-static member function declared
3416   //      without a ref-qualifier, and *either* S1 binds an rvalue reference
3417   //      to an rvalue and S2 binds an lvalue reference *or S1 binds an
3418   //      lvalue reference to a function lvalue and S2 binds an rvalue
3419   //      reference*.
3420   //
3421   // FIXME: Rvalue references. We're going rogue with the above edits,
3422   // because the semantics in the current C++0x working paper (N3225 at the
3423   // time of this writing) break the standard definition of std::forward
3424   // and std::reference_wrapper when dealing with references to functions.
3425   // Proposed wording changes submitted to CWG for consideration.
3426   if (SCS1.BindsImplicitObjectArgumentWithoutRefQualifier ||
3427       SCS2.BindsImplicitObjectArgumentWithoutRefQualifier)
3428     return false;
3429 
3430   return (!SCS1.IsLvalueReference && SCS1.BindsToRvalue &&
3431           SCS2.IsLvalueReference) ||
3432          (SCS1.IsLvalueReference && SCS1.BindsToFunctionLvalue &&
3433           !SCS2.IsLvalueReference);
3434 }
3435 
3436 /// CompareStandardConversionSequences - Compare two standard
3437 /// conversion sequences to determine whether one is better than the
3438 /// other or if they are indistinguishable (C++ 13.3.3.2p3).
3439 static ImplicitConversionSequence::CompareKind
3440 CompareStandardConversionSequences(Sema &S,
3441                                    const StandardConversionSequence& SCS1,
3442                                    const StandardConversionSequence& SCS2)
3443 {
3444   // Standard conversion sequence S1 is a better conversion sequence
3445   // than standard conversion sequence S2 if (C++ 13.3.3.2p3):
3446 
3447   //  -- S1 is a proper subsequence of S2 (comparing the conversion
3448   //     sequences in the canonical form defined by 13.3.3.1.1,
3449   //     excluding any Lvalue Transformation; the identity conversion
3450   //     sequence is considered to be a subsequence of any
3451   //     non-identity conversion sequence) or, if not that,
3452   if (ImplicitConversionSequence::CompareKind CK
3453         = compareStandardConversionSubsets(S.Context, SCS1, SCS2))
3454     return CK;
3455 
3456   //  -- the rank of S1 is better than the rank of S2 (by the rules
3457   //     defined below), or, if not that,
3458   ImplicitConversionRank Rank1 = SCS1.getRank();
3459   ImplicitConversionRank Rank2 = SCS2.getRank();
3460   if (Rank1 < Rank2)
3461     return ImplicitConversionSequence::Better;
3462   else if (Rank2 < Rank1)
3463     return ImplicitConversionSequence::Worse;
3464 
3465   // (C++ 13.3.3.2p4): Two conversion sequences with the same rank
3466   // are indistinguishable unless one of the following rules
3467   // applies:
3468 
3469   //   A conversion that is not a conversion of a pointer, or
3470   //   pointer to member, to bool is better than another conversion
3471   //   that is such a conversion.
3472   if (SCS1.isPointerConversionToBool() != SCS2.isPointerConversionToBool())
3473     return SCS2.isPointerConversionToBool()
3474              ? ImplicitConversionSequence::Better
3475              : ImplicitConversionSequence::Worse;
3476 
3477   // C++ [over.ics.rank]p4b2:
3478   //
3479   //   If class B is derived directly or indirectly from class A,
3480   //   conversion of B* to A* is better than conversion of B* to
3481   //   void*, and conversion of A* to void* is better than conversion
3482   //   of B* to void*.
3483   bool SCS1ConvertsToVoid
3484     = SCS1.isPointerConversionToVoidPointer(S.Context);
3485   bool SCS2ConvertsToVoid
3486     = SCS2.isPointerConversionToVoidPointer(S.Context);
3487   if (SCS1ConvertsToVoid != SCS2ConvertsToVoid) {
3488     // Exactly one of the conversion sequences is a conversion to
3489     // a void pointer; it's the worse conversion.
3490     return SCS2ConvertsToVoid ? ImplicitConversionSequence::Better
3491                               : ImplicitConversionSequence::Worse;
3492   } else if (!SCS1ConvertsToVoid && !SCS2ConvertsToVoid) {
3493     // Neither conversion sequence converts to a void pointer; compare
3494     // their derived-to-base conversions.
3495     if (ImplicitConversionSequence::CompareKind DerivedCK
3496           = CompareDerivedToBaseConversions(S, SCS1, SCS2))
3497       return DerivedCK;
3498   } else if (SCS1ConvertsToVoid && SCS2ConvertsToVoid &&
3499              !S.Context.hasSameType(SCS1.getFromType(), SCS2.getFromType())) {
3500     // Both conversion sequences are conversions to void
3501     // pointers. Compare the source types to determine if there's an
3502     // inheritance relationship in their sources.
3503     QualType FromType1 = SCS1.getFromType();
3504     QualType FromType2 = SCS2.getFromType();
3505 
3506     // Adjust the types we're converting from via the array-to-pointer
3507     // conversion, if we need to.
3508     if (SCS1.First == ICK_Array_To_Pointer)
3509       FromType1 = S.Context.getArrayDecayedType(FromType1);
3510     if (SCS2.First == ICK_Array_To_Pointer)
3511       FromType2 = S.Context.getArrayDecayedType(FromType2);
3512 
3513     QualType FromPointee1 = FromType1->getPointeeType().getUnqualifiedType();
3514     QualType FromPointee2 = FromType2->getPointeeType().getUnqualifiedType();
3515 
3516     if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3517       return ImplicitConversionSequence::Better;
3518     else if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3519       return ImplicitConversionSequence::Worse;
3520 
3521     // Objective-C++: If one interface is more specific than the
3522     // other, it is the better one.
3523     const ObjCObjectPointerType* FromObjCPtr1
3524       = FromType1->getAs<ObjCObjectPointerType>();
3525     const ObjCObjectPointerType* FromObjCPtr2
3526       = FromType2->getAs<ObjCObjectPointerType>();
3527     if (FromObjCPtr1 && FromObjCPtr2) {
3528       bool AssignLeft = S.Context.canAssignObjCInterfaces(FromObjCPtr1,
3529                                                           FromObjCPtr2);
3530       bool AssignRight = S.Context.canAssignObjCInterfaces(FromObjCPtr2,
3531                                                            FromObjCPtr1);
3532       if (AssignLeft != AssignRight) {
3533         return AssignLeft? ImplicitConversionSequence::Better
3534                          : ImplicitConversionSequence::Worse;
3535       }
3536     }
3537   }
3538 
3539   // Compare based on qualification conversions (C++ 13.3.3.2p3,
3540   // bullet 3).
3541   if (ImplicitConversionSequence::CompareKind QualCK
3542         = CompareQualificationConversions(S, SCS1, SCS2))
3543     return QualCK;
3544 
3545   if (SCS1.ReferenceBinding && SCS2.ReferenceBinding) {
3546     // Check for a better reference binding based on the kind of bindings.
3547     if (isBetterReferenceBindingKind(SCS1, SCS2))
3548       return ImplicitConversionSequence::Better;
3549     else if (isBetterReferenceBindingKind(SCS2, SCS1))
3550       return ImplicitConversionSequence::Worse;
3551 
3552     // C++ [over.ics.rank]p3b4:
3553     //   -- S1 and S2 are reference bindings (8.5.3), and the types to
3554     //      which the references refer are the same type except for
3555     //      top-level cv-qualifiers, and the type to which the reference
3556     //      initialized by S2 refers is more cv-qualified than the type
3557     //      to which the reference initialized by S1 refers.
3558     QualType T1 = SCS1.getToType(2);
3559     QualType T2 = SCS2.getToType(2);
3560     T1 = S.Context.getCanonicalType(T1);
3561     T2 = S.Context.getCanonicalType(T2);
3562     Qualifiers T1Quals, T2Quals;
3563     QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3564     QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3565     if (UnqualT1 == UnqualT2) {
3566       // Objective-C++ ARC: If the references refer to objects with different
3567       // lifetimes, prefer bindings that don't change lifetime.
3568       if (SCS1.ObjCLifetimeConversionBinding !=
3569                                           SCS2.ObjCLifetimeConversionBinding) {
3570         return SCS1.ObjCLifetimeConversionBinding
3571                                            ? ImplicitConversionSequence::Worse
3572                                            : ImplicitConversionSequence::Better;
3573       }
3574 
3575       // If the type is an array type, promote the element qualifiers to the
3576       // type for comparison.
3577       if (isa<ArrayType>(T1) && T1Quals)
3578         T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3579       if (isa<ArrayType>(T2) && T2Quals)
3580         T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3581       if (T2.isMoreQualifiedThan(T1))
3582         return ImplicitConversionSequence::Better;
3583       else if (T1.isMoreQualifiedThan(T2))
3584         return ImplicitConversionSequence::Worse;
3585     }
3586   }
3587 
3588   // In Microsoft mode, prefer an integral conversion to a
3589   // floating-to-integral conversion if the integral conversion
3590   // is between types of the same size.
3591   // For example:
3592   // void f(float);
3593   // void f(int);
3594   // int main {
3595   //    long a;
3596   //    f(a);
3597   // }
3598   // Here, MSVC will call f(int) instead of generating a compile error
3599   // as clang will do in standard mode.
3600   if (S.getLangOpts().MicrosoftMode &&
3601       SCS1.Second == ICK_Integral_Conversion &&
3602       SCS2.Second == ICK_Floating_Integral &&
3603       S.Context.getTypeSize(SCS1.getFromType()) ==
3604       S.Context.getTypeSize(SCS1.getToType(2)))
3605     return ImplicitConversionSequence::Better;
3606 
3607   return ImplicitConversionSequence::Indistinguishable;
3608 }
3609 
3610 /// CompareQualificationConversions - Compares two standard conversion
3611 /// sequences to determine whether they can be ranked based on their
3612 /// qualification conversions (C++ 13.3.3.2p3 bullet 3).
3613 ImplicitConversionSequence::CompareKind
3614 CompareQualificationConversions(Sema &S,
3615                                 const StandardConversionSequence& SCS1,
3616                                 const StandardConversionSequence& SCS2) {
3617   // C++ 13.3.3.2p3:
3618   //  -- S1 and S2 differ only in their qualification conversion and
3619   //     yield similar types T1 and T2 (C++ 4.4), respectively, and the
3620   //     cv-qualification signature of type T1 is a proper subset of
3621   //     the cv-qualification signature of type T2, and S1 is not the
3622   //     deprecated string literal array-to-pointer conversion (4.2).
3623   if (SCS1.First != SCS2.First || SCS1.Second != SCS2.Second ||
3624       SCS1.Third != SCS2.Third || SCS1.Third != ICK_Qualification)
3625     return ImplicitConversionSequence::Indistinguishable;
3626 
3627   // FIXME: the example in the standard doesn't use a qualification
3628   // conversion (!)
3629   QualType T1 = SCS1.getToType(2);
3630   QualType T2 = SCS2.getToType(2);
3631   T1 = S.Context.getCanonicalType(T1);
3632   T2 = S.Context.getCanonicalType(T2);
3633   Qualifiers T1Quals, T2Quals;
3634   QualType UnqualT1 = S.Context.getUnqualifiedArrayType(T1, T1Quals);
3635   QualType UnqualT2 = S.Context.getUnqualifiedArrayType(T2, T2Quals);
3636 
3637   // If the types are the same, we won't learn anything by unwrapped
3638   // them.
3639   if (UnqualT1 == UnqualT2)
3640     return ImplicitConversionSequence::Indistinguishable;
3641 
3642   // If the type is an array type, promote the element qualifiers to the type
3643   // for comparison.
3644   if (isa<ArrayType>(T1) && T1Quals)
3645     T1 = S.Context.getQualifiedType(UnqualT1, T1Quals);
3646   if (isa<ArrayType>(T2) && T2Quals)
3647     T2 = S.Context.getQualifiedType(UnqualT2, T2Quals);
3648 
3649   ImplicitConversionSequence::CompareKind Result
3650     = ImplicitConversionSequence::Indistinguishable;
3651 
3652   // Objective-C++ ARC:
3653   //   Prefer qualification conversions not involving a change in lifetime
3654   //   to qualification conversions that do not change lifetime.
3655   if (SCS1.QualificationIncludesObjCLifetime !=
3656                                       SCS2.QualificationIncludesObjCLifetime) {
3657     Result = SCS1.QualificationIncludesObjCLifetime
3658                ? ImplicitConversionSequence::Worse
3659                : ImplicitConversionSequence::Better;
3660   }
3661 
3662   while (S.Context.UnwrapSimilarPointerTypes(T1, T2)) {
3663     // Within each iteration of the loop, we check the qualifiers to
3664     // determine if this still looks like a qualification
3665     // conversion. Then, if all is well, we unwrap one more level of
3666     // pointers or pointers-to-members and do it all again
3667     // until there are no more pointers or pointers-to-members left
3668     // to unwrap. This essentially mimics what
3669     // IsQualificationConversion does, but here we're checking for a
3670     // strict subset of qualifiers.
3671     if (T1.getCVRQualifiers() == T2.getCVRQualifiers())
3672       // The qualifiers are the same, so this doesn't tell us anything
3673       // about how the sequences rank.
3674       ;
3675     else if (T2.isMoreQualifiedThan(T1)) {
3676       // T1 has fewer qualifiers, so it could be the better sequence.
3677       if (Result == ImplicitConversionSequence::Worse)
3678         // Neither has qualifiers that are a subset of the other's
3679         // qualifiers.
3680         return ImplicitConversionSequence::Indistinguishable;
3681 
3682       Result = ImplicitConversionSequence::Better;
3683     } else if (T1.isMoreQualifiedThan(T2)) {
3684       // T2 has fewer qualifiers, so it could be the better sequence.
3685       if (Result == ImplicitConversionSequence::Better)
3686         // Neither has qualifiers that are a subset of the other's
3687         // qualifiers.
3688         return ImplicitConversionSequence::Indistinguishable;
3689 
3690       Result = ImplicitConversionSequence::Worse;
3691     } else {
3692       // Qualifiers are disjoint.
3693       return ImplicitConversionSequence::Indistinguishable;
3694     }
3695 
3696     // If the types after this point are equivalent, we're done.
3697     if (S.Context.hasSameUnqualifiedType(T1, T2))
3698       break;
3699   }
3700 
3701   // Check that the winning standard conversion sequence isn't using
3702   // the deprecated string literal array to pointer conversion.
3703   switch (Result) {
3704   case ImplicitConversionSequence::Better:
3705     if (SCS1.DeprecatedStringLiteralToCharPtr)
3706       Result = ImplicitConversionSequence::Indistinguishable;
3707     break;
3708 
3709   case ImplicitConversionSequence::Indistinguishable:
3710     break;
3711 
3712   case ImplicitConversionSequence::Worse:
3713     if (SCS2.DeprecatedStringLiteralToCharPtr)
3714       Result = ImplicitConversionSequence::Indistinguishable;
3715     break;
3716   }
3717 
3718   return Result;
3719 }
3720 
3721 /// CompareDerivedToBaseConversions - Compares two standard conversion
3722 /// sequences to determine whether they can be ranked based on their
3723 /// various kinds of derived-to-base conversions (C++
3724 /// [over.ics.rank]p4b3).  As part of these checks, we also look at
3725 /// conversions between Objective-C interface types.
3726 ImplicitConversionSequence::CompareKind
3727 CompareDerivedToBaseConversions(Sema &S,
3728                                 const StandardConversionSequence& SCS1,
3729                                 const StandardConversionSequence& SCS2) {
3730   QualType FromType1 = SCS1.getFromType();
3731   QualType ToType1 = SCS1.getToType(1);
3732   QualType FromType2 = SCS2.getFromType();
3733   QualType ToType2 = SCS2.getToType(1);
3734 
3735   // Adjust the types we're converting from via the array-to-pointer
3736   // conversion, if we need to.
3737   if (SCS1.First == ICK_Array_To_Pointer)
3738     FromType1 = S.Context.getArrayDecayedType(FromType1);
3739   if (SCS2.First == ICK_Array_To_Pointer)
3740     FromType2 = S.Context.getArrayDecayedType(FromType2);
3741 
3742   // Canonicalize all of the types.
3743   FromType1 = S.Context.getCanonicalType(FromType1);
3744   ToType1 = S.Context.getCanonicalType(ToType1);
3745   FromType2 = S.Context.getCanonicalType(FromType2);
3746   ToType2 = S.Context.getCanonicalType(ToType2);
3747 
3748   // C++ [over.ics.rank]p4b3:
3749   //
3750   //   If class B is derived directly or indirectly from class A and
3751   //   class C is derived directly or indirectly from B,
3752   //
3753   // Compare based on pointer conversions.
3754   if (SCS1.Second == ICK_Pointer_Conversion &&
3755       SCS2.Second == ICK_Pointer_Conversion &&
3756       /*FIXME: Remove if Objective-C id conversions get their own rank*/
3757       FromType1->isPointerType() && FromType2->isPointerType() &&
3758       ToType1->isPointerType() && ToType2->isPointerType()) {
3759     QualType FromPointee1
3760       = FromType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3761     QualType ToPointee1
3762       = ToType1->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3763     QualType FromPointee2
3764       = FromType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3765     QualType ToPointee2
3766       = ToType2->getAs<PointerType>()->getPointeeType().getUnqualifiedType();
3767 
3768     //   -- conversion of C* to B* is better than conversion of C* to A*,
3769     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
3770       if (S.IsDerivedFrom(ToPointee1, ToPointee2))
3771         return ImplicitConversionSequence::Better;
3772       else if (S.IsDerivedFrom(ToPointee2, ToPointee1))
3773         return ImplicitConversionSequence::Worse;
3774     }
3775 
3776     //   -- conversion of B* to A* is better than conversion of C* to A*,
3777     if (FromPointee1 != FromPointee2 && ToPointee1 == ToPointee2) {
3778       if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3779         return ImplicitConversionSequence::Better;
3780       else if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3781         return ImplicitConversionSequence::Worse;
3782     }
3783   } else if (SCS1.Second == ICK_Pointer_Conversion &&
3784              SCS2.Second == ICK_Pointer_Conversion) {
3785     const ObjCObjectPointerType *FromPtr1
3786       = FromType1->getAs<ObjCObjectPointerType>();
3787     const ObjCObjectPointerType *FromPtr2
3788       = FromType2->getAs<ObjCObjectPointerType>();
3789     const ObjCObjectPointerType *ToPtr1
3790       = ToType1->getAs<ObjCObjectPointerType>();
3791     const ObjCObjectPointerType *ToPtr2
3792       = ToType2->getAs<ObjCObjectPointerType>();
3793 
3794     if (FromPtr1 && FromPtr2 && ToPtr1 && ToPtr2) {
3795       // Apply the same conversion ranking rules for Objective-C pointer types
3796       // that we do for C++ pointers to class types. However, we employ the
3797       // Objective-C pseudo-subtyping relationship used for assignment of
3798       // Objective-C pointer types.
3799       bool FromAssignLeft
3800         = S.Context.canAssignObjCInterfaces(FromPtr1, FromPtr2);
3801       bool FromAssignRight
3802         = S.Context.canAssignObjCInterfaces(FromPtr2, FromPtr1);
3803       bool ToAssignLeft
3804         = S.Context.canAssignObjCInterfaces(ToPtr1, ToPtr2);
3805       bool ToAssignRight
3806         = S.Context.canAssignObjCInterfaces(ToPtr2, ToPtr1);
3807 
3808       // A conversion to an a non-id object pointer type or qualified 'id'
3809       // type is better than a conversion to 'id'.
3810       if (ToPtr1->isObjCIdType() &&
3811           (ToPtr2->isObjCQualifiedIdType() || ToPtr2->getInterfaceDecl()))
3812         return ImplicitConversionSequence::Worse;
3813       if (ToPtr2->isObjCIdType() &&
3814           (ToPtr1->isObjCQualifiedIdType() || ToPtr1->getInterfaceDecl()))
3815         return ImplicitConversionSequence::Better;
3816 
3817       // A conversion to a non-id object pointer type is better than a
3818       // conversion to a qualified 'id' type
3819       if (ToPtr1->isObjCQualifiedIdType() && ToPtr2->getInterfaceDecl())
3820         return ImplicitConversionSequence::Worse;
3821       if (ToPtr2->isObjCQualifiedIdType() && ToPtr1->getInterfaceDecl())
3822         return ImplicitConversionSequence::Better;
3823 
3824       // A conversion to an a non-Class object pointer type or qualified 'Class'
3825       // type is better than a conversion to 'Class'.
3826       if (ToPtr1->isObjCClassType() &&
3827           (ToPtr2->isObjCQualifiedClassType() || ToPtr2->getInterfaceDecl()))
3828         return ImplicitConversionSequence::Worse;
3829       if (ToPtr2->isObjCClassType() &&
3830           (ToPtr1->isObjCQualifiedClassType() || ToPtr1->getInterfaceDecl()))
3831         return ImplicitConversionSequence::Better;
3832 
3833       // A conversion to a non-Class object pointer type is better than a
3834       // conversion to a qualified 'Class' type.
3835       if (ToPtr1->isObjCQualifiedClassType() && ToPtr2->getInterfaceDecl())
3836         return ImplicitConversionSequence::Worse;
3837       if (ToPtr2->isObjCQualifiedClassType() && ToPtr1->getInterfaceDecl())
3838         return ImplicitConversionSequence::Better;
3839 
3840       //   -- "conversion of C* to B* is better than conversion of C* to A*,"
3841       if (S.Context.hasSameType(FromType1, FromType2) &&
3842           !FromPtr1->isObjCIdType() && !FromPtr1->isObjCClassType() &&
3843           (ToAssignLeft != ToAssignRight))
3844         return ToAssignLeft? ImplicitConversionSequence::Worse
3845                            : ImplicitConversionSequence::Better;
3846 
3847       //   -- "conversion of B* to A* is better than conversion of C* to A*,"
3848       if (S.Context.hasSameUnqualifiedType(ToType1, ToType2) &&
3849           (FromAssignLeft != FromAssignRight))
3850         return FromAssignLeft? ImplicitConversionSequence::Better
3851         : ImplicitConversionSequence::Worse;
3852     }
3853   }
3854 
3855   // Ranking of member-pointer types.
3856   if (SCS1.Second == ICK_Pointer_Member && SCS2.Second == ICK_Pointer_Member &&
3857       FromType1->isMemberPointerType() && FromType2->isMemberPointerType() &&
3858       ToType1->isMemberPointerType() && ToType2->isMemberPointerType()) {
3859     const MemberPointerType * FromMemPointer1 =
3860                                         FromType1->getAs<MemberPointerType>();
3861     const MemberPointerType * ToMemPointer1 =
3862                                           ToType1->getAs<MemberPointerType>();
3863     const MemberPointerType * FromMemPointer2 =
3864                                           FromType2->getAs<MemberPointerType>();
3865     const MemberPointerType * ToMemPointer2 =
3866                                           ToType2->getAs<MemberPointerType>();
3867     const Type *FromPointeeType1 = FromMemPointer1->getClass();
3868     const Type *ToPointeeType1 = ToMemPointer1->getClass();
3869     const Type *FromPointeeType2 = FromMemPointer2->getClass();
3870     const Type *ToPointeeType2 = ToMemPointer2->getClass();
3871     QualType FromPointee1 = QualType(FromPointeeType1, 0).getUnqualifiedType();
3872     QualType ToPointee1 = QualType(ToPointeeType1, 0).getUnqualifiedType();
3873     QualType FromPointee2 = QualType(FromPointeeType2, 0).getUnqualifiedType();
3874     QualType ToPointee2 = QualType(ToPointeeType2, 0).getUnqualifiedType();
3875     // conversion of A::* to B::* is better than conversion of A::* to C::*,
3876     if (FromPointee1 == FromPointee2 && ToPointee1 != ToPointee2) {
3877       if (S.IsDerivedFrom(ToPointee1, ToPointee2))
3878         return ImplicitConversionSequence::Worse;
3879       else if (S.IsDerivedFrom(ToPointee2, ToPointee1))
3880         return ImplicitConversionSequence::Better;
3881     }
3882     // conversion of B::* to C::* is better than conversion of A::* to C::*
3883     if (ToPointee1 == ToPointee2 && FromPointee1 != FromPointee2) {
3884       if (S.IsDerivedFrom(FromPointee1, FromPointee2))
3885         return ImplicitConversionSequence::Better;
3886       else if (S.IsDerivedFrom(FromPointee2, FromPointee1))
3887         return ImplicitConversionSequence::Worse;
3888     }
3889   }
3890 
3891   if (SCS1.Second == ICK_Derived_To_Base) {
3892     //   -- conversion of C to B is better than conversion of C to A,
3893     //   -- binding of an expression of type C to a reference of type
3894     //      B& is better than binding an expression of type C to a
3895     //      reference of type A&,
3896     if (S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
3897         !S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
3898       if (S.IsDerivedFrom(ToType1, ToType2))
3899         return ImplicitConversionSequence::Better;
3900       else if (S.IsDerivedFrom(ToType2, ToType1))
3901         return ImplicitConversionSequence::Worse;
3902     }
3903 
3904     //   -- conversion of B to A is better than conversion of C to A.
3905     //   -- binding of an expression of type B to a reference of type
3906     //      A& is better than binding an expression of type C to a
3907     //      reference of type A&,
3908     if (!S.Context.hasSameUnqualifiedType(FromType1, FromType2) &&
3909         S.Context.hasSameUnqualifiedType(ToType1, ToType2)) {
3910       if (S.IsDerivedFrom(FromType2, FromType1))
3911         return ImplicitConversionSequence::Better;
3912       else if (S.IsDerivedFrom(FromType1, FromType2))
3913         return ImplicitConversionSequence::Worse;
3914     }
3915   }
3916 
3917   return ImplicitConversionSequence::Indistinguishable;
3918 }
3919 
3920 /// \brief Determine whether the given type is valid, e.g., it is not an invalid
3921 /// C++ class.
3922 static bool isTypeValid(QualType T) {
3923   if (CXXRecordDecl *Record = T->getAsCXXRecordDecl())
3924     return !Record->isInvalidDecl();
3925 
3926   return true;
3927 }
3928 
3929 /// CompareReferenceRelationship - Compare the two types T1 and T2 to
3930 /// determine whether they are reference-related,
3931 /// reference-compatible, reference-compatible with added
3932 /// qualification, or incompatible, for use in C++ initialization by
3933 /// reference (C++ [dcl.ref.init]p4). Neither type can be a reference
3934 /// type, and the first type (T1) is the pointee type of the reference
3935 /// type being initialized.
3936 Sema::ReferenceCompareResult
3937 Sema::CompareReferenceRelationship(SourceLocation Loc,
3938                                    QualType OrigT1, QualType OrigT2,
3939                                    bool &DerivedToBase,
3940                                    bool &ObjCConversion,
3941                                    bool &ObjCLifetimeConversion) {
3942   assert(!OrigT1->isReferenceType() &&
3943     "T1 must be the pointee type of the reference type");
3944   assert(!OrigT2->isReferenceType() && "T2 cannot be a reference type");
3945 
3946   QualType T1 = Context.getCanonicalType(OrigT1);
3947   QualType T2 = Context.getCanonicalType(OrigT2);
3948   Qualifiers T1Quals, T2Quals;
3949   QualType UnqualT1 = Context.getUnqualifiedArrayType(T1, T1Quals);
3950   QualType UnqualT2 = Context.getUnqualifiedArrayType(T2, T2Quals);
3951 
3952   // C++ [dcl.init.ref]p4:
3953   //   Given types "cv1 T1" and "cv2 T2," "cv1 T1" is
3954   //   reference-related to "cv2 T2" if T1 is the same type as T2, or
3955   //   T1 is a base class of T2.
3956   DerivedToBase = false;
3957   ObjCConversion = false;
3958   ObjCLifetimeConversion = false;
3959   if (UnqualT1 == UnqualT2) {
3960     // Nothing to do.
3961   } else if (!RequireCompleteType(Loc, OrigT2, 0) &&
3962              isTypeValid(UnqualT1) && isTypeValid(UnqualT2) &&
3963              IsDerivedFrom(UnqualT2, UnqualT1))
3964     DerivedToBase = true;
3965   else if (UnqualT1->isObjCObjectOrInterfaceType() &&
3966            UnqualT2->isObjCObjectOrInterfaceType() &&
3967            Context.canBindObjCObjectType(UnqualT1, UnqualT2))
3968     ObjCConversion = true;
3969   else
3970     return Ref_Incompatible;
3971 
3972   // At this point, we know that T1 and T2 are reference-related (at
3973   // least).
3974 
3975   // If the type is an array type, promote the element qualifiers to the type
3976   // for comparison.
3977   if (isa<ArrayType>(T1) && T1Quals)
3978     T1 = Context.getQualifiedType(UnqualT1, T1Quals);
3979   if (isa<ArrayType>(T2) && T2Quals)
3980     T2 = Context.getQualifiedType(UnqualT2, T2Quals);
3981 
3982   // C++ [dcl.init.ref]p4:
3983   //   "cv1 T1" is reference-compatible with "cv2 T2" if T1 is
3984   //   reference-related to T2 and cv1 is the same cv-qualification
3985   //   as, or greater cv-qualification than, cv2. For purposes of
3986   //   overload resolution, cases for which cv1 is greater
3987   //   cv-qualification than cv2 are identified as
3988   //   reference-compatible with added qualification (see 13.3.3.2).
3989   //
3990   // Note that we also require equivalence of Objective-C GC and address-space
3991   // qualifiers when performing these computations, so that e.g., an int in
3992   // address space 1 is not reference-compatible with an int in address
3993   // space 2.
3994   if (T1Quals.getObjCLifetime() != T2Quals.getObjCLifetime() &&
3995       T1Quals.compatiblyIncludesObjCLifetime(T2Quals)) {
3996     T1Quals.removeObjCLifetime();
3997     T2Quals.removeObjCLifetime();
3998     ObjCLifetimeConversion = true;
3999   }
4000 
4001   if (T1Quals == T2Quals)
4002     return Ref_Compatible;
4003   else if (T1Quals.compatiblyIncludes(T2Quals))
4004     return Ref_Compatible_With_Added_Qualification;
4005   else
4006     return Ref_Related;
4007 }
4008 
4009 /// \brief Look for a user-defined conversion to an value reference-compatible
4010 ///        with DeclType. Return true if something definite is found.
4011 static bool
4012 FindConversionForRefInit(Sema &S, ImplicitConversionSequence &ICS,
4013                          QualType DeclType, SourceLocation DeclLoc,
4014                          Expr *Init, QualType T2, bool AllowRvalues,
4015                          bool AllowExplicit) {
4016   assert(T2->isRecordType() && "Can only find conversions of record types.");
4017   CXXRecordDecl *T2RecordDecl
4018     = dyn_cast<CXXRecordDecl>(T2->getAs<RecordType>()->getDecl());
4019 
4020   OverloadCandidateSet CandidateSet(DeclLoc);
4021   std::pair<CXXRecordDecl::conversion_iterator,
4022             CXXRecordDecl::conversion_iterator>
4023     Conversions = T2RecordDecl->getVisibleConversionFunctions();
4024   for (CXXRecordDecl::conversion_iterator
4025          I = Conversions.first, E = Conversions.second; I != E; ++I) {
4026     NamedDecl *D = *I;
4027     CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(D->getDeclContext());
4028     if (isa<UsingShadowDecl>(D))
4029       D = cast<UsingShadowDecl>(D)->getTargetDecl();
4030 
4031     FunctionTemplateDecl *ConvTemplate
4032       = dyn_cast<FunctionTemplateDecl>(D);
4033     CXXConversionDecl *Conv;
4034     if (ConvTemplate)
4035       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
4036     else
4037       Conv = cast<CXXConversionDecl>(D);
4038 
4039     // If this is an explicit conversion, and we're not allowed to consider
4040     // explicit conversions, skip it.
4041     if (!AllowExplicit && Conv->isExplicit())
4042       continue;
4043 
4044     if (AllowRvalues) {
4045       bool DerivedToBase = false;
4046       bool ObjCConversion = false;
4047       bool ObjCLifetimeConversion = false;
4048 
4049       // If we are initializing an rvalue reference, don't permit conversion
4050       // functions that return lvalues.
4051       if (!ConvTemplate && DeclType->isRValueReferenceType()) {
4052         const ReferenceType *RefType
4053           = Conv->getConversionType()->getAs<LValueReferenceType>();
4054         if (RefType && !RefType->getPointeeType()->isFunctionType())
4055           continue;
4056       }
4057 
4058       if (!ConvTemplate &&
4059           S.CompareReferenceRelationship(
4060             DeclLoc,
4061             Conv->getConversionType().getNonReferenceType()
4062               .getUnqualifiedType(),
4063             DeclType.getNonReferenceType().getUnqualifiedType(),
4064             DerivedToBase, ObjCConversion, ObjCLifetimeConversion) ==
4065           Sema::Ref_Incompatible)
4066         continue;
4067     } else {
4068       // If the conversion function doesn't return a reference type,
4069       // it can't be considered for this conversion. An rvalue reference
4070       // is only acceptable if its referencee is a function type.
4071 
4072       const ReferenceType *RefType =
4073         Conv->getConversionType()->getAs<ReferenceType>();
4074       if (!RefType ||
4075           (!RefType->isLValueReferenceType() &&
4076            !RefType->getPointeeType()->isFunctionType()))
4077         continue;
4078     }
4079 
4080     if (ConvTemplate)
4081       S.AddTemplateConversionCandidate(ConvTemplate, I.getPair(), ActingDC,
4082                                        Init, DeclType, CandidateSet);
4083     else
4084       S.AddConversionCandidate(Conv, I.getPair(), ActingDC, Init,
4085                                DeclType, CandidateSet);
4086   }
4087 
4088   bool HadMultipleCandidates = (CandidateSet.size() > 1);
4089 
4090   OverloadCandidateSet::iterator Best;
4091   switch (CandidateSet.BestViableFunction(S, DeclLoc, Best, true)) {
4092   case OR_Success:
4093     // C++ [over.ics.ref]p1:
4094     //
4095     //   [...] If the parameter binds directly to the result of
4096     //   applying a conversion function to the argument
4097     //   expression, the implicit conversion sequence is a
4098     //   user-defined conversion sequence (13.3.3.1.2), with the
4099     //   second standard conversion sequence either an identity
4100     //   conversion or, if the conversion function returns an
4101     //   entity of a type that is a derived class of the parameter
4102     //   type, a derived-to-base Conversion.
4103     if (!Best->FinalConversion.DirectBinding)
4104       return false;
4105 
4106     ICS.setUserDefined();
4107     ICS.UserDefined.Before = Best->Conversions[0].Standard;
4108     ICS.UserDefined.After = Best->FinalConversion;
4109     ICS.UserDefined.HadMultipleCandidates = HadMultipleCandidates;
4110     ICS.UserDefined.ConversionFunction = Best->Function;
4111     ICS.UserDefined.FoundConversionFunction = Best->FoundDecl;
4112     ICS.UserDefined.EllipsisConversion = false;
4113     assert(ICS.UserDefined.After.ReferenceBinding &&
4114            ICS.UserDefined.After.DirectBinding &&
4115            "Expected a direct reference binding!");
4116     return true;
4117 
4118   case OR_Ambiguous:
4119     ICS.setAmbiguous();
4120     for (OverloadCandidateSet::iterator Cand = CandidateSet.begin();
4121          Cand != CandidateSet.end(); ++Cand)
4122       if (Cand->Viable)
4123         ICS.Ambiguous.addConversion(Cand->Function);
4124     return true;
4125 
4126   case OR_No_Viable_Function:
4127   case OR_Deleted:
4128     // There was no suitable conversion, or we found a deleted
4129     // conversion; continue with other checks.
4130     return false;
4131   }
4132 
4133   llvm_unreachable("Invalid OverloadResult!");
4134 }
4135 
4136 /// \brief Compute an implicit conversion sequence for reference
4137 /// initialization.
4138 static ImplicitConversionSequence
4139 TryReferenceInit(Sema &S, Expr *Init, QualType DeclType,
4140                  SourceLocation DeclLoc,
4141                  bool SuppressUserConversions,
4142                  bool AllowExplicit) {
4143   assert(DeclType->isReferenceType() && "Reference init needs a reference");
4144 
4145   // Most paths end in a failed conversion.
4146   ImplicitConversionSequence ICS;
4147   ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4148 
4149   QualType T1 = DeclType->getAs<ReferenceType>()->getPointeeType();
4150   QualType T2 = Init->getType();
4151 
4152   // If the initializer is the address of an overloaded function, try
4153   // to resolve the overloaded function. If all goes well, T2 is the
4154   // type of the resulting function.
4155   if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4156     DeclAccessPair Found;
4157     if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(Init, DeclType,
4158                                                                 false, Found))
4159       T2 = Fn->getType();
4160   }
4161 
4162   // Compute some basic properties of the types and the initializer.
4163   bool isRValRef = DeclType->isRValueReferenceType();
4164   bool DerivedToBase = false;
4165   bool ObjCConversion = false;
4166   bool ObjCLifetimeConversion = false;
4167   Expr::Classification InitCategory = Init->Classify(S.Context);
4168   Sema::ReferenceCompareResult RefRelationship
4169     = S.CompareReferenceRelationship(DeclLoc, T1, T2, DerivedToBase,
4170                                      ObjCConversion, ObjCLifetimeConversion);
4171 
4172 
4173   // C++0x [dcl.init.ref]p5:
4174   //   A reference to type "cv1 T1" is initialized by an expression
4175   //   of type "cv2 T2" as follows:
4176 
4177   //     -- If reference is an lvalue reference and the initializer expression
4178   if (!isRValRef) {
4179     //     -- is an lvalue (but is not a bit-field), and "cv1 T1" is
4180     //        reference-compatible with "cv2 T2," or
4181     //
4182     // Per C++ [over.ics.ref]p4, we don't check the bit-field property here.
4183     if (InitCategory.isLValue() &&
4184         RefRelationship >= Sema::Ref_Compatible_With_Added_Qualification) {
4185       // C++ [over.ics.ref]p1:
4186       //   When a parameter of reference type binds directly (8.5.3)
4187       //   to an argument expression, the implicit conversion sequence
4188       //   is the identity conversion, unless the argument expression
4189       //   has a type that is a derived class of the parameter type,
4190       //   in which case the implicit conversion sequence is a
4191       //   derived-to-base Conversion (13.3.3.1).
4192       ICS.setStandard();
4193       ICS.Standard.First = ICK_Identity;
4194       ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4195                          : ObjCConversion? ICK_Compatible_Conversion
4196                          : ICK_Identity;
4197       ICS.Standard.Third = ICK_Identity;
4198       ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4199       ICS.Standard.setToType(0, T2);
4200       ICS.Standard.setToType(1, T1);
4201       ICS.Standard.setToType(2, T1);
4202       ICS.Standard.ReferenceBinding = true;
4203       ICS.Standard.DirectBinding = true;
4204       ICS.Standard.IsLvalueReference = !isRValRef;
4205       ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4206       ICS.Standard.BindsToRvalue = false;
4207       ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4208       ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4209       ICS.Standard.CopyConstructor = 0;
4210 
4211       // Nothing more to do: the inaccessibility/ambiguity check for
4212       // derived-to-base conversions is suppressed when we're
4213       // computing the implicit conversion sequence (C++
4214       // [over.best.ics]p2).
4215       return ICS;
4216     }
4217 
4218     //       -- has a class type (i.e., T2 is a class type), where T1 is
4219     //          not reference-related to T2, and can be implicitly
4220     //          converted to an lvalue of type "cv3 T3," where "cv1 T1"
4221     //          is reference-compatible with "cv3 T3" 92) (this
4222     //          conversion is selected by enumerating the applicable
4223     //          conversion functions (13.3.1.6) and choosing the best
4224     //          one through overload resolution (13.3)),
4225     if (!SuppressUserConversions && T2->isRecordType() &&
4226         !S.RequireCompleteType(DeclLoc, T2, 0) &&
4227         RefRelationship == Sema::Ref_Incompatible) {
4228       if (FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4229                                    Init, T2, /*AllowRvalues=*/false,
4230                                    AllowExplicit))
4231         return ICS;
4232     }
4233   }
4234 
4235   //     -- Otherwise, the reference shall be an lvalue reference to a
4236   //        non-volatile const type (i.e., cv1 shall be const), or the reference
4237   //        shall be an rvalue reference.
4238   //
4239   // We actually handle one oddity of C++ [over.ics.ref] at this
4240   // point, which is that, due to p2 (which short-circuits reference
4241   // binding by only attempting a simple conversion for non-direct
4242   // bindings) and p3's strange wording, we allow a const volatile
4243   // reference to bind to an rvalue. Hence the check for the presence
4244   // of "const" rather than checking for "const" being the only
4245   // qualifier.
4246   // This is also the point where rvalue references and lvalue inits no longer
4247   // go together.
4248   if (!isRValRef && (!T1.isConstQualified() || T1.isVolatileQualified()))
4249     return ICS;
4250 
4251   //       -- If the initializer expression
4252   //
4253   //            -- is an xvalue, class prvalue, array prvalue or function
4254   //               lvalue and "cv1 T1" is reference-compatible with "cv2 T2", or
4255   if (RefRelationship >= Sema::Ref_Compatible_With_Added_Qualification &&
4256       (InitCategory.isXValue() ||
4257       (InitCategory.isPRValue() && (T2->isRecordType() || T2->isArrayType())) ||
4258       (InitCategory.isLValue() && T2->isFunctionType()))) {
4259     ICS.setStandard();
4260     ICS.Standard.First = ICK_Identity;
4261     ICS.Standard.Second = DerivedToBase? ICK_Derived_To_Base
4262                       : ObjCConversion? ICK_Compatible_Conversion
4263                       : ICK_Identity;
4264     ICS.Standard.Third = ICK_Identity;
4265     ICS.Standard.FromTypePtr = T2.getAsOpaquePtr();
4266     ICS.Standard.setToType(0, T2);
4267     ICS.Standard.setToType(1, T1);
4268     ICS.Standard.setToType(2, T1);
4269     ICS.Standard.ReferenceBinding = true;
4270     // In C++0x, this is always a direct binding. In C++98/03, it's a direct
4271     // binding unless we're binding to a class prvalue.
4272     // Note: Although xvalues wouldn't normally show up in C++98/03 code, we
4273     // allow the use of rvalue references in C++98/03 for the benefit of
4274     // standard library implementors; therefore, we need the xvalue check here.
4275     ICS.Standard.DirectBinding =
4276       S.getLangOpts().CPlusPlus11 ||
4277       (InitCategory.isPRValue() && !T2->isRecordType());
4278     ICS.Standard.IsLvalueReference = !isRValRef;
4279     ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4280     ICS.Standard.BindsToRvalue = InitCategory.isRValue();
4281     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4282     ICS.Standard.ObjCLifetimeConversionBinding = ObjCLifetimeConversion;
4283     ICS.Standard.CopyConstructor = 0;
4284     return ICS;
4285   }
4286 
4287   //            -- has a class type (i.e., T2 is a class type), where T1 is not
4288   //               reference-related to T2, and can be implicitly converted to
4289   //               an xvalue, class prvalue, or function lvalue of type
4290   //               "cv3 T3", where "cv1 T1" is reference-compatible with
4291   //               "cv3 T3",
4292   //
4293   //          then the reference is bound to the value of the initializer
4294   //          expression in the first case and to the result of the conversion
4295   //          in the second case (or, in either case, to an appropriate base
4296   //          class subobject).
4297   if (!SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4298       T2->isRecordType() && !S.RequireCompleteType(DeclLoc, T2, 0) &&
4299       FindConversionForRefInit(S, ICS, DeclType, DeclLoc,
4300                                Init, T2, /*AllowRvalues=*/true,
4301                                AllowExplicit)) {
4302     // In the second case, if the reference is an rvalue reference
4303     // and the second standard conversion sequence of the
4304     // user-defined conversion sequence includes an lvalue-to-rvalue
4305     // conversion, the program is ill-formed.
4306     if (ICS.isUserDefined() && isRValRef &&
4307         ICS.UserDefined.After.First == ICK_Lvalue_To_Rvalue)
4308       ICS.setBad(BadConversionSequence::no_conversion, Init, DeclType);
4309 
4310     return ICS;
4311   }
4312 
4313   //       -- Otherwise, a temporary of type "cv1 T1" is created and
4314   //          initialized from the initializer expression using the
4315   //          rules for a non-reference copy initialization (8.5). The
4316   //          reference is then bound to the temporary. If T1 is
4317   //          reference-related to T2, cv1 must be the same
4318   //          cv-qualification as, or greater cv-qualification than,
4319   //          cv2; otherwise, the program is ill-formed.
4320   if (RefRelationship == Sema::Ref_Related) {
4321     // If cv1 == cv2 or cv1 is a greater cv-qualified than cv2, then
4322     // we would be reference-compatible or reference-compatible with
4323     // added qualification. But that wasn't the case, so the reference
4324     // initialization fails.
4325     //
4326     // Note that we only want to check address spaces and cvr-qualifiers here.
4327     // ObjC GC and lifetime qualifiers aren't important.
4328     Qualifiers T1Quals = T1.getQualifiers();
4329     Qualifiers T2Quals = T2.getQualifiers();
4330     T1Quals.removeObjCGCAttr();
4331     T1Quals.removeObjCLifetime();
4332     T2Quals.removeObjCGCAttr();
4333     T2Quals.removeObjCLifetime();
4334     if (!T1Quals.compatiblyIncludes(T2Quals))
4335       return ICS;
4336   }
4337 
4338   // If at least one of the types is a class type, the types are not
4339   // related, and we aren't allowed any user conversions, the
4340   // reference binding fails. This case is important for breaking
4341   // recursion, since TryImplicitConversion below will attempt to
4342   // create a temporary through the use of a copy constructor.
4343   if (SuppressUserConversions && RefRelationship == Sema::Ref_Incompatible &&
4344       (T1->isRecordType() || T2->isRecordType()))
4345     return ICS;
4346 
4347   // If T1 is reference-related to T2 and the reference is an rvalue
4348   // reference, the initializer expression shall not be an lvalue.
4349   if (RefRelationship >= Sema::Ref_Related &&
4350       isRValRef && Init->Classify(S.Context).isLValue())
4351     return ICS;
4352 
4353   // C++ [over.ics.ref]p2:
4354   //   When a parameter of reference type is not bound directly to
4355   //   an argument expression, the conversion sequence is the one
4356   //   required to convert the argument expression to the
4357   //   underlying type of the reference according to
4358   //   13.3.3.1. Conceptually, this conversion sequence corresponds
4359   //   to copy-initializing a temporary of the underlying type with
4360   //   the argument expression. Any difference in top-level
4361   //   cv-qualification is subsumed by the initialization itself
4362   //   and does not constitute a conversion.
4363   ICS = TryImplicitConversion(S, Init, T1, SuppressUserConversions,
4364                               /*AllowExplicit=*/false,
4365                               /*InOverloadResolution=*/false,
4366                               /*CStyle=*/false,
4367                               /*AllowObjCWritebackConversion=*/false);
4368 
4369   // Of course, that's still a reference binding.
4370   if (ICS.isStandard()) {
4371     ICS.Standard.ReferenceBinding = true;
4372     ICS.Standard.IsLvalueReference = !isRValRef;
4373     ICS.Standard.BindsToFunctionLvalue = T2->isFunctionType();
4374     ICS.Standard.BindsToRvalue = true;
4375     ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4376     ICS.Standard.ObjCLifetimeConversionBinding = false;
4377   } else if (ICS.isUserDefined()) {
4378     // Don't allow rvalue references to bind to lvalues.
4379     if (DeclType->isRValueReferenceType()) {
4380       if (const ReferenceType *RefType
4381             = ICS.UserDefined.ConversionFunction->getResultType()
4382                 ->getAs<LValueReferenceType>()) {
4383         if (!RefType->getPointeeType()->isFunctionType()) {
4384           ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, Init,
4385                      DeclType);
4386           return ICS;
4387         }
4388       }
4389     }
4390 
4391     ICS.UserDefined.After.ReferenceBinding = true;
4392     ICS.UserDefined.After.IsLvalueReference = !isRValRef;
4393     ICS.UserDefined.After.BindsToFunctionLvalue = T2->isFunctionType();
4394     ICS.UserDefined.After.BindsToRvalue = true;
4395     ICS.UserDefined.After.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4396     ICS.UserDefined.After.ObjCLifetimeConversionBinding = false;
4397   }
4398 
4399   return ICS;
4400 }
4401 
4402 static ImplicitConversionSequence
4403 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4404                       bool SuppressUserConversions,
4405                       bool InOverloadResolution,
4406                       bool AllowObjCWritebackConversion,
4407                       bool AllowExplicit = false);
4408 
4409 /// TryListConversion - Try to copy-initialize a value of type ToType from the
4410 /// initializer list From.
4411 static ImplicitConversionSequence
4412 TryListConversion(Sema &S, InitListExpr *From, QualType ToType,
4413                   bool SuppressUserConversions,
4414                   bool InOverloadResolution,
4415                   bool AllowObjCWritebackConversion) {
4416   // C++11 [over.ics.list]p1:
4417   //   When an argument is an initializer list, it is not an expression and
4418   //   special rules apply for converting it to a parameter type.
4419 
4420   ImplicitConversionSequence Result;
4421   Result.setBad(BadConversionSequence::no_conversion, From, ToType);
4422   Result.setListInitializationSequence();
4423 
4424   // We need a complete type for what follows. Incomplete types can never be
4425   // initialized from init lists.
4426   if (S.RequireCompleteType(From->getLocStart(), ToType, 0))
4427     return Result;
4428 
4429   // C++11 [over.ics.list]p2:
4430   //   If the parameter type is std::initializer_list<X> or "array of X" and
4431   //   all the elements can be implicitly converted to X, the implicit
4432   //   conversion sequence is the worst conversion necessary to convert an
4433   //   element of the list to X.
4434   bool toStdInitializerList = false;
4435   QualType X;
4436   if (ToType->isArrayType())
4437     X = S.Context.getAsArrayType(ToType)->getElementType();
4438   else
4439     toStdInitializerList = S.isStdInitializerList(ToType, &X);
4440   if (!X.isNull()) {
4441     for (unsigned i = 0, e = From->getNumInits(); i < e; ++i) {
4442       Expr *Init = From->getInit(i);
4443       ImplicitConversionSequence ICS =
4444           TryCopyInitialization(S, Init, X, SuppressUserConversions,
4445                                 InOverloadResolution,
4446                                 AllowObjCWritebackConversion);
4447       // If a single element isn't convertible, fail.
4448       if (ICS.isBad()) {
4449         Result = ICS;
4450         break;
4451       }
4452       // Otherwise, look for the worst conversion.
4453       if (Result.isBad() ||
4454           CompareImplicitConversionSequences(S, ICS, Result) ==
4455               ImplicitConversionSequence::Worse)
4456         Result = ICS;
4457     }
4458 
4459     // For an empty list, we won't have computed any conversion sequence.
4460     // Introduce the identity conversion sequence.
4461     if (From->getNumInits() == 0) {
4462       Result.setStandard();
4463       Result.Standard.setAsIdentityConversion();
4464       Result.Standard.setFromType(ToType);
4465       Result.Standard.setAllToTypes(ToType);
4466     }
4467 
4468     Result.setListInitializationSequence();
4469     Result.setStdInitializerListElement(toStdInitializerList);
4470     return Result;
4471   }
4472 
4473   // C++11 [over.ics.list]p3:
4474   //   Otherwise, if the parameter is a non-aggregate class X and overload
4475   //   resolution chooses a single best constructor [...] the implicit
4476   //   conversion sequence is a user-defined conversion sequence. If multiple
4477   //   constructors are viable but none is better than the others, the
4478   //   implicit conversion sequence is a user-defined conversion sequence.
4479   if (ToType->isRecordType() && !ToType->isAggregateType()) {
4480     // This function can deal with initializer lists.
4481     Result = TryUserDefinedConversion(S, From, ToType, SuppressUserConversions,
4482                                       /*AllowExplicit=*/false,
4483                                       InOverloadResolution, /*CStyle=*/false,
4484                                       AllowObjCWritebackConversion);
4485     Result.setListInitializationSequence();
4486     return Result;
4487   }
4488 
4489   // C++11 [over.ics.list]p4:
4490   //   Otherwise, if the parameter has an aggregate type which can be
4491   //   initialized from the initializer list [...] the implicit conversion
4492   //   sequence is a user-defined conversion sequence.
4493   if (ToType->isAggregateType()) {
4494     // Type is an aggregate, argument is an init list. At this point it comes
4495     // down to checking whether the initialization works.
4496     // FIXME: Find out whether this parameter is consumed or not.
4497     InitializedEntity Entity =
4498         InitializedEntity::InitializeParameter(S.Context, ToType,
4499                                                /*Consumed=*/false);
4500     if (S.CanPerformCopyInitialization(Entity, S.Owned(From))) {
4501       Result.setUserDefined();
4502       Result.UserDefined.Before.setAsIdentityConversion();
4503       // Initializer lists don't have a type.
4504       Result.UserDefined.Before.setFromType(QualType());
4505       Result.UserDefined.Before.setAllToTypes(QualType());
4506 
4507       Result.UserDefined.After.setAsIdentityConversion();
4508       Result.UserDefined.After.setFromType(ToType);
4509       Result.UserDefined.After.setAllToTypes(ToType);
4510       Result.UserDefined.ConversionFunction = 0;
4511     }
4512     return Result;
4513   }
4514 
4515   // C++11 [over.ics.list]p5:
4516   //   Otherwise, if the parameter is a reference, see 13.3.3.1.4.
4517   if (ToType->isReferenceType()) {
4518     // The standard is notoriously unclear here, since 13.3.3.1.4 doesn't
4519     // mention initializer lists in any way. So we go by what list-
4520     // initialization would do and try to extrapolate from that.
4521 
4522     QualType T1 = ToType->getAs<ReferenceType>()->getPointeeType();
4523 
4524     // If the initializer list has a single element that is reference-related
4525     // to the parameter type, we initialize the reference from that.
4526     if (From->getNumInits() == 1) {
4527       Expr *Init = From->getInit(0);
4528 
4529       QualType T2 = Init->getType();
4530 
4531       // If the initializer is the address of an overloaded function, try
4532       // to resolve the overloaded function. If all goes well, T2 is the
4533       // type of the resulting function.
4534       if (S.Context.getCanonicalType(T2) == S.Context.OverloadTy) {
4535         DeclAccessPair Found;
4536         if (FunctionDecl *Fn = S.ResolveAddressOfOverloadedFunction(
4537                                    Init, ToType, false, Found))
4538           T2 = Fn->getType();
4539       }
4540 
4541       // Compute some basic properties of the types and the initializer.
4542       bool dummy1 = false;
4543       bool dummy2 = false;
4544       bool dummy3 = false;
4545       Sema::ReferenceCompareResult RefRelationship
4546         = S.CompareReferenceRelationship(From->getLocStart(), T1, T2, dummy1,
4547                                          dummy2, dummy3);
4548 
4549       if (RefRelationship >= Sema::Ref_Related)
4550         return TryReferenceInit(S, Init, ToType,
4551                                 /*FIXME:*/From->getLocStart(),
4552                                 SuppressUserConversions,
4553                                 /*AllowExplicit=*/false);
4554     }
4555 
4556     // Otherwise, we bind the reference to a temporary created from the
4557     // initializer list.
4558     Result = TryListConversion(S, From, T1, SuppressUserConversions,
4559                                InOverloadResolution,
4560                                AllowObjCWritebackConversion);
4561     if (Result.isFailure())
4562       return Result;
4563     assert(!Result.isEllipsis() &&
4564            "Sub-initialization cannot result in ellipsis conversion.");
4565 
4566     // Can we even bind to a temporary?
4567     if (ToType->isRValueReferenceType() ||
4568         (T1.isConstQualified() && !T1.isVolatileQualified())) {
4569       StandardConversionSequence &SCS = Result.isStandard() ? Result.Standard :
4570                                             Result.UserDefined.After;
4571       SCS.ReferenceBinding = true;
4572       SCS.IsLvalueReference = ToType->isLValueReferenceType();
4573       SCS.BindsToRvalue = true;
4574       SCS.BindsToFunctionLvalue = false;
4575       SCS.BindsImplicitObjectArgumentWithoutRefQualifier = false;
4576       SCS.ObjCLifetimeConversionBinding = false;
4577     } else
4578       Result.setBad(BadConversionSequence::lvalue_ref_to_rvalue,
4579                     From, ToType);
4580     return Result;
4581   }
4582 
4583   // C++11 [over.ics.list]p6:
4584   //   Otherwise, if the parameter type is not a class:
4585   if (!ToType->isRecordType()) {
4586     //    - if the initializer list has one element, the implicit conversion
4587     //      sequence is the one required to convert the element to the
4588     //      parameter type.
4589     unsigned NumInits = From->getNumInits();
4590     if (NumInits == 1)
4591       Result = TryCopyInitialization(S, From->getInit(0), ToType,
4592                                      SuppressUserConversions,
4593                                      InOverloadResolution,
4594                                      AllowObjCWritebackConversion);
4595     //    - if the initializer list has no elements, the implicit conversion
4596     //      sequence is the identity conversion.
4597     else if (NumInits == 0) {
4598       Result.setStandard();
4599       Result.Standard.setAsIdentityConversion();
4600       Result.Standard.setFromType(ToType);
4601       Result.Standard.setAllToTypes(ToType);
4602     }
4603     Result.setListInitializationSequence();
4604     return Result;
4605   }
4606 
4607   // C++11 [over.ics.list]p7:
4608   //   In all cases other than those enumerated above, no conversion is possible
4609   return Result;
4610 }
4611 
4612 /// TryCopyInitialization - Try to copy-initialize a value of type
4613 /// ToType from the expression From. Return the implicit conversion
4614 /// sequence required to pass this argument, which may be a bad
4615 /// conversion sequence (meaning that the argument cannot be passed to
4616 /// a parameter of this type). If @p SuppressUserConversions, then we
4617 /// do not permit any user-defined conversion sequences.
4618 static ImplicitConversionSequence
4619 TryCopyInitialization(Sema &S, Expr *From, QualType ToType,
4620                       bool SuppressUserConversions,
4621                       bool InOverloadResolution,
4622                       bool AllowObjCWritebackConversion,
4623                       bool AllowExplicit) {
4624   if (InitListExpr *FromInitList = dyn_cast<InitListExpr>(From))
4625     return TryListConversion(S, FromInitList, ToType, SuppressUserConversions,
4626                              InOverloadResolution,AllowObjCWritebackConversion);
4627 
4628   if (ToType->isReferenceType())
4629     return TryReferenceInit(S, From, ToType,
4630                             /*FIXME:*/From->getLocStart(),
4631                             SuppressUserConversions,
4632                             AllowExplicit);
4633 
4634   return TryImplicitConversion(S, From, ToType,
4635                                SuppressUserConversions,
4636                                /*AllowExplicit=*/false,
4637                                InOverloadResolution,
4638                                /*CStyle=*/false,
4639                                AllowObjCWritebackConversion);
4640 }
4641 
4642 static bool TryCopyInitialization(const CanQualType FromQTy,
4643                                   const CanQualType ToQTy,
4644                                   Sema &S,
4645                                   SourceLocation Loc,
4646                                   ExprValueKind FromVK) {
4647   OpaqueValueExpr TmpExpr(Loc, FromQTy, FromVK);
4648   ImplicitConversionSequence ICS =
4649     TryCopyInitialization(S, &TmpExpr, ToQTy, true, true, false);
4650 
4651   return !ICS.isBad();
4652 }
4653 
4654 /// TryObjectArgumentInitialization - Try to initialize the object
4655 /// parameter of the given member function (@c Method) from the
4656 /// expression @p From.
4657 static ImplicitConversionSequence
4658 TryObjectArgumentInitialization(Sema &S, QualType FromType,
4659                                 Expr::Classification FromClassification,
4660                                 CXXMethodDecl *Method,
4661                                 CXXRecordDecl *ActingContext) {
4662   QualType ClassType = S.Context.getTypeDeclType(ActingContext);
4663   // [class.dtor]p2: A destructor can be invoked for a const, volatile or
4664   //                 const volatile object.
4665   unsigned Quals = isa<CXXDestructorDecl>(Method) ?
4666     Qualifiers::Const | Qualifiers::Volatile : Method->getTypeQualifiers();
4667   QualType ImplicitParamType =  S.Context.getCVRQualifiedType(ClassType, Quals);
4668 
4669   // Set up the conversion sequence as a "bad" conversion, to allow us
4670   // to exit early.
4671   ImplicitConversionSequence ICS;
4672 
4673   // We need to have an object of class type.
4674   if (const PointerType *PT = FromType->getAs<PointerType>()) {
4675     FromType = PT->getPointeeType();
4676 
4677     // When we had a pointer, it's implicitly dereferenced, so we
4678     // better have an lvalue.
4679     assert(FromClassification.isLValue());
4680   }
4681 
4682   assert(FromType->isRecordType());
4683 
4684   // C++0x [over.match.funcs]p4:
4685   //   For non-static member functions, the type of the implicit object
4686   //   parameter is
4687   //
4688   //     - "lvalue reference to cv X" for functions declared without a
4689   //        ref-qualifier or with the & ref-qualifier
4690   //     - "rvalue reference to cv X" for functions declared with the &&
4691   //        ref-qualifier
4692   //
4693   // where X is the class of which the function is a member and cv is the
4694   // cv-qualification on the member function declaration.
4695   //
4696   // However, when finding an implicit conversion sequence for the argument, we
4697   // are not allowed to create temporaries or perform user-defined conversions
4698   // (C++ [over.match.funcs]p5). We perform a simplified version of
4699   // reference binding here, that allows class rvalues to bind to
4700   // non-constant references.
4701 
4702   // First check the qualifiers.
4703   QualType FromTypeCanon = S.Context.getCanonicalType(FromType);
4704   if (ImplicitParamType.getCVRQualifiers()
4705                                     != FromTypeCanon.getLocalCVRQualifiers() &&
4706       !ImplicitParamType.isAtLeastAsQualifiedAs(FromTypeCanon)) {
4707     ICS.setBad(BadConversionSequence::bad_qualifiers,
4708                FromType, ImplicitParamType);
4709     return ICS;
4710   }
4711 
4712   // Check that we have either the same type or a derived type. It
4713   // affects the conversion rank.
4714   QualType ClassTypeCanon = S.Context.getCanonicalType(ClassType);
4715   ImplicitConversionKind SecondKind;
4716   if (ClassTypeCanon == FromTypeCanon.getLocalUnqualifiedType()) {
4717     SecondKind = ICK_Identity;
4718   } else if (S.IsDerivedFrom(FromType, ClassType))
4719     SecondKind = ICK_Derived_To_Base;
4720   else {
4721     ICS.setBad(BadConversionSequence::unrelated_class,
4722                FromType, ImplicitParamType);
4723     return ICS;
4724   }
4725 
4726   // Check the ref-qualifier.
4727   switch (Method->getRefQualifier()) {
4728   case RQ_None:
4729     // Do nothing; we don't care about lvalueness or rvalueness.
4730     break;
4731 
4732   case RQ_LValue:
4733     if (!FromClassification.isLValue() && Quals != Qualifiers::Const) {
4734       // non-const lvalue reference cannot bind to an rvalue
4735       ICS.setBad(BadConversionSequence::lvalue_ref_to_rvalue, FromType,
4736                  ImplicitParamType);
4737       return ICS;
4738     }
4739     break;
4740 
4741   case RQ_RValue:
4742     if (!FromClassification.isRValue()) {
4743       // rvalue reference cannot bind to an lvalue
4744       ICS.setBad(BadConversionSequence::rvalue_ref_to_lvalue, FromType,
4745                  ImplicitParamType);
4746       return ICS;
4747     }
4748     break;
4749   }
4750 
4751   // Success. Mark this as a reference binding.
4752   ICS.setStandard();
4753   ICS.Standard.setAsIdentityConversion();
4754   ICS.Standard.Second = SecondKind;
4755   ICS.Standard.setFromType(FromType);
4756   ICS.Standard.setAllToTypes(ImplicitParamType);
4757   ICS.Standard.ReferenceBinding = true;
4758   ICS.Standard.DirectBinding = true;
4759   ICS.Standard.IsLvalueReference = Method->getRefQualifier() != RQ_RValue;
4760   ICS.Standard.BindsToFunctionLvalue = false;
4761   ICS.Standard.BindsToRvalue = FromClassification.isRValue();
4762   ICS.Standard.BindsImplicitObjectArgumentWithoutRefQualifier
4763     = (Method->getRefQualifier() == RQ_None);
4764   return ICS;
4765 }
4766 
4767 /// PerformObjectArgumentInitialization - Perform initialization of
4768 /// the implicit object parameter for the given Method with the given
4769 /// expression.
4770 ExprResult
4771 Sema::PerformObjectArgumentInitialization(Expr *From,
4772                                           NestedNameSpecifier *Qualifier,
4773                                           NamedDecl *FoundDecl,
4774                                           CXXMethodDecl *Method) {
4775   QualType FromRecordType, DestType;
4776   QualType ImplicitParamRecordType  =
4777     Method->getThisType(Context)->getAs<PointerType>()->getPointeeType();
4778 
4779   Expr::Classification FromClassification;
4780   if (const PointerType *PT = From->getType()->getAs<PointerType>()) {
4781     FromRecordType = PT->getPointeeType();
4782     DestType = Method->getThisType(Context);
4783     FromClassification = Expr::Classification::makeSimpleLValue();
4784   } else {
4785     FromRecordType = From->getType();
4786     DestType = ImplicitParamRecordType;
4787     FromClassification = From->Classify(Context);
4788   }
4789 
4790   // Note that we always use the true parent context when performing
4791   // the actual argument initialization.
4792   ImplicitConversionSequence ICS
4793     = TryObjectArgumentInitialization(*this, From->getType(), FromClassification,
4794                                       Method, Method->getParent());
4795   if (ICS.isBad()) {
4796     if (ICS.Bad.Kind == BadConversionSequence::bad_qualifiers) {
4797       Qualifiers FromQs = FromRecordType.getQualifiers();
4798       Qualifiers ToQs = DestType.getQualifiers();
4799       unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
4800       if (CVR) {
4801         Diag(From->getLocStart(),
4802              diag::err_member_function_call_bad_cvr)
4803           << Method->getDeclName() << FromRecordType << (CVR - 1)
4804           << From->getSourceRange();
4805         Diag(Method->getLocation(), diag::note_previous_decl)
4806           << Method->getDeclName();
4807         return ExprError();
4808       }
4809     }
4810 
4811     return Diag(From->getLocStart(),
4812                 diag::err_implicit_object_parameter_init)
4813        << ImplicitParamRecordType << FromRecordType << From->getSourceRange();
4814   }
4815 
4816   if (ICS.Standard.Second == ICK_Derived_To_Base) {
4817     ExprResult FromRes =
4818       PerformObjectMemberConversion(From, Qualifier, FoundDecl, Method);
4819     if (FromRes.isInvalid())
4820       return ExprError();
4821     From = FromRes.take();
4822   }
4823 
4824   if (!Context.hasSameType(From->getType(), DestType))
4825     From = ImpCastExprToType(From, DestType, CK_NoOp,
4826                              From->getValueKind()).take();
4827   return Owned(From);
4828 }
4829 
4830 /// TryContextuallyConvertToBool - Attempt to contextually convert the
4831 /// expression From to bool (C++0x [conv]p3).
4832 static ImplicitConversionSequence
4833 TryContextuallyConvertToBool(Sema &S, Expr *From) {
4834   // FIXME: This is pretty broken.
4835   return TryImplicitConversion(S, From, S.Context.BoolTy,
4836                                // FIXME: Are these flags correct?
4837                                /*SuppressUserConversions=*/false,
4838                                /*AllowExplicit=*/true,
4839                                /*InOverloadResolution=*/false,
4840                                /*CStyle=*/false,
4841                                /*AllowObjCWritebackConversion=*/false);
4842 }
4843 
4844 /// PerformContextuallyConvertToBool - Perform a contextual conversion
4845 /// of the expression From to bool (C++0x [conv]p3).
4846 ExprResult Sema::PerformContextuallyConvertToBool(Expr *From) {
4847   if (checkPlaceholderForOverload(*this, From))
4848     return ExprError();
4849 
4850   ImplicitConversionSequence ICS = TryContextuallyConvertToBool(*this, From);
4851   if (!ICS.isBad())
4852     return PerformImplicitConversion(From, Context.BoolTy, ICS, AA_Converting);
4853 
4854   if (!DiagnoseMultipleUserDefinedConversion(From, Context.BoolTy))
4855     return Diag(From->getLocStart(),
4856                 diag::err_typecheck_bool_condition)
4857                   << From->getType() << From->getSourceRange();
4858   return ExprError();
4859 }
4860 
4861 /// Check that the specified conversion is permitted in a converted constant
4862 /// expression, according to C++11 [expr.const]p3. Return true if the conversion
4863 /// is acceptable.
4864 static bool CheckConvertedConstantConversions(Sema &S,
4865                                               StandardConversionSequence &SCS) {
4866   // Since we know that the target type is an integral or unscoped enumeration
4867   // type, most conversion kinds are impossible. All possible First and Third
4868   // conversions are fine.
4869   switch (SCS.Second) {
4870   case ICK_Identity:
4871   case ICK_Integral_Promotion:
4872   case ICK_Integral_Conversion:
4873   case ICK_Zero_Event_Conversion:
4874     return true;
4875 
4876   case ICK_Boolean_Conversion:
4877     // Conversion from an integral or unscoped enumeration type to bool is
4878     // classified as ICK_Boolean_Conversion, but it's also an integral
4879     // conversion, so it's permitted in a converted constant expression.
4880     return SCS.getFromType()->isIntegralOrUnscopedEnumerationType() &&
4881            SCS.getToType(2)->isBooleanType();
4882 
4883   case ICK_Floating_Integral:
4884   case ICK_Complex_Real:
4885     return false;
4886 
4887   case ICK_Lvalue_To_Rvalue:
4888   case ICK_Array_To_Pointer:
4889   case ICK_Function_To_Pointer:
4890   case ICK_NoReturn_Adjustment:
4891   case ICK_Qualification:
4892   case ICK_Compatible_Conversion:
4893   case ICK_Vector_Conversion:
4894   case ICK_Vector_Splat:
4895   case ICK_Derived_To_Base:
4896   case ICK_Pointer_Conversion:
4897   case ICK_Pointer_Member:
4898   case ICK_Block_Pointer_Conversion:
4899   case ICK_Writeback_Conversion:
4900   case ICK_Floating_Promotion:
4901   case ICK_Complex_Promotion:
4902   case ICK_Complex_Conversion:
4903   case ICK_Floating_Conversion:
4904   case ICK_TransparentUnionConversion:
4905     llvm_unreachable("unexpected second conversion kind");
4906 
4907   case ICK_Num_Conversion_Kinds:
4908     break;
4909   }
4910 
4911   llvm_unreachable("unknown conversion kind");
4912 }
4913 
4914 /// CheckConvertedConstantExpression - Check that the expression From is a
4915 /// converted constant expression of type T, perform the conversion and produce
4916 /// the converted expression, per C++11 [expr.const]p3.
4917 ExprResult Sema::CheckConvertedConstantExpression(Expr *From, QualType T,
4918                                                   llvm::APSInt &Value,
4919                                                   CCEKind CCE) {
4920   assert(LangOpts.CPlusPlus11 && "converted constant expression outside C++11");
4921   assert(T->isIntegralOrEnumerationType() && "unexpected converted const type");
4922 
4923   if (checkPlaceholderForOverload(*this, From))
4924     return ExprError();
4925 
4926   // C++11 [expr.const]p3 with proposed wording fixes:
4927   //  A converted constant expression of type T is a core constant expression,
4928   //  implicitly converted to a prvalue of type T, where the converted
4929   //  expression is a literal constant expression and the implicit conversion
4930   //  sequence contains only user-defined conversions, lvalue-to-rvalue
4931   //  conversions, integral promotions, and integral conversions other than
4932   //  narrowing conversions.
4933   ImplicitConversionSequence ICS =
4934     TryImplicitConversion(From, T,
4935                           /*SuppressUserConversions=*/false,
4936                           /*AllowExplicit=*/false,
4937                           /*InOverloadResolution=*/false,
4938                           /*CStyle=*/false,
4939                           /*AllowObjcWritebackConversion=*/false);
4940   StandardConversionSequence *SCS = 0;
4941   switch (ICS.getKind()) {
4942   case ImplicitConversionSequence::StandardConversion:
4943     if (!CheckConvertedConstantConversions(*this, ICS.Standard))
4944       return Diag(From->getLocStart(),
4945                   diag::err_typecheck_converted_constant_expression_disallowed)
4946                << From->getType() << From->getSourceRange() << T;
4947     SCS = &ICS.Standard;
4948     break;
4949   case ImplicitConversionSequence::UserDefinedConversion:
4950     // We are converting from class type to an integral or enumeration type, so
4951     // the Before sequence must be trivial.
4952     if (!CheckConvertedConstantConversions(*this, ICS.UserDefined.After))
4953       return Diag(From->getLocStart(),
4954                   diag::err_typecheck_converted_constant_expression_disallowed)
4955                << From->getType() << From->getSourceRange() << T;
4956     SCS = &ICS.UserDefined.After;
4957     break;
4958   case ImplicitConversionSequence::AmbiguousConversion:
4959   case ImplicitConversionSequence::BadConversion:
4960     if (!DiagnoseMultipleUserDefinedConversion(From, T))
4961       return Diag(From->getLocStart(),
4962                   diag::err_typecheck_converted_constant_expression)
4963                     << From->getType() << From->getSourceRange() << T;
4964     return ExprError();
4965 
4966   case ImplicitConversionSequence::EllipsisConversion:
4967     llvm_unreachable("ellipsis conversion in converted constant expression");
4968   }
4969 
4970   ExprResult Result = PerformImplicitConversion(From, T, ICS, AA_Converting);
4971   if (Result.isInvalid())
4972     return Result;
4973 
4974   // Check for a narrowing implicit conversion.
4975   APValue PreNarrowingValue;
4976   QualType PreNarrowingType;
4977   switch (SCS->getNarrowingKind(Context, Result.get(), PreNarrowingValue,
4978                                 PreNarrowingType)) {
4979   case NK_Variable_Narrowing:
4980     // Implicit conversion to a narrower type, and the value is not a constant
4981     // expression. We'll diagnose this in a moment.
4982   case NK_Not_Narrowing:
4983     break;
4984 
4985   case NK_Constant_Narrowing:
4986     Diag(From->getLocStart(),
4987          isSFINAEContext() ? diag::err_cce_narrowing_sfinae :
4988                              diag::err_cce_narrowing)
4989       << CCE << /*Constant*/1
4990       << PreNarrowingValue.getAsString(Context, PreNarrowingType) << T;
4991     break;
4992 
4993   case NK_Type_Narrowing:
4994     Diag(From->getLocStart(),
4995          isSFINAEContext() ? diag::err_cce_narrowing_sfinae :
4996                              diag::err_cce_narrowing)
4997       << CCE << /*Constant*/0 << From->getType() << T;
4998     break;
4999   }
5000 
5001   // Check the expression is a constant expression.
5002   SmallVector<PartialDiagnosticAt, 8> Notes;
5003   Expr::EvalResult Eval;
5004   Eval.Diag = &Notes;
5005 
5006   if (!Result.get()->EvaluateAsRValue(Eval, Context) || !Eval.Val.isInt()) {
5007     // The expression can't be folded, so we can't keep it at this position in
5008     // the AST.
5009     Result = ExprError();
5010   } else {
5011     Value = Eval.Val.getInt();
5012 
5013     if (Notes.empty()) {
5014       // It's a constant expression.
5015       return Result;
5016     }
5017   }
5018 
5019   // It's not a constant expression. Produce an appropriate diagnostic.
5020   if (Notes.size() == 1 &&
5021       Notes[0].second.getDiagID() == diag::note_invalid_subexpr_in_const_expr)
5022     Diag(Notes[0].first, diag::err_expr_not_cce) << CCE;
5023   else {
5024     Diag(From->getLocStart(), diag::err_expr_not_cce)
5025       << CCE << From->getSourceRange();
5026     for (unsigned I = 0; I < Notes.size(); ++I)
5027       Diag(Notes[I].first, Notes[I].second);
5028   }
5029   return Result;
5030 }
5031 
5032 /// dropPointerConversions - If the given standard conversion sequence
5033 /// involves any pointer conversions, remove them.  This may change
5034 /// the result type of the conversion sequence.
5035 static void dropPointerConversion(StandardConversionSequence &SCS) {
5036   if (SCS.Second == ICK_Pointer_Conversion) {
5037     SCS.Second = ICK_Identity;
5038     SCS.Third = ICK_Identity;
5039     SCS.ToTypePtrs[2] = SCS.ToTypePtrs[1] = SCS.ToTypePtrs[0];
5040   }
5041 }
5042 
5043 /// TryContextuallyConvertToObjCPointer - Attempt to contextually
5044 /// convert the expression From to an Objective-C pointer type.
5045 static ImplicitConversionSequence
5046 TryContextuallyConvertToObjCPointer(Sema &S, Expr *From) {
5047   // Do an implicit conversion to 'id'.
5048   QualType Ty = S.Context.getObjCIdType();
5049   ImplicitConversionSequence ICS
5050     = TryImplicitConversion(S, From, Ty,
5051                             // FIXME: Are these flags correct?
5052                             /*SuppressUserConversions=*/false,
5053                             /*AllowExplicit=*/true,
5054                             /*InOverloadResolution=*/false,
5055                             /*CStyle=*/false,
5056                             /*AllowObjCWritebackConversion=*/false);
5057 
5058   // Strip off any final conversions to 'id'.
5059   switch (ICS.getKind()) {
5060   case ImplicitConversionSequence::BadConversion:
5061   case ImplicitConversionSequence::AmbiguousConversion:
5062   case ImplicitConversionSequence::EllipsisConversion:
5063     break;
5064 
5065   case ImplicitConversionSequence::UserDefinedConversion:
5066     dropPointerConversion(ICS.UserDefined.After);
5067     break;
5068 
5069   case ImplicitConversionSequence::StandardConversion:
5070     dropPointerConversion(ICS.Standard);
5071     break;
5072   }
5073 
5074   return ICS;
5075 }
5076 
5077 /// PerformContextuallyConvertToObjCPointer - Perform a contextual
5078 /// conversion of the expression From to an Objective-C pointer type.
5079 ExprResult Sema::PerformContextuallyConvertToObjCPointer(Expr *From) {
5080   if (checkPlaceholderForOverload(*this, From))
5081     return ExprError();
5082 
5083   QualType Ty = Context.getObjCIdType();
5084   ImplicitConversionSequence ICS =
5085     TryContextuallyConvertToObjCPointer(*this, From);
5086   if (!ICS.isBad())
5087     return PerformImplicitConversion(From, Ty, ICS, AA_Converting);
5088   return ExprError();
5089 }
5090 
5091 /// Determine whether the provided type is an integral type, or an enumeration
5092 /// type of a permitted flavor.
5093 bool Sema::ICEConvertDiagnoser::match(QualType T) {
5094   return AllowScopedEnumerations ? T->isIntegralOrEnumerationType()
5095                                  : T->isIntegralOrUnscopedEnumerationType();
5096 }
5097 
5098 static ExprResult
5099 diagnoseAmbiguousConversion(Sema &SemaRef, SourceLocation Loc, Expr *From,
5100                             Sema::ContextualImplicitConverter &Converter,
5101                             QualType T, UnresolvedSetImpl &ViableConversions) {
5102 
5103   if (Converter.Suppress)
5104     return ExprError();
5105 
5106   Converter.diagnoseAmbiguous(SemaRef, Loc, T) << From->getSourceRange();
5107   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5108     CXXConversionDecl *Conv =
5109         cast<CXXConversionDecl>(ViableConversions[I]->getUnderlyingDecl());
5110     QualType ConvTy = Conv->getConversionType().getNonReferenceType();
5111     Converter.noteAmbiguous(SemaRef, Conv, ConvTy);
5112   }
5113   return SemaRef.Owned(From);
5114 }
5115 
5116 static bool
5117 diagnoseNoViableConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5118                            Sema::ContextualImplicitConverter &Converter,
5119                            QualType T, bool HadMultipleCandidates,
5120                            UnresolvedSetImpl &ExplicitConversions) {
5121   if (ExplicitConversions.size() == 1 && !Converter.Suppress) {
5122     DeclAccessPair Found = ExplicitConversions[0];
5123     CXXConversionDecl *Conversion =
5124         cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5125 
5126     // The user probably meant to invoke the given explicit
5127     // conversion; use it.
5128     QualType ConvTy = Conversion->getConversionType().getNonReferenceType();
5129     std::string TypeStr;
5130     ConvTy.getAsStringInternal(TypeStr, SemaRef.getPrintingPolicy());
5131 
5132     Converter.diagnoseExplicitConv(SemaRef, Loc, T, ConvTy)
5133         << FixItHint::CreateInsertion(From->getLocStart(),
5134                                       "static_cast<" + TypeStr + ">(")
5135         << FixItHint::CreateInsertion(
5136                SemaRef.PP.getLocForEndOfToken(From->getLocEnd()), ")");
5137     Converter.noteExplicitConv(SemaRef, Conversion, ConvTy);
5138 
5139     // If we aren't in a SFINAE context, build a call to the
5140     // explicit conversion function.
5141     if (SemaRef.isSFINAEContext())
5142       return true;
5143 
5144     SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, 0, Found);
5145     ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5146                                                        HadMultipleCandidates);
5147     if (Result.isInvalid())
5148       return true;
5149     // Record usage of conversion in an implicit cast.
5150     From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5151                                     CK_UserDefinedConversion, Result.get(), 0,
5152                                     Result.get()->getValueKind());
5153   }
5154   return false;
5155 }
5156 
5157 static bool recordConversion(Sema &SemaRef, SourceLocation Loc, Expr *&From,
5158                              Sema::ContextualImplicitConverter &Converter,
5159                              QualType T, bool HadMultipleCandidates,
5160                              DeclAccessPair &Found) {
5161   CXXConversionDecl *Conversion =
5162       cast<CXXConversionDecl>(Found->getUnderlyingDecl());
5163   SemaRef.CheckMemberOperatorAccess(From->getExprLoc(), From, 0, Found);
5164 
5165   QualType ToType = Conversion->getConversionType().getNonReferenceType();
5166   if (!Converter.SuppressConversion) {
5167     if (SemaRef.isSFINAEContext())
5168       return true;
5169 
5170     Converter.diagnoseConversion(SemaRef, Loc, T, ToType)
5171         << From->getSourceRange();
5172   }
5173 
5174   ExprResult Result = SemaRef.BuildCXXMemberCallExpr(From, Found, Conversion,
5175                                                      HadMultipleCandidates);
5176   if (Result.isInvalid())
5177     return true;
5178   // Record usage of conversion in an implicit cast.
5179   From = ImplicitCastExpr::Create(SemaRef.Context, Result.get()->getType(),
5180                                   CK_UserDefinedConversion, Result.get(), 0,
5181                                   Result.get()->getValueKind());
5182   return false;
5183 }
5184 
5185 static ExprResult finishContextualImplicitConversion(
5186     Sema &SemaRef, SourceLocation Loc, Expr *From,
5187     Sema::ContextualImplicitConverter &Converter) {
5188   if (!Converter.match(From->getType()) && !Converter.Suppress)
5189     Converter.diagnoseNoMatch(SemaRef, Loc, From->getType())
5190         << From->getSourceRange();
5191 
5192   return SemaRef.DefaultLvalueConversion(From);
5193 }
5194 
5195 static void
5196 collectViableConversionCandidates(Sema &SemaRef, Expr *From, QualType ToType,
5197                                   UnresolvedSetImpl &ViableConversions,
5198                                   OverloadCandidateSet &CandidateSet) {
5199   for (unsigned I = 0, N = ViableConversions.size(); I != N; ++I) {
5200     DeclAccessPair FoundDecl = ViableConversions[I];
5201     NamedDecl *D = FoundDecl.getDecl();
5202     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
5203     if (isa<UsingShadowDecl>(D))
5204       D = cast<UsingShadowDecl>(D)->getTargetDecl();
5205 
5206     CXXConversionDecl *Conv;
5207     FunctionTemplateDecl *ConvTemplate;
5208     if ((ConvTemplate = dyn_cast<FunctionTemplateDecl>(D)))
5209       Conv = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5210     else
5211       Conv = cast<CXXConversionDecl>(D);
5212 
5213     if (ConvTemplate)
5214       SemaRef.AddTemplateConversionCandidate(
5215           ConvTemplate, FoundDecl, ActingContext, From, ToType, CandidateSet);
5216     else
5217       SemaRef.AddConversionCandidate(Conv, FoundDecl, ActingContext, From,
5218                                      ToType, CandidateSet);
5219   }
5220 }
5221 
5222 /// \brief Attempt to convert the given expression to a type which is accepted
5223 /// by the given converter.
5224 ///
5225 /// This routine will attempt to convert an expression of class type to a
5226 /// type accepted by the specified converter. In C++11 and before, the class
5227 /// must have a single non-explicit conversion function converting to a matching
5228 /// type. In C++1y, there can be multiple such conversion functions, but only
5229 /// one target type.
5230 ///
5231 /// \param Loc The source location of the construct that requires the
5232 /// conversion.
5233 ///
5234 /// \param From The expression we're converting from.
5235 ///
5236 /// \param Converter Used to control and diagnose the conversion process.
5237 ///
5238 /// \returns The expression, converted to an integral or enumeration type if
5239 /// successful.
5240 ExprResult Sema::PerformContextualImplicitConversion(
5241     SourceLocation Loc, Expr *From, ContextualImplicitConverter &Converter) {
5242   // We can't perform any more checking for type-dependent expressions.
5243   if (From->isTypeDependent())
5244     return Owned(From);
5245 
5246   // Process placeholders immediately.
5247   if (From->hasPlaceholderType()) {
5248     ExprResult result = CheckPlaceholderExpr(From);
5249     if (result.isInvalid())
5250       return result;
5251     From = result.take();
5252   }
5253 
5254   // If the expression already has a matching type, we're golden.
5255   QualType T = From->getType();
5256   if (Converter.match(T))
5257     return DefaultLvalueConversion(From);
5258 
5259   // FIXME: Check for missing '()' if T is a function type?
5260 
5261   // We can only perform contextual implicit conversions on objects of class
5262   // type.
5263   const RecordType *RecordTy = T->getAs<RecordType>();
5264   if (!RecordTy || !getLangOpts().CPlusPlus) {
5265     if (!Converter.Suppress)
5266       Converter.diagnoseNoMatch(*this, Loc, T) << From->getSourceRange();
5267     return Owned(From);
5268   }
5269 
5270   // We must have a complete class type.
5271   struct TypeDiagnoserPartialDiag : TypeDiagnoser {
5272     ContextualImplicitConverter &Converter;
5273     Expr *From;
5274 
5275     TypeDiagnoserPartialDiag(ContextualImplicitConverter &Converter, Expr *From)
5276         : TypeDiagnoser(Converter.Suppress), Converter(Converter), From(From) {}
5277 
5278     virtual void diagnose(Sema &S, SourceLocation Loc, QualType T) {
5279       Converter.diagnoseIncomplete(S, Loc, T) << From->getSourceRange();
5280     }
5281   } IncompleteDiagnoser(Converter, From);
5282 
5283   if (RequireCompleteType(Loc, T, IncompleteDiagnoser))
5284     return Owned(From);
5285 
5286   // Look for a conversion to an integral or enumeration type.
5287   UnresolvedSet<4>
5288       ViableConversions; // These are *potentially* viable in C++1y.
5289   UnresolvedSet<4> ExplicitConversions;
5290   std::pair<CXXRecordDecl::conversion_iterator,
5291             CXXRecordDecl::conversion_iterator> Conversions =
5292       cast<CXXRecordDecl>(RecordTy->getDecl())->getVisibleConversionFunctions();
5293 
5294   bool HadMultipleCandidates =
5295       (std::distance(Conversions.first, Conversions.second) > 1);
5296 
5297   // To check that there is only one target type, in C++1y:
5298   QualType ToType;
5299   bool HasUniqueTargetType = true;
5300 
5301   // Collect explicit or viable (potentially in C++1y) conversions.
5302   for (CXXRecordDecl::conversion_iterator I = Conversions.first,
5303                                           E = Conversions.second;
5304        I != E; ++I) {
5305     NamedDecl *D = (*I)->getUnderlyingDecl();
5306     CXXConversionDecl *Conversion;
5307     FunctionTemplateDecl *ConvTemplate = dyn_cast<FunctionTemplateDecl>(D);
5308     if (ConvTemplate) {
5309       if (getLangOpts().CPlusPlus1y)
5310         Conversion = cast<CXXConversionDecl>(ConvTemplate->getTemplatedDecl());
5311       else
5312         continue; // C++11 does not consider conversion operator templates(?).
5313     } else
5314       Conversion = cast<CXXConversionDecl>(D);
5315 
5316     assert((!ConvTemplate || getLangOpts().CPlusPlus1y) &&
5317            "Conversion operator templates are considered potentially "
5318            "viable in C++1y");
5319 
5320     QualType CurToType = Conversion->getConversionType().getNonReferenceType();
5321     if (Converter.match(CurToType) || ConvTemplate) {
5322 
5323       if (Conversion->isExplicit()) {
5324         // FIXME: For C++1y, do we need this restriction?
5325         // cf. diagnoseNoViableConversion()
5326         if (!ConvTemplate)
5327           ExplicitConversions.addDecl(I.getDecl(), I.getAccess());
5328       } else {
5329         if (!ConvTemplate && getLangOpts().CPlusPlus1y) {
5330           if (ToType.isNull())
5331             ToType = CurToType.getUnqualifiedType();
5332           else if (HasUniqueTargetType &&
5333                    (CurToType.getUnqualifiedType() != ToType))
5334             HasUniqueTargetType = false;
5335         }
5336         ViableConversions.addDecl(I.getDecl(), I.getAccess());
5337       }
5338     }
5339   }
5340 
5341   if (getLangOpts().CPlusPlus1y) {
5342     // C++1y [conv]p6:
5343     // ... An expression e of class type E appearing in such a context
5344     // is said to be contextually implicitly converted to a specified
5345     // type T and is well-formed if and only if e can be implicitly
5346     // converted to a type T that is determined as follows: E is searched
5347     // for conversion functions whose return type is cv T or reference to
5348     // cv T such that T is allowed by the context. There shall be
5349     // exactly one such T.
5350 
5351     // If no unique T is found:
5352     if (ToType.isNull()) {
5353       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5354                                      HadMultipleCandidates,
5355                                      ExplicitConversions))
5356         return ExprError();
5357       return finishContextualImplicitConversion(*this, Loc, From, Converter);
5358     }
5359 
5360     // If more than one unique Ts are found:
5361     if (!HasUniqueTargetType)
5362       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5363                                          ViableConversions);
5364 
5365     // If one unique T is found:
5366     // First, build a candidate set from the previously recorded
5367     // potentially viable conversions.
5368     OverloadCandidateSet CandidateSet(Loc);
5369     collectViableConversionCandidates(*this, From, ToType, ViableConversions,
5370                                       CandidateSet);
5371 
5372     // Then, perform overload resolution over the candidate set.
5373     OverloadCandidateSet::iterator Best;
5374     switch (CandidateSet.BestViableFunction(*this, Loc, Best)) {
5375     case OR_Success: {
5376       // Apply this conversion.
5377       DeclAccessPair Found =
5378           DeclAccessPair::make(Best->Function, Best->FoundDecl.getAccess());
5379       if (recordConversion(*this, Loc, From, Converter, T,
5380                            HadMultipleCandidates, Found))
5381         return ExprError();
5382       break;
5383     }
5384     case OR_Ambiguous:
5385       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5386                                          ViableConversions);
5387     case OR_No_Viable_Function:
5388       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5389                                      HadMultipleCandidates,
5390                                      ExplicitConversions))
5391         return ExprError();
5392     // fall through 'OR_Deleted' case.
5393     case OR_Deleted:
5394       // We'll complain below about a non-integral condition type.
5395       break;
5396     }
5397   } else {
5398     switch (ViableConversions.size()) {
5399     case 0: {
5400       if (diagnoseNoViableConversion(*this, Loc, From, Converter, T,
5401                                      HadMultipleCandidates,
5402                                      ExplicitConversions))
5403         return ExprError();
5404 
5405       // We'll complain below about a non-integral condition type.
5406       break;
5407     }
5408     case 1: {
5409       // Apply this conversion.
5410       DeclAccessPair Found = ViableConversions[0];
5411       if (recordConversion(*this, Loc, From, Converter, T,
5412                            HadMultipleCandidates, Found))
5413         return ExprError();
5414       break;
5415     }
5416     default:
5417       return diagnoseAmbiguousConversion(*this, Loc, From, Converter, T,
5418                                          ViableConversions);
5419     }
5420   }
5421 
5422   return finishContextualImplicitConversion(*this, Loc, From, Converter);
5423 }
5424 
5425 /// AddOverloadCandidate - Adds the given function to the set of
5426 /// candidate functions, using the given function call arguments.  If
5427 /// @p SuppressUserConversions, then don't allow user-defined
5428 /// conversions via constructors or conversion operators.
5429 ///
5430 /// \param PartialOverloading true if we are performing "partial" overloading
5431 /// based on an incomplete set of function arguments. This feature is used by
5432 /// code completion.
5433 void
5434 Sema::AddOverloadCandidate(FunctionDecl *Function,
5435                            DeclAccessPair FoundDecl,
5436                            ArrayRef<Expr *> Args,
5437                            OverloadCandidateSet& CandidateSet,
5438                            bool SuppressUserConversions,
5439                            bool PartialOverloading,
5440                            bool AllowExplicit) {
5441   const FunctionProtoType* Proto
5442     = dyn_cast<FunctionProtoType>(Function->getType()->getAs<FunctionType>());
5443   assert(Proto && "Functions without a prototype cannot be overloaded");
5444   assert(!Function->getDescribedFunctionTemplate() &&
5445          "Use AddTemplateOverloadCandidate for function templates");
5446 
5447   if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Function)) {
5448     if (!isa<CXXConstructorDecl>(Method)) {
5449       // If we get here, it's because we're calling a member function
5450       // that is named without a member access expression (e.g.,
5451       // "this->f") that was either written explicitly or created
5452       // implicitly. This can happen with a qualified call to a member
5453       // function, e.g., X::f(). We use an empty type for the implied
5454       // object argument (C++ [over.call.func]p3), and the acting context
5455       // is irrelevant.
5456       AddMethodCandidate(Method, FoundDecl, Method->getParent(),
5457                          QualType(), Expr::Classification::makeSimpleLValue(),
5458                          Args, CandidateSet, SuppressUserConversions);
5459       return;
5460     }
5461     // We treat a constructor like a non-member function, since its object
5462     // argument doesn't participate in overload resolution.
5463   }
5464 
5465   if (!CandidateSet.isNewCandidate(Function))
5466     return;
5467 
5468   // Overload resolution is always an unevaluated context.
5469   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
5470 
5471   if (CXXConstructorDecl *Constructor = dyn_cast<CXXConstructorDecl>(Function)){
5472     // C++ [class.copy]p3:
5473     //   A member function template is never instantiated to perform the copy
5474     //   of a class object to an object of its class type.
5475     QualType ClassType = Context.getTypeDeclType(Constructor->getParent());
5476     if (Args.size() == 1 &&
5477         Constructor->isSpecializationCopyingObject() &&
5478         (Context.hasSameUnqualifiedType(ClassType, Args[0]->getType()) ||
5479          IsDerivedFrom(Args[0]->getType(), ClassType)))
5480       return;
5481   }
5482 
5483   // Add this candidate
5484   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size());
5485   Candidate.FoundDecl = FoundDecl;
5486   Candidate.Function = Function;
5487   Candidate.Viable = true;
5488   Candidate.IsSurrogate = false;
5489   Candidate.IgnoreObjectArgument = false;
5490   Candidate.ExplicitCallArguments = Args.size();
5491 
5492   unsigned NumArgsInProto = Proto->getNumArgs();
5493 
5494   // (C++ 13.3.2p2): A candidate function having fewer than m
5495   // parameters is viable only if it has an ellipsis in its parameter
5496   // list (8.3.5).
5497   if ((Args.size() + (PartialOverloading && Args.size())) > NumArgsInProto &&
5498       !Proto->isVariadic()) {
5499     Candidate.Viable = false;
5500     Candidate.FailureKind = ovl_fail_too_many_arguments;
5501     return;
5502   }
5503 
5504   // (C++ 13.3.2p2): A candidate function having more than m parameters
5505   // is viable only if the (m+1)st parameter has a default argument
5506   // (8.3.6). For the purposes of overload resolution, the
5507   // parameter list is truncated on the right, so that there are
5508   // exactly m parameters.
5509   unsigned MinRequiredArgs = Function->getMinRequiredArguments();
5510   if (Args.size() < MinRequiredArgs && !PartialOverloading) {
5511     // Not enough arguments.
5512     Candidate.Viable = false;
5513     Candidate.FailureKind = ovl_fail_too_few_arguments;
5514     return;
5515   }
5516 
5517   // (CUDA B.1): Check for invalid calls between targets.
5518   if (getLangOpts().CUDA)
5519     if (const FunctionDecl *Caller = dyn_cast<FunctionDecl>(CurContext))
5520       if (CheckCUDATarget(Caller, Function)) {
5521         Candidate.Viable = false;
5522         Candidate.FailureKind = ovl_fail_bad_target;
5523         return;
5524       }
5525 
5526   // Determine the implicit conversion sequences for each of the
5527   // arguments.
5528   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
5529     if (ArgIdx < NumArgsInProto) {
5530       // (C++ 13.3.2p3): for F to be a viable function, there shall
5531       // exist for each argument an implicit conversion sequence
5532       // (13.3.3.1) that converts that argument to the corresponding
5533       // parameter of F.
5534       QualType ParamType = Proto->getArgType(ArgIdx);
5535       Candidate.Conversions[ArgIdx]
5536         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
5537                                 SuppressUserConversions,
5538                                 /*InOverloadResolution=*/true,
5539                                 /*AllowObjCWritebackConversion=*/
5540                                   getLangOpts().ObjCAutoRefCount,
5541                                 AllowExplicit);
5542       if (Candidate.Conversions[ArgIdx].isBad()) {
5543         Candidate.Viable = false;
5544         Candidate.FailureKind = ovl_fail_bad_conversion;
5545         break;
5546       }
5547     } else {
5548       // (C++ 13.3.2p2): For the purposes of overload resolution, any
5549       // argument for which there is no corresponding parameter is
5550       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
5551       Candidate.Conversions[ArgIdx].setEllipsis();
5552     }
5553   }
5554 }
5555 
5556 /// \brief Add all of the function declarations in the given function set to
5557 /// the overload canddiate set.
5558 void Sema::AddFunctionCandidates(const UnresolvedSetImpl &Fns,
5559                                  ArrayRef<Expr *> Args,
5560                                  OverloadCandidateSet& CandidateSet,
5561                                  bool SuppressUserConversions,
5562                                TemplateArgumentListInfo *ExplicitTemplateArgs) {
5563   for (UnresolvedSetIterator F = Fns.begin(), E = Fns.end(); F != E; ++F) {
5564     NamedDecl *D = F.getDecl()->getUnderlyingDecl();
5565     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
5566       if (isa<CXXMethodDecl>(FD) && !cast<CXXMethodDecl>(FD)->isStatic())
5567         AddMethodCandidate(cast<CXXMethodDecl>(FD), F.getPair(),
5568                            cast<CXXMethodDecl>(FD)->getParent(),
5569                            Args[0]->getType(), Args[0]->Classify(Context),
5570                            Args.slice(1), CandidateSet,
5571                            SuppressUserConversions);
5572       else
5573         AddOverloadCandidate(FD, F.getPair(), Args, CandidateSet,
5574                              SuppressUserConversions);
5575     } else {
5576       FunctionTemplateDecl *FunTmpl = cast<FunctionTemplateDecl>(D);
5577       if (isa<CXXMethodDecl>(FunTmpl->getTemplatedDecl()) &&
5578           !cast<CXXMethodDecl>(FunTmpl->getTemplatedDecl())->isStatic())
5579         AddMethodTemplateCandidate(FunTmpl, F.getPair(),
5580                               cast<CXXRecordDecl>(FunTmpl->getDeclContext()),
5581                                    ExplicitTemplateArgs,
5582                                    Args[0]->getType(),
5583                                    Args[0]->Classify(Context), Args.slice(1),
5584                                    CandidateSet, SuppressUserConversions);
5585       else
5586         AddTemplateOverloadCandidate(FunTmpl, F.getPair(),
5587                                      ExplicitTemplateArgs, Args,
5588                                      CandidateSet, SuppressUserConversions);
5589     }
5590   }
5591 }
5592 
5593 /// AddMethodCandidate - Adds a named decl (which is some kind of
5594 /// method) as a method candidate to the given overload set.
5595 void Sema::AddMethodCandidate(DeclAccessPair FoundDecl,
5596                               QualType ObjectType,
5597                               Expr::Classification ObjectClassification,
5598                               ArrayRef<Expr *> Args,
5599                               OverloadCandidateSet& CandidateSet,
5600                               bool SuppressUserConversions) {
5601   NamedDecl *Decl = FoundDecl.getDecl();
5602   CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(Decl->getDeclContext());
5603 
5604   if (isa<UsingShadowDecl>(Decl))
5605     Decl = cast<UsingShadowDecl>(Decl)->getTargetDecl();
5606 
5607   if (FunctionTemplateDecl *TD = dyn_cast<FunctionTemplateDecl>(Decl)) {
5608     assert(isa<CXXMethodDecl>(TD->getTemplatedDecl()) &&
5609            "Expected a member function template");
5610     AddMethodTemplateCandidate(TD, FoundDecl, ActingContext,
5611                                /*ExplicitArgs*/ 0,
5612                                ObjectType, ObjectClassification,
5613                                Args, CandidateSet,
5614                                SuppressUserConversions);
5615   } else {
5616     AddMethodCandidate(cast<CXXMethodDecl>(Decl), FoundDecl, ActingContext,
5617                        ObjectType, ObjectClassification,
5618                        Args,
5619                        CandidateSet, SuppressUserConversions);
5620   }
5621 }
5622 
5623 /// AddMethodCandidate - Adds the given C++ member function to the set
5624 /// of candidate functions, using the given function call arguments
5625 /// and the object argument (@c Object). For example, in a call
5626 /// @c o.f(a1,a2), @c Object will contain @c o and @c Args will contain
5627 /// both @c a1 and @c a2. If @p SuppressUserConversions, then don't
5628 /// allow user-defined conversions via constructors or conversion
5629 /// operators.
5630 void
5631 Sema::AddMethodCandidate(CXXMethodDecl *Method, DeclAccessPair FoundDecl,
5632                          CXXRecordDecl *ActingContext, QualType ObjectType,
5633                          Expr::Classification ObjectClassification,
5634                          ArrayRef<Expr *> Args,
5635                          OverloadCandidateSet& CandidateSet,
5636                          bool SuppressUserConversions) {
5637   const FunctionProtoType* Proto
5638     = dyn_cast<FunctionProtoType>(Method->getType()->getAs<FunctionType>());
5639   assert(Proto && "Methods without a prototype cannot be overloaded");
5640   assert(!isa<CXXConstructorDecl>(Method) &&
5641          "Use AddOverloadCandidate for constructors");
5642 
5643   if (!CandidateSet.isNewCandidate(Method))
5644     return;
5645 
5646   // Overload resolution is always an unevaluated context.
5647   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
5648 
5649   // Add this candidate
5650   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size() + 1);
5651   Candidate.FoundDecl = FoundDecl;
5652   Candidate.Function = Method;
5653   Candidate.IsSurrogate = false;
5654   Candidate.IgnoreObjectArgument = false;
5655   Candidate.ExplicitCallArguments = Args.size();
5656 
5657   unsigned NumArgsInProto = Proto->getNumArgs();
5658 
5659   // (C++ 13.3.2p2): A candidate function having fewer than m
5660   // parameters is viable only if it has an ellipsis in its parameter
5661   // list (8.3.5).
5662   if (Args.size() > NumArgsInProto && !Proto->isVariadic()) {
5663     Candidate.Viable = false;
5664     Candidate.FailureKind = ovl_fail_too_many_arguments;
5665     return;
5666   }
5667 
5668   // (C++ 13.3.2p2): A candidate function having more than m parameters
5669   // is viable only if the (m+1)st parameter has a default argument
5670   // (8.3.6). For the purposes of overload resolution, the
5671   // parameter list is truncated on the right, so that there are
5672   // exactly m parameters.
5673   unsigned MinRequiredArgs = Method->getMinRequiredArguments();
5674   if (Args.size() < MinRequiredArgs) {
5675     // Not enough arguments.
5676     Candidate.Viable = false;
5677     Candidate.FailureKind = ovl_fail_too_few_arguments;
5678     return;
5679   }
5680 
5681   Candidate.Viable = true;
5682 
5683   if (Method->isStatic() || ObjectType.isNull())
5684     // The implicit object argument is ignored.
5685     Candidate.IgnoreObjectArgument = true;
5686   else {
5687     // Determine the implicit conversion sequence for the object
5688     // parameter.
5689     Candidate.Conversions[0]
5690       = TryObjectArgumentInitialization(*this, ObjectType, ObjectClassification,
5691                                         Method, ActingContext);
5692     if (Candidate.Conversions[0].isBad()) {
5693       Candidate.Viable = false;
5694       Candidate.FailureKind = ovl_fail_bad_conversion;
5695       return;
5696     }
5697   }
5698 
5699   // Determine the implicit conversion sequences for each of the
5700   // arguments.
5701   for (unsigned ArgIdx = 0; ArgIdx < Args.size(); ++ArgIdx) {
5702     if (ArgIdx < NumArgsInProto) {
5703       // (C++ 13.3.2p3): for F to be a viable function, there shall
5704       // exist for each argument an implicit conversion sequence
5705       // (13.3.3.1) that converts that argument to the corresponding
5706       // parameter of F.
5707       QualType ParamType = Proto->getArgType(ArgIdx);
5708       Candidate.Conversions[ArgIdx + 1]
5709         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
5710                                 SuppressUserConversions,
5711                                 /*InOverloadResolution=*/true,
5712                                 /*AllowObjCWritebackConversion=*/
5713                                   getLangOpts().ObjCAutoRefCount);
5714       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
5715         Candidate.Viable = false;
5716         Candidate.FailureKind = ovl_fail_bad_conversion;
5717         break;
5718       }
5719     } else {
5720       // (C++ 13.3.2p2): For the purposes of overload resolution, any
5721       // argument for which there is no corresponding parameter is
5722       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
5723       Candidate.Conversions[ArgIdx + 1].setEllipsis();
5724     }
5725   }
5726 }
5727 
5728 /// \brief Add a C++ member function template as a candidate to the candidate
5729 /// set, using template argument deduction to produce an appropriate member
5730 /// function template specialization.
5731 void
5732 Sema::AddMethodTemplateCandidate(FunctionTemplateDecl *MethodTmpl,
5733                                  DeclAccessPair FoundDecl,
5734                                  CXXRecordDecl *ActingContext,
5735                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
5736                                  QualType ObjectType,
5737                                  Expr::Classification ObjectClassification,
5738                                  ArrayRef<Expr *> Args,
5739                                  OverloadCandidateSet& CandidateSet,
5740                                  bool SuppressUserConversions) {
5741   if (!CandidateSet.isNewCandidate(MethodTmpl))
5742     return;
5743 
5744   // C++ [over.match.funcs]p7:
5745   //   In each case where a candidate is a function template, candidate
5746   //   function template specializations are generated using template argument
5747   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
5748   //   candidate functions in the usual way.113) A given name can refer to one
5749   //   or more function templates and also to a set of overloaded non-template
5750   //   functions. In such a case, the candidate functions generated from each
5751   //   function template are combined with the set of non-template candidate
5752   //   functions.
5753   TemplateDeductionInfo Info(CandidateSet.getLocation());
5754   FunctionDecl *Specialization = 0;
5755   if (TemplateDeductionResult Result
5756       = DeduceTemplateArguments(MethodTmpl, ExplicitTemplateArgs, Args,
5757                                 Specialization, Info)) {
5758     OverloadCandidate &Candidate = CandidateSet.addCandidate();
5759     Candidate.FoundDecl = FoundDecl;
5760     Candidate.Function = MethodTmpl->getTemplatedDecl();
5761     Candidate.Viable = false;
5762     Candidate.FailureKind = ovl_fail_bad_deduction;
5763     Candidate.IsSurrogate = false;
5764     Candidate.IgnoreObjectArgument = false;
5765     Candidate.ExplicitCallArguments = Args.size();
5766     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
5767                                                           Info);
5768     return;
5769   }
5770 
5771   // Add the function template specialization produced by template argument
5772   // deduction as a candidate.
5773   assert(Specialization && "Missing member function template specialization?");
5774   assert(isa<CXXMethodDecl>(Specialization) &&
5775          "Specialization is not a member function?");
5776   AddMethodCandidate(cast<CXXMethodDecl>(Specialization), FoundDecl,
5777                      ActingContext, ObjectType, ObjectClassification, Args,
5778                      CandidateSet, SuppressUserConversions);
5779 }
5780 
5781 /// \brief Add a C++ function template specialization as a candidate
5782 /// in the candidate set, using template argument deduction to produce
5783 /// an appropriate function template specialization.
5784 void
5785 Sema::AddTemplateOverloadCandidate(FunctionTemplateDecl *FunctionTemplate,
5786                                    DeclAccessPair FoundDecl,
5787                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
5788                                    ArrayRef<Expr *> Args,
5789                                    OverloadCandidateSet& CandidateSet,
5790                                    bool SuppressUserConversions) {
5791   if (!CandidateSet.isNewCandidate(FunctionTemplate))
5792     return;
5793 
5794   // C++ [over.match.funcs]p7:
5795   //   In each case where a candidate is a function template, candidate
5796   //   function template specializations are generated using template argument
5797   //   deduction (14.8.3, 14.8.2). Those candidates are then handled as
5798   //   candidate functions in the usual way.113) A given name can refer to one
5799   //   or more function templates and also to a set of overloaded non-template
5800   //   functions. In such a case, the candidate functions generated from each
5801   //   function template are combined with the set of non-template candidate
5802   //   functions.
5803   TemplateDeductionInfo Info(CandidateSet.getLocation());
5804   FunctionDecl *Specialization = 0;
5805   if (TemplateDeductionResult Result
5806         = DeduceTemplateArguments(FunctionTemplate, ExplicitTemplateArgs, Args,
5807                                   Specialization, Info)) {
5808     OverloadCandidate &Candidate = CandidateSet.addCandidate();
5809     Candidate.FoundDecl = FoundDecl;
5810     Candidate.Function = FunctionTemplate->getTemplatedDecl();
5811     Candidate.Viable = false;
5812     Candidate.FailureKind = ovl_fail_bad_deduction;
5813     Candidate.IsSurrogate = false;
5814     Candidate.IgnoreObjectArgument = false;
5815     Candidate.ExplicitCallArguments = Args.size();
5816     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
5817                                                           Info);
5818     return;
5819   }
5820 
5821   // Add the function template specialization produced by template argument
5822   // deduction as a candidate.
5823   assert(Specialization && "Missing function template specialization?");
5824   AddOverloadCandidate(Specialization, FoundDecl, Args, CandidateSet,
5825                        SuppressUserConversions);
5826 }
5827 
5828 /// AddConversionCandidate - Add a C++ conversion function as a
5829 /// candidate in the candidate set (C++ [over.match.conv],
5830 /// C++ [over.match.copy]). From is the expression we're converting from,
5831 /// and ToType is the type that we're eventually trying to convert to
5832 /// (which may or may not be the same type as the type that the
5833 /// conversion function produces).
5834 void
5835 Sema::AddConversionCandidate(CXXConversionDecl *Conversion,
5836                              DeclAccessPair FoundDecl,
5837                              CXXRecordDecl *ActingContext,
5838                              Expr *From, QualType ToType,
5839                              OverloadCandidateSet& CandidateSet) {
5840   assert(!Conversion->getDescribedFunctionTemplate() &&
5841          "Conversion function templates use AddTemplateConversionCandidate");
5842   QualType ConvType = Conversion->getConversionType().getNonReferenceType();
5843   if (!CandidateSet.isNewCandidate(Conversion))
5844     return;
5845 
5846   // If the conversion function has an undeduced return type, trigger its
5847   // deduction now.
5848   if (getLangOpts().CPlusPlus1y && ConvType->isUndeducedType()) {
5849     if (DeduceReturnType(Conversion, From->getExprLoc()))
5850       return;
5851     ConvType = Conversion->getConversionType().getNonReferenceType();
5852   }
5853 
5854   // Overload resolution is always an unevaluated context.
5855   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
5856 
5857   // Add this candidate
5858   OverloadCandidate &Candidate = CandidateSet.addCandidate(1);
5859   Candidate.FoundDecl = FoundDecl;
5860   Candidate.Function = Conversion;
5861   Candidate.IsSurrogate = false;
5862   Candidate.IgnoreObjectArgument = false;
5863   Candidate.FinalConversion.setAsIdentityConversion();
5864   Candidate.FinalConversion.setFromType(ConvType);
5865   Candidate.FinalConversion.setAllToTypes(ToType);
5866   Candidate.Viable = true;
5867   Candidate.ExplicitCallArguments = 1;
5868 
5869   // C++ [over.match.funcs]p4:
5870   //   For conversion functions, the function is considered to be a member of
5871   //   the class of the implicit implied object argument for the purpose of
5872   //   defining the type of the implicit object parameter.
5873   //
5874   // Determine the implicit conversion sequence for the implicit
5875   // object parameter.
5876   QualType ImplicitParamType = From->getType();
5877   if (const PointerType *FromPtrType = ImplicitParamType->getAs<PointerType>())
5878     ImplicitParamType = FromPtrType->getPointeeType();
5879   CXXRecordDecl *ConversionContext
5880     = cast<CXXRecordDecl>(ImplicitParamType->getAs<RecordType>()->getDecl());
5881 
5882   Candidate.Conversions[0]
5883     = TryObjectArgumentInitialization(*this, From->getType(),
5884                                       From->Classify(Context),
5885                                       Conversion, ConversionContext);
5886 
5887   if (Candidate.Conversions[0].isBad()) {
5888     Candidate.Viable = false;
5889     Candidate.FailureKind = ovl_fail_bad_conversion;
5890     return;
5891   }
5892 
5893   // We won't go through a user-define type conversion function to convert a
5894   // derived to base as such conversions are given Conversion Rank. They only
5895   // go through a copy constructor. 13.3.3.1.2-p4 [over.ics.user]
5896   QualType FromCanon
5897     = Context.getCanonicalType(From->getType().getUnqualifiedType());
5898   QualType ToCanon = Context.getCanonicalType(ToType).getUnqualifiedType();
5899   if (FromCanon == ToCanon || IsDerivedFrom(FromCanon, ToCanon)) {
5900     Candidate.Viable = false;
5901     Candidate.FailureKind = ovl_fail_trivial_conversion;
5902     return;
5903   }
5904 
5905   // To determine what the conversion from the result of calling the
5906   // conversion function to the type we're eventually trying to
5907   // convert to (ToType), we need to synthesize a call to the
5908   // conversion function and attempt copy initialization from it. This
5909   // makes sure that we get the right semantics with respect to
5910   // lvalues/rvalues and the type. Fortunately, we can allocate this
5911   // call on the stack and we don't need its arguments to be
5912   // well-formed.
5913   DeclRefExpr ConversionRef(Conversion, false, Conversion->getType(),
5914                             VK_LValue, From->getLocStart());
5915   ImplicitCastExpr ConversionFn(ImplicitCastExpr::OnStack,
5916                                 Context.getPointerType(Conversion->getType()),
5917                                 CK_FunctionToPointerDecay,
5918                                 &ConversionRef, VK_RValue);
5919 
5920   QualType ConversionType = Conversion->getConversionType();
5921   if (RequireCompleteType(From->getLocStart(), ConversionType, 0)) {
5922     Candidate.Viable = false;
5923     Candidate.FailureKind = ovl_fail_bad_final_conversion;
5924     return;
5925   }
5926 
5927   ExprValueKind VK = Expr::getValueKindForType(ConversionType);
5928 
5929   // Note that it is safe to allocate CallExpr on the stack here because
5930   // there are 0 arguments (i.e., nothing is allocated using ASTContext's
5931   // allocator).
5932   QualType CallResultType = ConversionType.getNonLValueExprType(Context);
5933   CallExpr Call(Context, &ConversionFn, None, CallResultType, VK,
5934                 From->getLocStart());
5935   ImplicitConversionSequence ICS =
5936     TryCopyInitialization(*this, &Call, ToType,
5937                           /*SuppressUserConversions=*/true,
5938                           /*InOverloadResolution=*/false,
5939                           /*AllowObjCWritebackConversion=*/false);
5940 
5941   switch (ICS.getKind()) {
5942   case ImplicitConversionSequence::StandardConversion:
5943     Candidate.FinalConversion = ICS.Standard;
5944 
5945     // C++ [over.ics.user]p3:
5946     //   If the user-defined conversion is specified by a specialization of a
5947     //   conversion function template, the second standard conversion sequence
5948     //   shall have exact match rank.
5949     if (Conversion->getPrimaryTemplate() &&
5950         GetConversionRank(ICS.Standard.Second) != ICR_Exact_Match) {
5951       Candidate.Viable = false;
5952       Candidate.FailureKind = ovl_fail_final_conversion_not_exact;
5953     }
5954 
5955     // C++0x [dcl.init.ref]p5:
5956     //    In the second case, if the reference is an rvalue reference and
5957     //    the second standard conversion sequence of the user-defined
5958     //    conversion sequence includes an lvalue-to-rvalue conversion, the
5959     //    program is ill-formed.
5960     if (ToType->isRValueReferenceType() &&
5961         ICS.Standard.First == ICK_Lvalue_To_Rvalue) {
5962       Candidate.Viable = false;
5963       Candidate.FailureKind = ovl_fail_bad_final_conversion;
5964     }
5965     break;
5966 
5967   case ImplicitConversionSequence::BadConversion:
5968     Candidate.Viable = false;
5969     Candidate.FailureKind = ovl_fail_bad_final_conversion;
5970     break;
5971 
5972   default:
5973     llvm_unreachable(
5974            "Can only end up with a standard conversion sequence or failure");
5975   }
5976 }
5977 
5978 /// \brief Adds a conversion function template specialization
5979 /// candidate to the overload set, using template argument deduction
5980 /// to deduce the template arguments of the conversion function
5981 /// template from the type that we are converting to (C++
5982 /// [temp.deduct.conv]).
5983 void
5984 Sema::AddTemplateConversionCandidate(FunctionTemplateDecl *FunctionTemplate,
5985                                      DeclAccessPair FoundDecl,
5986                                      CXXRecordDecl *ActingDC,
5987                                      Expr *From, QualType ToType,
5988                                      OverloadCandidateSet &CandidateSet) {
5989   assert(isa<CXXConversionDecl>(FunctionTemplate->getTemplatedDecl()) &&
5990          "Only conversion function templates permitted here");
5991 
5992   if (!CandidateSet.isNewCandidate(FunctionTemplate))
5993     return;
5994 
5995   TemplateDeductionInfo Info(CandidateSet.getLocation());
5996   CXXConversionDecl *Specialization = 0;
5997   if (TemplateDeductionResult Result
5998         = DeduceTemplateArguments(FunctionTemplate, ToType,
5999                                   Specialization, Info)) {
6000     OverloadCandidate &Candidate = CandidateSet.addCandidate();
6001     Candidate.FoundDecl = FoundDecl;
6002     Candidate.Function = FunctionTemplate->getTemplatedDecl();
6003     Candidate.Viable = false;
6004     Candidate.FailureKind = ovl_fail_bad_deduction;
6005     Candidate.IsSurrogate = false;
6006     Candidate.IgnoreObjectArgument = false;
6007     Candidate.ExplicitCallArguments = 1;
6008     Candidate.DeductionFailure = MakeDeductionFailureInfo(Context, Result,
6009                                                           Info);
6010     return;
6011   }
6012 
6013   // Add the conversion function template specialization produced by
6014   // template argument deduction as a candidate.
6015   assert(Specialization && "Missing function template specialization?");
6016   AddConversionCandidate(Specialization, FoundDecl, ActingDC, From, ToType,
6017                          CandidateSet);
6018 }
6019 
6020 /// AddSurrogateCandidate - Adds a "surrogate" candidate function that
6021 /// converts the given @c Object to a function pointer via the
6022 /// conversion function @c Conversion, and then attempts to call it
6023 /// with the given arguments (C++ [over.call.object]p2-4). Proto is
6024 /// the type of function that we'll eventually be calling.
6025 void Sema::AddSurrogateCandidate(CXXConversionDecl *Conversion,
6026                                  DeclAccessPair FoundDecl,
6027                                  CXXRecordDecl *ActingContext,
6028                                  const FunctionProtoType *Proto,
6029                                  Expr *Object,
6030                                  ArrayRef<Expr *> Args,
6031                                  OverloadCandidateSet& CandidateSet) {
6032   if (!CandidateSet.isNewCandidate(Conversion))
6033     return;
6034 
6035   // Overload resolution is always an unevaluated context.
6036   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
6037 
6038   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size() + 1);
6039   Candidate.FoundDecl = FoundDecl;
6040   Candidate.Function = 0;
6041   Candidate.Surrogate = Conversion;
6042   Candidate.Viable = true;
6043   Candidate.IsSurrogate = true;
6044   Candidate.IgnoreObjectArgument = false;
6045   Candidate.ExplicitCallArguments = Args.size();
6046 
6047   // Determine the implicit conversion sequence for the implicit
6048   // object parameter.
6049   ImplicitConversionSequence ObjectInit
6050     = TryObjectArgumentInitialization(*this, Object->getType(),
6051                                       Object->Classify(Context),
6052                                       Conversion, ActingContext);
6053   if (ObjectInit.isBad()) {
6054     Candidate.Viable = false;
6055     Candidate.FailureKind = ovl_fail_bad_conversion;
6056     Candidate.Conversions[0] = ObjectInit;
6057     return;
6058   }
6059 
6060   // The first conversion is actually a user-defined conversion whose
6061   // first conversion is ObjectInit's standard conversion (which is
6062   // effectively a reference binding). Record it as such.
6063   Candidate.Conversions[0].setUserDefined();
6064   Candidate.Conversions[0].UserDefined.Before = ObjectInit.Standard;
6065   Candidate.Conversions[0].UserDefined.EllipsisConversion = false;
6066   Candidate.Conversions[0].UserDefined.HadMultipleCandidates = false;
6067   Candidate.Conversions[0].UserDefined.ConversionFunction = Conversion;
6068   Candidate.Conversions[0].UserDefined.FoundConversionFunction = FoundDecl;
6069   Candidate.Conversions[0].UserDefined.After
6070     = Candidate.Conversions[0].UserDefined.Before;
6071   Candidate.Conversions[0].UserDefined.After.setAsIdentityConversion();
6072 
6073   // Find the
6074   unsigned NumArgsInProto = Proto->getNumArgs();
6075 
6076   // (C++ 13.3.2p2): A candidate function having fewer than m
6077   // parameters is viable only if it has an ellipsis in its parameter
6078   // list (8.3.5).
6079   if (Args.size() > NumArgsInProto && !Proto->isVariadic()) {
6080     Candidate.Viable = false;
6081     Candidate.FailureKind = ovl_fail_too_many_arguments;
6082     return;
6083   }
6084 
6085   // Function types don't have any default arguments, so just check if
6086   // we have enough arguments.
6087   if (Args.size() < NumArgsInProto) {
6088     // Not enough arguments.
6089     Candidate.Viable = false;
6090     Candidate.FailureKind = ovl_fail_too_few_arguments;
6091     return;
6092   }
6093 
6094   // Determine the implicit conversion sequences for each of the
6095   // arguments.
6096   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
6097     if (ArgIdx < NumArgsInProto) {
6098       // (C++ 13.3.2p3): for F to be a viable function, there shall
6099       // exist for each argument an implicit conversion sequence
6100       // (13.3.3.1) that converts that argument to the corresponding
6101       // parameter of F.
6102       QualType ParamType = Proto->getArgType(ArgIdx);
6103       Candidate.Conversions[ArgIdx + 1]
6104         = TryCopyInitialization(*this, Args[ArgIdx], ParamType,
6105                                 /*SuppressUserConversions=*/false,
6106                                 /*InOverloadResolution=*/false,
6107                                 /*AllowObjCWritebackConversion=*/
6108                                   getLangOpts().ObjCAutoRefCount);
6109       if (Candidate.Conversions[ArgIdx + 1].isBad()) {
6110         Candidate.Viable = false;
6111         Candidate.FailureKind = ovl_fail_bad_conversion;
6112         break;
6113       }
6114     } else {
6115       // (C++ 13.3.2p2): For the purposes of overload resolution, any
6116       // argument for which there is no corresponding parameter is
6117       // considered to ""match the ellipsis" (C+ 13.3.3.1.3).
6118       Candidate.Conversions[ArgIdx + 1].setEllipsis();
6119     }
6120   }
6121 }
6122 
6123 /// \brief Add overload candidates for overloaded operators that are
6124 /// member functions.
6125 ///
6126 /// Add the overloaded operator candidates that are member functions
6127 /// for the operator Op that was used in an operator expression such
6128 /// as "x Op y". , Args/NumArgs provides the operator arguments, and
6129 /// CandidateSet will store the added overload candidates. (C++
6130 /// [over.match.oper]).
6131 void Sema::AddMemberOperatorCandidates(OverloadedOperatorKind Op,
6132                                        SourceLocation OpLoc,
6133                                        ArrayRef<Expr *> Args,
6134                                        OverloadCandidateSet& CandidateSet,
6135                                        SourceRange OpRange) {
6136   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
6137 
6138   // C++ [over.match.oper]p3:
6139   //   For a unary operator @ with an operand of a type whose
6140   //   cv-unqualified version is T1, and for a binary operator @ with
6141   //   a left operand of a type whose cv-unqualified version is T1 and
6142   //   a right operand of a type whose cv-unqualified version is T2,
6143   //   three sets of candidate functions, designated member
6144   //   candidates, non-member candidates and built-in candidates, are
6145   //   constructed as follows:
6146   QualType T1 = Args[0]->getType();
6147 
6148   //     -- If T1 is a complete class type or a class currently being
6149   //        defined, the set of member candidates is the result of the
6150   //        qualified lookup of T1::operator@ (13.3.1.1.1); otherwise,
6151   //        the set of member candidates is empty.
6152   if (const RecordType *T1Rec = T1->getAs<RecordType>()) {
6153     // Complete the type if it can be completed.
6154     RequireCompleteType(OpLoc, T1, 0);
6155     // If the type is neither complete nor being defined, bail out now.
6156     if (!T1Rec->getDecl()->getDefinition())
6157       return;
6158 
6159     LookupResult Operators(*this, OpName, OpLoc, LookupOrdinaryName);
6160     LookupQualifiedName(Operators, T1Rec->getDecl());
6161     Operators.suppressDiagnostics();
6162 
6163     for (LookupResult::iterator Oper = Operators.begin(),
6164                              OperEnd = Operators.end();
6165          Oper != OperEnd;
6166          ++Oper)
6167       AddMethodCandidate(Oper.getPair(), Args[0]->getType(),
6168                          Args[0]->Classify(Context),
6169                          Args.slice(1),
6170                          CandidateSet,
6171                          /* SuppressUserConversions = */ false);
6172   }
6173 }
6174 
6175 /// AddBuiltinCandidate - Add a candidate for a built-in
6176 /// operator. ResultTy and ParamTys are the result and parameter types
6177 /// of the built-in candidate, respectively. Args and NumArgs are the
6178 /// arguments being passed to the candidate. IsAssignmentOperator
6179 /// should be true when this built-in candidate is an assignment
6180 /// operator. NumContextualBoolArguments is the number of arguments
6181 /// (at the beginning of the argument list) that will be contextually
6182 /// converted to bool.
6183 void Sema::AddBuiltinCandidate(QualType ResultTy, QualType *ParamTys,
6184                                ArrayRef<Expr *> Args,
6185                                OverloadCandidateSet& CandidateSet,
6186                                bool IsAssignmentOperator,
6187                                unsigned NumContextualBoolArguments) {
6188   // Overload resolution is always an unevaluated context.
6189   EnterExpressionEvaluationContext Unevaluated(*this, Sema::Unevaluated);
6190 
6191   // Add this candidate
6192   OverloadCandidate &Candidate = CandidateSet.addCandidate(Args.size());
6193   Candidate.FoundDecl = DeclAccessPair::make(0, AS_none);
6194   Candidate.Function = 0;
6195   Candidate.IsSurrogate = false;
6196   Candidate.IgnoreObjectArgument = false;
6197   Candidate.BuiltinTypes.ResultTy = ResultTy;
6198   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx)
6199     Candidate.BuiltinTypes.ParamTypes[ArgIdx] = ParamTys[ArgIdx];
6200 
6201   // Determine the implicit conversion sequences for each of the
6202   // arguments.
6203   Candidate.Viable = true;
6204   Candidate.ExplicitCallArguments = Args.size();
6205   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
6206     // C++ [over.match.oper]p4:
6207     //   For the built-in assignment operators, conversions of the
6208     //   left operand are restricted as follows:
6209     //     -- no temporaries are introduced to hold the left operand, and
6210     //     -- no user-defined conversions are applied to the left
6211     //        operand to achieve a type match with the left-most
6212     //        parameter of a built-in candidate.
6213     //
6214     // We block these conversions by turning off user-defined
6215     // conversions, since that is the only way that initialization of
6216     // a reference to a non-class type can occur from something that
6217     // is not of the same type.
6218     if (ArgIdx < NumContextualBoolArguments) {
6219       assert(ParamTys[ArgIdx] == Context.BoolTy &&
6220              "Contextual conversion to bool requires bool type");
6221       Candidate.Conversions[ArgIdx]
6222         = TryContextuallyConvertToBool(*this, Args[ArgIdx]);
6223     } else {
6224       Candidate.Conversions[ArgIdx]
6225         = TryCopyInitialization(*this, Args[ArgIdx], ParamTys[ArgIdx],
6226                                 ArgIdx == 0 && IsAssignmentOperator,
6227                                 /*InOverloadResolution=*/false,
6228                                 /*AllowObjCWritebackConversion=*/
6229                                   getLangOpts().ObjCAutoRefCount);
6230     }
6231     if (Candidate.Conversions[ArgIdx].isBad()) {
6232       Candidate.Viable = false;
6233       Candidate.FailureKind = ovl_fail_bad_conversion;
6234       break;
6235     }
6236   }
6237 }
6238 
6239 /// BuiltinCandidateTypeSet - A set of types that will be used for the
6240 /// candidate operator functions for built-in operators (C++
6241 /// [over.built]). The types are separated into pointer types and
6242 /// enumeration types.
6243 class BuiltinCandidateTypeSet  {
6244   /// TypeSet - A set of types.
6245   typedef llvm::SmallPtrSet<QualType, 8> TypeSet;
6246 
6247   /// PointerTypes - The set of pointer types that will be used in the
6248   /// built-in candidates.
6249   TypeSet PointerTypes;
6250 
6251   /// MemberPointerTypes - The set of member pointer types that will be
6252   /// used in the built-in candidates.
6253   TypeSet MemberPointerTypes;
6254 
6255   /// EnumerationTypes - The set of enumeration types that will be
6256   /// used in the built-in candidates.
6257   TypeSet EnumerationTypes;
6258 
6259   /// \brief The set of vector types that will be used in the built-in
6260   /// candidates.
6261   TypeSet VectorTypes;
6262 
6263   /// \brief A flag indicating non-record types are viable candidates
6264   bool HasNonRecordTypes;
6265 
6266   /// \brief A flag indicating whether either arithmetic or enumeration types
6267   /// were present in the candidate set.
6268   bool HasArithmeticOrEnumeralTypes;
6269 
6270   /// \brief A flag indicating whether the nullptr type was present in the
6271   /// candidate set.
6272   bool HasNullPtrType;
6273 
6274   /// Sema - The semantic analysis instance where we are building the
6275   /// candidate type set.
6276   Sema &SemaRef;
6277 
6278   /// Context - The AST context in which we will build the type sets.
6279   ASTContext &Context;
6280 
6281   bool AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
6282                                                const Qualifiers &VisibleQuals);
6283   bool AddMemberPointerWithMoreQualifiedTypeVariants(QualType Ty);
6284 
6285 public:
6286   /// iterator - Iterates through the types that are part of the set.
6287   typedef TypeSet::iterator iterator;
6288 
6289   BuiltinCandidateTypeSet(Sema &SemaRef)
6290     : HasNonRecordTypes(false),
6291       HasArithmeticOrEnumeralTypes(false),
6292       HasNullPtrType(false),
6293       SemaRef(SemaRef),
6294       Context(SemaRef.Context) { }
6295 
6296   void AddTypesConvertedFrom(QualType Ty,
6297                              SourceLocation Loc,
6298                              bool AllowUserConversions,
6299                              bool AllowExplicitConversions,
6300                              const Qualifiers &VisibleTypeConversionsQuals);
6301 
6302   /// pointer_begin - First pointer type found;
6303   iterator pointer_begin() { return PointerTypes.begin(); }
6304 
6305   /// pointer_end - Past the last pointer type found;
6306   iterator pointer_end() { return PointerTypes.end(); }
6307 
6308   /// member_pointer_begin - First member pointer type found;
6309   iterator member_pointer_begin() { return MemberPointerTypes.begin(); }
6310 
6311   /// member_pointer_end - Past the last member pointer type found;
6312   iterator member_pointer_end() { return MemberPointerTypes.end(); }
6313 
6314   /// enumeration_begin - First enumeration type found;
6315   iterator enumeration_begin() { return EnumerationTypes.begin(); }
6316 
6317   /// enumeration_end - Past the last enumeration type found;
6318   iterator enumeration_end() { return EnumerationTypes.end(); }
6319 
6320   iterator vector_begin() { return VectorTypes.begin(); }
6321   iterator vector_end() { return VectorTypes.end(); }
6322 
6323   bool hasNonRecordTypes() { return HasNonRecordTypes; }
6324   bool hasArithmeticOrEnumeralTypes() { return HasArithmeticOrEnumeralTypes; }
6325   bool hasNullPtrType() const { return HasNullPtrType; }
6326 };
6327 
6328 /// AddPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty to
6329 /// the set of pointer types along with any more-qualified variants of
6330 /// that type. For example, if @p Ty is "int const *", this routine
6331 /// will add "int const *", "int const volatile *", "int const
6332 /// restrict *", and "int const volatile restrict *" to the set of
6333 /// pointer types. Returns true if the add of @p Ty itself succeeded,
6334 /// false otherwise.
6335 ///
6336 /// FIXME: what to do about extended qualifiers?
6337 bool
6338 BuiltinCandidateTypeSet::AddPointerWithMoreQualifiedTypeVariants(QualType Ty,
6339                                              const Qualifiers &VisibleQuals) {
6340 
6341   // Insert this type.
6342   if (!PointerTypes.insert(Ty))
6343     return false;
6344 
6345   QualType PointeeTy;
6346   const PointerType *PointerTy = Ty->getAs<PointerType>();
6347   bool buildObjCPtr = false;
6348   if (!PointerTy) {
6349     const ObjCObjectPointerType *PTy = Ty->castAs<ObjCObjectPointerType>();
6350     PointeeTy = PTy->getPointeeType();
6351     buildObjCPtr = true;
6352   } else {
6353     PointeeTy = PointerTy->getPointeeType();
6354   }
6355 
6356   // Don't add qualified variants of arrays. For one, they're not allowed
6357   // (the qualifier would sink to the element type), and for another, the
6358   // only overload situation where it matters is subscript or pointer +- int,
6359   // and those shouldn't have qualifier variants anyway.
6360   if (PointeeTy->isArrayType())
6361     return true;
6362 
6363   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
6364   bool hasVolatile = VisibleQuals.hasVolatile();
6365   bool hasRestrict = VisibleQuals.hasRestrict();
6366 
6367   // Iterate through all strict supersets of BaseCVR.
6368   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
6369     if ((CVR | BaseCVR) != CVR) continue;
6370     // Skip over volatile if no volatile found anywhere in the types.
6371     if ((CVR & Qualifiers::Volatile) && !hasVolatile) continue;
6372 
6373     // Skip over restrict if no restrict found anywhere in the types, or if
6374     // the type cannot be restrict-qualified.
6375     if ((CVR & Qualifiers::Restrict) &&
6376         (!hasRestrict ||
6377          (!(PointeeTy->isAnyPointerType() || PointeeTy->isReferenceType()))))
6378       continue;
6379 
6380     // Build qualified pointee type.
6381     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
6382 
6383     // Build qualified pointer type.
6384     QualType QPointerTy;
6385     if (!buildObjCPtr)
6386       QPointerTy = Context.getPointerType(QPointeeTy);
6387     else
6388       QPointerTy = Context.getObjCObjectPointerType(QPointeeTy);
6389 
6390     // Insert qualified pointer type.
6391     PointerTypes.insert(QPointerTy);
6392   }
6393 
6394   return true;
6395 }
6396 
6397 /// AddMemberPointerWithMoreQualifiedTypeVariants - Add the pointer type @p Ty
6398 /// to the set of pointer types along with any more-qualified variants of
6399 /// that type. For example, if @p Ty is "int const *", this routine
6400 /// will add "int const *", "int const volatile *", "int const
6401 /// restrict *", and "int const volatile restrict *" to the set of
6402 /// pointer types. Returns true if the add of @p Ty itself succeeded,
6403 /// false otherwise.
6404 ///
6405 /// FIXME: what to do about extended qualifiers?
6406 bool
6407 BuiltinCandidateTypeSet::AddMemberPointerWithMoreQualifiedTypeVariants(
6408     QualType Ty) {
6409   // Insert this type.
6410   if (!MemberPointerTypes.insert(Ty))
6411     return false;
6412 
6413   const MemberPointerType *PointerTy = Ty->getAs<MemberPointerType>();
6414   assert(PointerTy && "type was not a member pointer type!");
6415 
6416   QualType PointeeTy = PointerTy->getPointeeType();
6417   // Don't add qualified variants of arrays. For one, they're not allowed
6418   // (the qualifier would sink to the element type), and for another, the
6419   // only overload situation where it matters is subscript or pointer +- int,
6420   // and those shouldn't have qualifier variants anyway.
6421   if (PointeeTy->isArrayType())
6422     return true;
6423   const Type *ClassTy = PointerTy->getClass();
6424 
6425   // Iterate through all strict supersets of the pointee type's CVR
6426   // qualifiers.
6427   unsigned BaseCVR = PointeeTy.getCVRQualifiers();
6428   for (unsigned CVR = BaseCVR+1; CVR <= Qualifiers::CVRMask; ++CVR) {
6429     if ((CVR | BaseCVR) != CVR) continue;
6430 
6431     QualType QPointeeTy = Context.getCVRQualifiedType(PointeeTy, CVR);
6432     MemberPointerTypes.insert(
6433       Context.getMemberPointerType(QPointeeTy, ClassTy));
6434   }
6435 
6436   return true;
6437 }
6438 
6439 /// AddTypesConvertedFrom - Add each of the types to which the type @p
6440 /// Ty can be implicit converted to the given set of @p Types. We're
6441 /// primarily interested in pointer types and enumeration types. We also
6442 /// take member pointer types, for the conditional operator.
6443 /// AllowUserConversions is true if we should look at the conversion
6444 /// functions of a class type, and AllowExplicitConversions if we
6445 /// should also include the explicit conversion functions of a class
6446 /// type.
6447 void
6448 BuiltinCandidateTypeSet::AddTypesConvertedFrom(QualType Ty,
6449                                                SourceLocation Loc,
6450                                                bool AllowUserConversions,
6451                                                bool AllowExplicitConversions,
6452                                                const Qualifiers &VisibleQuals) {
6453   // Only deal with canonical types.
6454   Ty = Context.getCanonicalType(Ty);
6455 
6456   // Look through reference types; they aren't part of the type of an
6457   // expression for the purposes of conversions.
6458   if (const ReferenceType *RefTy = Ty->getAs<ReferenceType>())
6459     Ty = RefTy->getPointeeType();
6460 
6461   // If we're dealing with an array type, decay to the pointer.
6462   if (Ty->isArrayType())
6463     Ty = SemaRef.Context.getArrayDecayedType(Ty);
6464 
6465   // Otherwise, we don't care about qualifiers on the type.
6466   Ty = Ty.getLocalUnqualifiedType();
6467 
6468   // Flag if we ever add a non-record type.
6469   const RecordType *TyRec = Ty->getAs<RecordType>();
6470   HasNonRecordTypes = HasNonRecordTypes || !TyRec;
6471 
6472   // Flag if we encounter an arithmetic type.
6473   HasArithmeticOrEnumeralTypes =
6474     HasArithmeticOrEnumeralTypes || Ty->isArithmeticType();
6475 
6476   if (Ty->isObjCIdType() || Ty->isObjCClassType())
6477     PointerTypes.insert(Ty);
6478   else if (Ty->getAs<PointerType>() || Ty->getAs<ObjCObjectPointerType>()) {
6479     // Insert our type, and its more-qualified variants, into the set
6480     // of types.
6481     if (!AddPointerWithMoreQualifiedTypeVariants(Ty, VisibleQuals))
6482       return;
6483   } else if (Ty->isMemberPointerType()) {
6484     // Member pointers are far easier, since the pointee can't be converted.
6485     if (!AddMemberPointerWithMoreQualifiedTypeVariants(Ty))
6486       return;
6487   } else if (Ty->isEnumeralType()) {
6488     HasArithmeticOrEnumeralTypes = true;
6489     EnumerationTypes.insert(Ty);
6490   } else if (Ty->isVectorType()) {
6491     // We treat vector types as arithmetic types in many contexts as an
6492     // extension.
6493     HasArithmeticOrEnumeralTypes = true;
6494     VectorTypes.insert(Ty);
6495   } else if (Ty->isNullPtrType()) {
6496     HasNullPtrType = true;
6497   } else if (AllowUserConversions && TyRec) {
6498     // No conversion functions in incomplete types.
6499     if (SemaRef.RequireCompleteType(Loc, Ty, 0))
6500       return;
6501 
6502     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
6503     std::pair<CXXRecordDecl::conversion_iterator,
6504               CXXRecordDecl::conversion_iterator>
6505       Conversions = ClassDecl->getVisibleConversionFunctions();
6506     for (CXXRecordDecl::conversion_iterator
6507            I = Conversions.first, E = Conversions.second; I != E; ++I) {
6508       NamedDecl *D = I.getDecl();
6509       if (isa<UsingShadowDecl>(D))
6510         D = cast<UsingShadowDecl>(D)->getTargetDecl();
6511 
6512       // Skip conversion function templates; they don't tell us anything
6513       // about which builtin types we can convert to.
6514       if (isa<FunctionTemplateDecl>(D))
6515         continue;
6516 
6517       CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
6518       if (AllowExplicitConversions || !Conv->isExplicit()) {
6519         AddTypesConvertedFrom(Conv->getConversionType(), Loc, false, false,
6520                               VisibleQuals);
6521       }
6522     }
6523   }
6524 }
6525 
6526 /// \brief Helper function for AddBuiltinOperatorCandidates() that adds
6527 /// the volatile- and non-volatile-qualified assignment operators for the
6528 /// given type to the candidate set.
6529 static void AddBuiltinAssignmentOperatorCandidates(Sema &S,
6530                                                    QualType T,
6531                                                    ArrayRef<Expr *> Args,
6532                                     OverloadCandidateSet &CandidateSet) {
6533   QualType ParamTypes[2];
6534 
6535   // T& operator=(T&, T)
6536   ParamTypes[0] = S.Context.getLValueReferenceType(T);
6537   ParamTypes[1] = T;
6538   S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
6539                         /*IsAssignmentOperator=*/true);
6540 
6541   if (!S.Context.getCanonicalType(T).isVolatileQualified()) {
6542     // volatile T& operator=(volatile T&, T)
6543     ParamTypes[0]
6544       = S.Context.getLValueReferenceType(S.Context.getVolatileType(T));
6545     ParamTypes[1] = T;
6546     S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
6547                           /*IsAssignmentOperator=*/true);
6548   }
6549 }
6550 
6551 /// CollectVRQualifiers - This routine returns Volatile/Restrict qualifiers,
6552 /// if any, found in visible type conversion functions found in ArgExpr's type.
6553 static  Qualifiers CollectVRQualifiers(ASTContext &Context, Expr* ArgExpr) {
6554     Qualifiers VRQuals;
6555     const RecordType *TyRec;
6556     if (const MemberPointerType *RHSMPType =
6557         ArgExpr->getType()->getAs<MemberPointerType>())
6558       TyRec = RHSMPType->getClass()->getAs<RecordType>();
6559     else
6560       TyRec = ArgExpr->getType()->getAs<RecordType>();
6561     if (!TyRec) {
6562       // Just to be safe, assume the worst case.
6563       VRQuals.addVolatile();
6564       VRQuals.addRestrict();
6565       return VRQuals;
6566     }
6567 
6568     CXXRecordDecl *ClassDecl = cast<CXXRecordDecl>(TyRec->getDecl());
6569     if (!ClassDecl->hasDefinition())
6570       return VRQuals;
6571 
6572     std::pair<CXXRecordDecl::conversion_iterator,
6573               CXXRecordDecl::conversion_iterator>
6574       Conversions = ClassDecl->getVisibleConversionFunctions();
6575 
6576     for (CXXRecordDecl::conversion_iterator
6577            I = Conversions.first, E = Conversions.second; I != E; ++I) {
6578       NamedDecl *D = I.getDecl();
6579       if (isa<UsingShadowDecl>(D))
6580         D = cast<UsingShadowDecl>(D)->getTargetDecl();
6581       if (CXXConversionDecl *Conv = dyn_cast<CXXConversionDecl>(D)) {
6582         QualType CanTy = Context.getCanonicalType(Conv->getConversionType());
6583         if (const ReferenceType *ResTypeRef = CanTy->getAs<ReferenceType>())
6584           CanTy = ResTypeRef->getPointeeType();
6585         // Need to go down the pointer/mempointer chain and add qualifiers
6586         // as see them.
6587         bool done = false;
6588         while (!done) {
6589           if (CanTy.isRestrictQualified())
6590             VRQuals.addRestrict();
6591           if (const PointerType *ResTypePtr = CanTy->getAs<PointerType>())
6592             CanTy = ResTypePtr->getPointeeType();
6593           else if (const MemberPointerType *ResTypeMPtr =
6594                 CanTy->getAs<MemberPointerType>())
6595             CanTy = ResTypeMPtr->getPointeeType();
6596           else
6597             done = true;
6598           if (CanTy.isVolatileQualified())
6599             VRQuals.addVolatile();
6600           if (VRQuals.hasRestrict() && VRQuals.hasVolatile())
6601             return VRQuals;
6602         }
6603       }
6604     }
6605     return VRQuals;
6606 }
6607 
6608 namespace {
6609 
6610 /// \brief Helper class to manage the addition of builtin operator overload
6611 /// candidates. It provides shared state and utility methods used throughout
6612 /// the process, as well as a helper method to add each group of builtin
6613 /// operator overloads from the standard to a candidate set.
6614 class BuiltinOperatorOverloadBuilder {
6615   // Common instance state available to all overload candidate addition methods.
6616   Sema &S;
6617   ArrayRef<Expr *> Args;
6618   Qualifiers VisibleTypeConversionsQuals;
6619   bool HasArithmeticOrEnumeralCandidateType;
6620   SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes;
6621   OverloadCandidateSet &CandidateSet;
6622 
6623   // Define some constants used to index and iterate over the arithemetic types
6624   // provided via the getArithmeticType() method below.
6625   // The "promoted arithmetic types" are the arithmetic
6626   // types are that preserved by promotion (C++ [over.built]p2).
6627   static const unsigned FirstIntegralType = 3;
6628   static const unsigned LastIntegralType = 20;
6629   static const unsigned FirstPromotedIntegralType = 3,
6630                         LastPromotedIntegralType = 11;
6631   static const unsigned FirstPromotedArithmeticType = 0,
6632                         LastPromotedArithmeticType = 11;
6633   static const unsigned NumArithmeticTypes = 20;
6634 
6635   /// \brief Get the canonical type for a given arithmetic type index.
6636   CanQualType getArithmeticType(unsigned index) {
6637     assert(index < NumArithmeticTypes);
6638     static CanQualType ASTContext::* const
6639       ArithmeticTypes[NumArithmeticTypes] = {
6640       // Start of promoted types.
6641       &ASTContext::FloatTy,
6642       &ASTContext::DoubleTy,
6643       &ASTContext::LongDoubleTy,
6644 
6645       // Start of integral types.
6646       &ASTContext::IntTy,
6647       &ASTContext::LongTy,
6648       &ASTContext::LongLongTy,
6649       &ASTContext::Int128Ty,
6650       &ASTContext::UnsignedIntTy,
6651       &ASTContext::UnsignedLongTy,
6652       &ASTContext::UnsignedLongLongTy,
6653       &ASTContext::UnsignedInt128Ty,
6654       // End of promoted types.
6655 
6656       &ASTContext::BoolTy,
6657       &ASTContext::CharTy,
6658       &ASTContext::WCharTy,
6659       &ASTContext::Char16Ty,
6660       &ASTContext::Char32Ty,
6661       &ASTContext::SignedCharTy,
6662       &ASTContext::ShortTy,
6663       &ASTContext::UnsignedCharTy,
6664       &ASTContext::UnsignedShortTy,
6665       // End of integral types.
6666       // FIXME: What about complex? What about half?
6667     };
6668     return S.Context.*ArithmeticTypes[index];
6669   }
6670 
6671   /// \brief Gets the canonical type resulting from the usual arithemetic
6672   /// converions for the given arithmetic types.
6673   CanQualType getUsualArithmeticConversions(unsigned L, unsigned R) {
6674     // Accelerator table for performing the usual arithmetic conversions.
6675     // The rules are basically:
6676     //   - if either is floating-point, use the wider floating-point
6677     //   - if same signedness, use the higher rank
6678     //   - if same size, use unsigned of the higher rank
6679     //   - use the larger type
6680     // These rules, together with the axiom that higher ranks are
6681     // never smaller, are sufficient to precompute all of these results
6682     // *except* when dealing with signed types of higher rank.
6683     // (we could precompute SLL x UI for all known platforms, but it's
6684     // better not to make any assumptions).
6685     // We assume that int128 has a higher rank than long long on all platforms.
6686     enum PromotedType {
6687             Dep=-1,
6688             Flt,  Dbl, LDbl,   SI,   SL,  SLL, S128,   UI,   UL,  ULL, U128
6689     };
6690     static const PromotedType ConversionsTable[LastPromotedArithmeticType]
6691                                         [LastPromotedArithmeticType] = {
6692 /* Flt*/ {  Flt,  Dbl, LDbl,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt,  Flt },
6693 /* Dbl*/ {  Dbl,  Dbl, LDbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl,  Dbl },
6694 /*LDbl*/ { LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl, LDbl },
6695 /*  SI*/ {  Flt,  Dbl, LDbl,   SI,   SL,  SLL, S128,   UI,   UL,  ULL, U128 },
6696 /*  SL*/ {  Flt,  Dbl, LDbl,   SL,   SL,  SLL, S128,  Dep,   UL,  ULL, U128 },
6697 /* SLL*/ {  Flt,  Dbl, LDbl,  SLL,  SLL,  SLL, S128,  Dep,  Dep,  ULL, U128 },
6698 /*S128*/ {  Flt,  Dbl, LDbl, S128, S128, S128, S128, S128, S128, S128, U128 },
6699 /*  UI*/ {  Flt,  Dbl, LDbl,   UI,  Dep,  Dep, S128,   UI,   UL,  ULL, U128 },
6700 /*  UL*/ {  Flt,  Dbl, LDbl,   UL,   UL,  Dep, S128,   UL,   UL,  ULL, U128 },
6701 /* ULL*/ {  Flt,  Dbl, LDbl,  ULL,  ULL,  ULL, S128,  ULL,  ULL,  ULL, U128 },
6702 /*U128*/ {  Flt,  Dbl, LDbl, U128, U128, U128, U128, U128, U128, U128, U128 },
6703     };
6704 
6705     assert(L < LastPromotedArithmeticType);
6706     assert(R < LastPromotedArithmeticType);
6707     int Idx = ConversionsTable[L][R];
6708 
6709     // Fast path: the table gives us a concrete answer.
6710     if (Idx != Dep) return getArithmeticType(Idx);
6711 
6712     // Slow path: we need to compare widths.
6713     // An invariant is that the signed type has higher rank.
6714     CanQualType LT = getArithmeticType(L),
6715                 RT = getArithmeticType(R);
6716     unsigned LW = S.Context.getIntWidth(LT),
6717              RW = S.Context.getIntWidth(RT);
6718 
6719     // If they're different widths, use the signed type.
6720     if (LW > RW) return LT;
6721     else if (LW < RW) return RT;
6722 
6723     // Otherwise, use the unsigned type of the signed type's rank.
6724     if (L == SL || R == SL) return S.Context.UnsignedLongTy;
6725     assert(L == SLL || R == SLL);
6726     return S.Context.UnsignedLongLongTy;
6727   }
6728 
6729   /// \brief Helper method to factor out the common pattern of adding overloads
6730   /// for '++' and '--' builtin operators.
6731   void addPlusPlusMinusMinusStyleOverloads(QualType CandidateTy,
6732                                            bool HasVolatile,
6733                                            bool HasRestrict) {
6734     QualType ParamTypes[2] = {
6735       S.Context.getLValueReferenceType(CandidateTy),
6736       S.Context.IntTy
6737     };
6738 
6739     // Non-volatile version.
6740     if (Args.size() == 1)
6741       S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
6742     else
6743       S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
6744 
6745     // Use a heuristic to reduce number of builtin candidates in the set:
6746     // add volatile version only if there are conversions to a volatile type.
6747     if (HasVolatile) {
6748       ParamTypes[0] =
6749         S.Context.getLValueReferenceType(
6750           S.Context.getVolatileType(CandidateTy));
6751       if (Args.size() == 1)
6752         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
6753       else
6754         S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
6755     }
6756 
6757     // Add restrict version only if there are conversions to a restrict type
6758     // and our candidate type is a non-restrict-qualified pointer.
6759     if (HasRestrict && CandidateTy->isAnyPointerType() &&
6760         !CandidateTy.isRestrictQualified()) {
6761       ParamTypes[0]
6762         = S.Context.getLValueReferenceType(
6763             S.Context.getCVRQualifiedType(CandidateTy, Qualifiers::Restrict));
6764       if (Args.size() == 1)
6765         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
6766       else
6767         S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
6768 
6769       if (HasVolatile) {
6770         ParamTypes[0]
6771           = S.Context.getLValueReferenceType(
6772               S.Context.getCVRQualifiedType(CandidateTy,
6773                                             (Qualifiers::Volatile |
6774                                              Qualifiers::Restrict)));
6775         if (Args.size() == 1)
6776           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
6777         else
6778           S.AddBuiltinCandidate(CandidateTy, ParamTypes, Args, CandidateSet);
6779       }
6780     }
6781 
6782   }
6783 
6784 public:
6785   BuiltinOperatorOverloadBuilder(
6786     Sema &S, ArrayRef<Expr *> Args,
6787     Qualifiers VisibleTypeConversionsQuals,
6788     bool HasArithmeticOrEnumeralCandidateType,
6789     SmallVectorImpl<BuiltinCandidateTypeSet> &CandidateTypes,
6790     OverloadCandidateSet &CandidateSet)
6791     : S(S), Args(Args),
6792       VisibleTypeConversionsQuals(VisibleTypeConversionsQuals),
6793       HasArithmeticOrEnumeralCandidateType(
6794         HasArithmeticOrEnumeralCandidateType),
6795       CandidateTypes(CandidateTypes),
6796       CandidateSet(CandidateSet) {
6797     // Validate some of our static helper constants in debug builds.
6798     assert(getArithmeticType(FirstPromotedIntegralType) == S.Context.IntTy &&
6799            "Invalid first promoted integral type");
6800     assert(getArithmeticType(LastPromotedIntegralType - 1)
6801              == S.Context.UnsignedInt128Ty &&
6802            "Invalid last promoted integral type");
6803     assert(getArithmeticType(FirstPromotedArithmeticType)
6804              == S.Context.FloatTy &&
6805            "Invalid first promoted arithmetic type");
6806     assert(getArithmeticType(LastPromotedArithmeticType - 1)
6807              == S.Context.UnsignedInt128Ty &&
6808            "Invalid last promoted arithmetic type");
6809   }
6810 
6811   // C++ [over.built]p3:
6812   //
6813   //   For every pair (T, VQ), where T is an arithmetic type, and VQ
6814   //   is either volatile or empty, there exist candidate operator
6815   //   functions of the form
6816   //
6817   //       VQ T&      operator++(VQ T&);
6818   //       T          operator++(VQ T&, int);
6819   //
6820   // C++ [over.built]p4:
6821   //
6822   //   For every pair (T, VQ), where T is an arithmetic type other
6823   //   than bool, and VQ is either volatile or empty, there exist
6824   //   candidate operator functions of the form
6825   //
6826   //       VQ T&      operator--(VQ T&);
6827   //       T          operator--(VQ T&, int);
6828   void addPlusPlusMinusMinusArithmeticOverloads(OverloadedOperatorKind Op) {
6829     if (!HasArithmeticOrEnumeralCandidateType)
6830       return;
6831 
6832     for (unsigned Arith = (Op == OO_PlusPlus? 0 : 1);
6833          Arith < NumArithmeticTypes; ++Arith) {
6834       addPlusPlusMinusMinusStyleOverloads(
6835         getArithmeticType(Arith),
6836         VisibleTypeConversionsQuals.hasVolatile(),
6837         VisibleTypeConversionsQuals.hasRestrict());
6838     }
6839   }
6840 
6841   // C++ [over.built]p5:
6842   //
6843   //   For every pair (T, VQ), where T is a cv-qualified or
6844   //   cv-unqualified object type, and VQ is either volatile or
6845   //   empty, there exist candidate operator functions of the form
6846   //
6847   //       T*VQ&      operator++(T*VQ&);
6848   //       T*VQ&      operator--(T*VQ&);
6849   //       T*         operator++(T*VQ&, int);
6850   //       T*         operator--(T*VQ&, int);
6851   void addPlusPlusMinusMinusPointerOverloads() {
6852     for (BuiltinCandidateTypeSet::iterator
6853               Ptr = CandidateTypes[0].pointer_begin(),
6854            PtrEnd = CandidateTypes[0].pointer_end();
6855          Ptr != PtrEnd; ++Ptr) {
6856       // Skip pointer types that aren't pointers to object types.
6857       if (!(*Ptr)->getPointeeType()->isObjectType())
6858         continue;
6859 
6860       addPlusPlusMinusMinusStyleOverloads(*Ptr,
6861         (!(*Ptr).isVolatileQualified() &&
6862          VisibleTypeConversionsQuals.hasVolatile()),
6863         (!(*Ptr).isRestrictQualified() &&
6864          VisibleTypeConversionsQuals.hasRestrict()));
6865     }
6866   }
6867 
6868   // C++ [over.built]p6:
6869   //   For every cv-qualified or cv-unqualified object type T, there
6870   //   exist candidate operator functions of the form
6871   //
6872   //       T&         operator*(T*);
6873   //
6874   // C++ [over.built]p7:
6875   //   For every function type T that does not have cv-qualifiers or a
6876   //   ref-qualifier, there exist candidate operator functions of the form
6877   //       T&         operator*(T*);
6878   void addUnaryStarPointerOverloads() {
6879     for (BuiltinCandidateTypeSet::iterator
6880               Ptr = CandidateTypes[0].pointer_begin(),
6881            PtrEnd = CandidateTypes[0].pointer_end();
6882          Ptr != PtrEnd; ++Ptr) {
6883       QualType ParamTy = *Ptr;
6884       QualType PointeeTy = ParamTy->getPointeeType();
6885       if (!PointeeTy->isObjectType() && !PointeeTy->isFunctionType())
6886         continue;
6887 
6888       if (const FunctionProtoType *Proto =PointeeTy->getAs<FunctionProtoType>())
6889         if (Proto->getTypeQuals() || Proto->getRefQualifier())
6890           continue;
6891 
6892       S.AddBuiltinCandidate(S.Context.getLValueReferenceType(PointeeTy),
6893                             &ParamTy, Args, CandidateSet);
6894     }
6895   }
6896 
6897   // C++ [over.built]p9:
6898   //  For every promoted arithmetic type T, there exist candidate
6899   //  operator functions of the form
6900   //
6901   //       T         operator+(T);
6902   //       T         operator-(T);
6903   void addUnaryPlusOrMinusArithmeticOverloads() {
6904     if (!HasArithmeticOrEnumeralCandidateType)
6905       return;
6906 
6907     for (unsigned Arith = FirstPromotedArithmeticType;
6908          Arith < LastPromotedArithmeticType; ++Arith) {
6909       QualType ArithTy = getArithmeticType(Arith);
6910       S.AddBuiltinCandidate(ArithTy, &ArithTy, Args, CandidateSet);
6911     }
6912 
6913     // Extension: We also add these operators for vector types.
6914     for (BuiltinCandidateTypeSet::iterator
6915               Vec = CandidateTypes[0].vector_begin(),
6916            VecEnd = CandidateTypes[0].vector_end();
6917          Vec != VecEnd; ++Vec) {
6918       QualType VecTy = *Vec;
6919       S.AddBuiltinCandidate(VecTy, &VecTy, Args, CandidateSet);
6920     }
6921   }
6922 
6923   // C++ [over.built]p8:
6924   //   For every type T, there exist candidate operator functions of
6925   //   the form
6926   //
6927   //       T*         operator+(T*);
6928   void addUnaryPlusPointerOverloads() {
6929     for (BuiltinCandidateTypeSet::iterator
6930               Ptr = CandidateTypes[0].pointer_begin(),
6931            PtrEnd = CandidateTypes[0].pointer_end();
6932          Ptr != PtrEnd; ++Ptr) {
6933       QualType ParamTy = *Ptr;
6934       S.AddBuiltinCandidate(ParamTy, &ParamTy, Args, CandidateSet);
6935     }
6936   }
6937 
6938   // C++ [over.built]p10:
6939   //   For every promoted integral type T, there exist candidate
6940   //   operator functions of the form
6941   //
6942   //        T         operator~(T);
6943   void addUnaryTildePromotedIntegralOverloads() {
6944     if (!HasArithmeticOrEnumeralCandidateType)
6945       return;
6946 
6947     for (unsigned Int = FirstPromotedIntegralType;
6948          Int < LastPromotedIntegralType; ++Int) {
6949       QualType IntTy = getArithmeticType(Int);
6950       S.AddBuiltinCandidate(IntTy, &IntTy, Args, CandidateSet);
6951     }
6952 
6953     // Extension: We also add this operator for vector types.
6954     for (BuiltinCandidateTypeSet::iterator
6955               Vec = CandidateTypes[0].vector_begin(),
6956            VecEnd = CandidateTypes[0].vector_end();
6957          Vec != VecEnd; ++Vec) {
6958       QualType VecTy = *Vec;
6959       S.AddBuiltinCandidate(VecTy, &VecTy, Args, CandidateSet);
6960     }
6961   }
6962 
6963   // C++ [over.match.oper]p16:
6964   //   For every pointer to member type T, there exist candidate operator
6965   //   functions of the form
6966   //
6967   //        bool operator==(T,T);
6968   //        bool operator!=(T,T);
6969   void addEqualEqualOrNotEqualMemberPointerOverloads() {
6970     /// Set of (canonical) types that we've already handled.
6971     llvm::SmallPtrSet<QualType, 8> AddedTypes;
6972 
6973     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
6974       for (BuiltinCandidateTypeSet::iterator
6975                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
6976              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
6977            MemPtr != MemPtrEnd;
6978            ++MemPtr) {
6979         // Don't add the same builtin candidate twice.
6980         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
6981           continue;
6982 
6983         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
6984         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
6985       }
6986     }
6987   }
6988 
6989   // C++ [over.built]p15:
6990   //
6991   //   For every T, where T is an enumeration type, a pointer type, or
6992   //   std::nullptr_t, there exist candidate operator functions of the form
6993   //
6994   //        bool       operator<(T, T);
6995   //        bool       operator>(T, T);
6996   //        bool       operator<=(T, T);
6997   //        bool       operator>=(T, T);
6998   //        bool       operator==(T, T);
6999   //        bool       operator!=(T, T);
7000   void addRelationalPointerOrEnumeralOverloads() {
7001     // C++ [over.match.oper]p3:
7002     //   [...]the built-in candidates include all of the candidate operator
7003     //   functions defined in 13.6 that, compared to the given operator, [...]
7004     //   do not have the same parameter-type-list as any non-template non-member
7005     //   candidate.
7006     //
7007     // Note that in practice, this only affects enumeration types because there
7008     // aren't any built-in candidates of record type, and a user-defined operator
7009     // must have an operand of record or enumeration type. Also, the only other
7010     // overloaded operator with enumeration arguments, operator=,
7011     // cannot be overloaded for enumeration types, so this is the only place
7012     // where we must suppress candidates like this.
7013     llvm::DenseSet<std::pair<CanQualType, CanQualType> >
7014       UserDefinedBinaryOperators;
7015 
7016     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7017       if (CandidateTypes[ArgIdx].enumeration_begin() !=
7018           CandidateTypes[ArgIdx].enumeration_end()) {
7019         for (OverloadCandidateSet::iterator C = CandidateSet.begin(),
7020                                          CEnd = CandidateSet.end();
7021              C != CEnd; ++C) {
7022           if (!C->Viable || !C->Function || C->Function->getNumParams() != 2)
7023             continue;
7024 
7025           if (C->Function->isFunctionTemplateSpecialization())
7026             continue;
7027 
7028           QualType FirstParamType =
7029             C->Function->getParamDecl(0)->getType().getUnqualifiedType();
7030           QualType SecondParamType =
7031             C->Function->getParamDecl(1)->getType().getUnqualifiedType();
7032 
7033           // Skip if either parameter isn't of enumeral type.
7034           if (!FirstParamType->isEnumeralType() ||
7035               !SecondParamType->isEnumeralType())
7036             continue;
7037 
7038           // Add this operator to the set of known user-defined operators.
7039           UserDefinedBinaryOperators.insert(
7040             std::make_pair(S.Context.getCanonicalType(FirstParamType),
7041                            S.Context.getCanonicalType(SecondParamType)));
7042         }
7043       }
7044     }
7045 
7046     /// Set of (canonical) types that we've already handled.
7047     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7048 
7049     for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7050       for (BuiltinCandidateTypeSet::iterator
7051                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
7052              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
7053            Ptr != PtrEnd; ++Ptr) {
7054         // Don't add the same builtin candidate twice.
7055         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7056           continue;
7057 
7058         QualType ParamTypes[2] = { *Ptr, *Ptr };
7059         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
7060       }
7061       for (BuiltinCandidateTypeSet::iterator
7062                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7063              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7064            Enum != EnumEnd; ++Enum) {
7065         CanQualType CanonType = S.Context.getCanonicalType(*Enum);
7066 
7067         // Don't add the same builtin candidate twice, or if a user defined
7068         // candidate exists.
7069         if (!AddedTypes.insert(CanonType) ||
7070             UserDefinedBinaryOperators.count(std::make_pair(CanonType,
7071                                                             CanonType)))
7072           continue;
7073 
7074         QualType ParamTypes[2] = { *Enum, *Enum };
7075         S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet);
7076       }
7077 
7078       if (CandidateTypes[ArgIdx].hasNullPtrType()) {
7079         CanQualType NullPtrTy = S.Context.getCanonicalType(S.Context.NullPtrTy);
7080         if (AddedTypes.insert(NullPtrTy) &&
7081             !UserDefinedBinaryOperators.count(std::make_pair(NullPtrTy,
7082                                                              NullPtrTy))) {
7083           QualType ParamTypes[2] = { NullPtrTy, NullPtrTy };
7084           S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args,
7085                                 CandidateSet);
7086         }
7087       }
7088     }
7089   }
7090 
7091   // C++ [over.built]p13:
7092   //
7093   //   For every cv-qualified or cv-unqualified object type T
7094   //   there exist candidate operator functions of the form
7095   //
7096   //      T*         operator+(T*, ptrdiff_t);
7097   //      T&         operator[](T*, ptrdiff_t);    [BELOW]
7098   //      T*         operator-(T*, ptrdiff_t);
7099   //      T*         operator+(ptrdiff_t, T*);
7100   //      T&         operator[](ptrdiff_t, T*);    [BELOW]
7101   //
7102   // C++ [over.built]p14:
7103   //
7104   //   For every T, where T is a pointer to object type, there
7105   //   exist candidate operator functions of the form
7106   //
7107   //      ptrdiff_t  operator-(T, T);
7108   void addBinaryPlusOrMinusPointerOverloads(OverloadedOperatorKind Op) {
7109     /// Set of (canonical) types that we've already handled.
7110     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7111 
7112     for (int Arg = 0; Arg < 2; ++Arg) {
7113       QualType AsymetricParamTypes[2] = {
7114         S.Context.getPointerDiffType(),
7115         S.Context.getPointerDiffType(),
7116       };
7117       for (BuiltinCandidateTypeSet::iterator
7118                 Ptr = CandidateTypes[Arg].pointer_begin(),
7119              PtrEnd = CandidateTypes[Arg].pointer_end();
7120            Ptr != PtrEnd; ++Ptr) {
7121         QualType PointeeTy = (*Ptr)->getPointeeType();
7122         if (!PointeeTy->isObjectType())
7123           continue;
7124 
7125         AsymetricParamTypes[Arg] = *Ptr;
7126         if (Arg == 0 || Op == OO_Plus) {
7127           // operator+(T*, ptrdiff_t) or operator-(T*, ptrdiff_t)
7128           // T* operator+(ptrdiff_t, T*);
7129           S.AddBuiltinCandidate(*Ptr, AsymetricParamTypes, Args, CandidateSet);
7130         }
7131         if (Op == OO_Minus) {
7132           // ptrdiff_t operator-(T, T);
7133           if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7134             continue;
7135 
7136           QualType ParamTypes[2] = { *Ptr, *Ptr };
7137           S.AddBuiltinCandidate(S.Context.getPointerDiffType(), ParamTypes,
7138                                 Args, CandidateSet);
7139         }
7140       }
7141     }
7142   }
7143 
7144   // C++ [over.built]p12:
7145   //
7146   //   For every pair of promoted arithmetic types L and R, there
7147   //   exist candidate operator functions of the form
7148   //
7149   //        LR         operator*(L, R);
7150   //        LR         operator/(L, R);
7151   //        LR         operator+(L, R);
7152   //        LR         operator-(L, R);
7153   //        bool       operator<(L, R);
7154   //        bool       operator>(L, R);
7155   //        bool       operator<=(L, R);
7156   //        bool       operator>=(L, R);
7157   //        bool       operator==(L, R);
7158   //        bool       operator!=(L, R);
7159   //
7160   //   where LR is the result of the usual arithmetic conversions
7161   //   between types L and R.
7162   //
7163   // C++ [over.built]p24:
7164   //
7165   //   For every pair of promoted arithmetic types L and R, there exist
7166   //   candidate operator functions of the form
7167   //
7168   //        LR       operator?(bool, L, R);
7169   //
7170   //   where LR is the result of the usual arithmetic conversions
7171   //   between types L and R.
7172   // Our candidates ignore the first parameter.
7173   void addGenericBinaryArithmeticOverloads(bool isComparison) {
7174     if (!HasArithmeticOrEnumeralCandidateType)
7175       return;
7176 
7177     for (unsigned Left = FirstPromotedArithmeticType;
7178          Left < LastPromotedArithmeticType; ++Left) {
7179       for (unsigned Right = FirstPromotedArithmeticType;
7180            Right < LastPromotedArithmeticType; ++Right) {
7181         QualType LandR[2] = { getArithmeticType(Left),
7182                               getArithmeticType(Right) };
7183         QualType Result =
7184           isComparison ? S.Context.BoolTy
7185                        : getUsualArithmeticConversions(Left, Right);
7186         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7187       }
7188     }
7189 
7190     // Extension: Add the binary operators ==, !=, <, <=, >=, >, *, /, and the
7191     // conditional operator for vector types.
7192     for (BuiltinCandidateTypeSet::iterator
7193               Vec1 = CandidateTypes[0].vector_begin(),
7194            Vec1End = CandidateTypes[0].vector_end();
7195          Vec1 != Vec1End; ++Vec1) {
7196       for (BuiltinCandidateTypeSet::iterator
7197                 Vec2 = CandidateTypes[1].vector_begin(),
7198              Vec2End = CandidateTypes[1].vector_end();
7199            Vec2 != Vec2End; ++Vec2) {
7200         QualType LandR[2] = { *Vec1, *Vec2 };
7201         QualType Result = S.Context.BoolTy;
7202         if (!isComparison) {
7203           if ((*Vec1)->isExtVectorType() || !(*Vec2)->isExtVectorType())
7204             Result = *Vec1;
7205           else
7206             Result = *Vec2;
7207         }
7208 
7209         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7210       }
7211     }
7212   }
7213 
7214   // C++ [over.built]p17:
7215   //
7216   //   For every pair of promoted integral types L and R, there
7217   //   exist candidate operator functions of the form
7218   //
7219   //      LR         operator%(L, R);
7220   //      LR         operator&(L, R);
7221   //      LR         operator^(L, R);
7222   //      LR         operator|(L, R);
7223   //      L          operator<<(L, R);
7224   //      L          operator>>(L, R);
7225   //
7226   //   where LR is the result of the usual arithmetic conversions
7227   //   between types L and R.
7228   void addBinaryBitwiseArithmeticOverloads(OverloadedOperatorKind Op) {
7229     if (!HasArithmeticOrEnumeralCandidateType)
7230       return;
7231 
7232     for (unsigned Left = FirstPromotedIntegralType;
7233          Left < LastPromotedIntegralType; ++Left) {
7234       for (unsigned Right = FirstPromotedIntegralType;
7235            Right < LastPromotedIntegralType; ++Right) {
7236         QualType LandR[2] = { getArithmeticType(Left),
7237                               getArithmeticType(Right) };
7238         QualType Result = (Op == OO_LessLess || Op == OO_GreaterGreater)
7239             ? LandR[0]
7240             : getUsualArithmeticConversions(Left, Right);
7241         S.AddBuiltinCandidate(Result, LandR, Args, CandidateSet);
7242       }
7243     }
7244   }
7245 
7246   // C++ [over.built]p20:
7247   //
7248   //   For every pair (T, VQ), where T is an enumeration or
7249   //   pointer to member type and VQ is either volatile or
7250   //   empty, there exist candidate operator functions of the form
7251   //
7252   //        VQ T&      operator=(VQ T&, T);
7253   void addAssignmentMemberPointerOrEnumeralOverloads() {
7254     /// Set of (canonical) types that we've already handled.
7255     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7256 
7257     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
7258       for (BuiltinCandidateTypeSet::iterator
7259                 Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7260              EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7261            Enum != EnumEnd; ++Enum) {
7262         if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)))
7263           continue;
7264 
7265         AddBuiltinAssignmentOperatorCandidates(S, *Enum, Args, CandidateSet);
7266       }
7267 
7268       for (BuiltinCandidateTypeSet::iterator
7269                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
7270              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
7271            MemPtr != MemPtrEnd; ++MemPtr) {
7272         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
7273           continue;
7274 
7275         AddBuiltinAssignmentOperatorCandidates(S, *MemPtr, Args, CandidateSet);
7276       }
7277     }
7278   }
7279 
7280   // C++ [over.built]p19:
7281   //
7282   //   For every pair (T, VQ), where T is any type and VQ is either
7283   //   volatile or empty, there exist candidate operator functions
7284   //   of the form
7285   //
7286   //        T*VQ&      operator=(T*VQ&, T*);
7287   //
7288   // C++ [over.built]p21:
7289   //
7290   //   For every pair (T, VQ), where T is a cv-qualified or
7291   //   cv-unqualified object type and VQ is either volatile or
7292   //   empty, there exist candidate operator functions of the form
7293   //
7294   //        T*VQ&      operator+=(T*VQ&, ptrdiff_t);
7295   //        T*VQ&      operator-=(T*VQ&, ptrdiff_t);
7296   void addAssignmentPointerOverloads(bool isEqualOp) {
7297     /// Set of (canonical) types that we've already handled.
7298     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7299 
7300     for (BuiltinCandidateTypeSet::iterator
7301               Ptr = CandidateTypes[0].pointer_begin(),
7302            PtrEnd = CandidateTypes[0].pointer_end();
7303          Ptr != PtrEnd; ++Ptr) {
7304       // If this is operator=, keep track of the builtin candidates we added.
7305       if (isEqualOp)
7306         AddedTypes.insert(S.Context.getCanonicalType(*Ptr));
7307       else if (!(*Ptr)->getPointeeType()->isObjectType())
7308         continue;
7309 
7310       // non-volatile version
7311       QualType ParamTypes[2] = {
7312         S.Context.getLValueReferenceType(*Ptr),
7313         isEqualOp ? *Ptr : S.Context.getPointerDiffType(),
7314       };
7315       S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7316                             /*IsAssigmentOperator=*/ isEqualOp);
7317 
7318       bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
7319                           VisibleTypeConversionsQuals.hasVolatile();
7320       if (NeedVolatile) {
7321         // volatile version
7322         ParamTypes[0] =
7323           S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
7324         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7325                               /*IsAssigmentOperator=*/isEqualOp);
7326       }
7327 
7328       if (!(*Ptr).isRestrictQualified() &&
7329           VisibleTypeConversionsQuals.hasRestrict()) {
7330         // restrict version
7331         ParamTypes[0]
7332           = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
7333         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7334                               /*IsAssigmentOperator=*/isEqualOp);
7335 
7336         if (NeedVolatile) {
7337           // volatile restrict version
7338           ParamTypes[0]
7339             = S.Context.getLValueReferenceType(
7340                 S.Context.getCVRQualifiedType(*Ptr,
7341                                               (Qualifiers::Volatile |
7342                                                Qualifiers::Restrict)));
7343           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7344                                 /*IsAssigmentOperator=*/isEqualOp);
7345         }
7346       }
7347     }
7348 
7349     if (isEqualOp) {
7350       for (BuiltinCandidateTypeSet::iterator
7351                 Ptr = CandidateTypes[1].pointer_begin(),
7352              PtrEnd = CandidateTypes[1].pointer_end();
7353            Ptr != PtrEnd; ++Ptr) {
7354         // Make sure we don't add the same candidate twice.
7355         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7356           continue;
7357 
7358         QualType ParamTypes[2] = {
7359           S.Context.getLValueReferenceType(*Ptr),
7360           *Ptr,
7361         };
7362 
7363         // non-volatile version
7364         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7365                               /*IsAssigmentOperator=*/true);
7366 
7367         bool NeedVolatile = !(*Ptr).isVolatileQualified() &&
7368                            VisibleTypeConversionsQuals.hasVolatile();
7369         if (NeedVolatile) {
7370           // volatile version
7371           ParamTypes[0] =
7372             S.Context.getLValueReferenceType(S.Context.getVolatileType(*Ptr));
7373           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7374                                 /*IsAssigmentOperator=*/true);
7375         }
7376 
7377         if (!(*Ptr).isRestrictQualified() &&
7378             VisibleTypeConversionsQuals.hasRestrict()) {
7379           // restrict version
7380           ParamTypes[0]
7381             = S.Context.getLValueReferenceType(S.Context.getRestrictType(*Ptr));
7382           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7383                                 /*IsAssigmentOperator=*/true);
7384 
7385           if (NeedVolatile) {
7386             // volatile restrict version
7387             ParamTypes[0]
7388               = S.Context.getLValueReferenceType(
7389                   S.Context.getCVRQualifiedType(*Ptr,
7390                                                 (Qualifiers::Volatile |
7391                                                  Qualifiers::Restrict)));
7392             S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7393                                   /*IsAssigmentOperator=*/true);
7394           }
7395         }
7396       }
7397     }
7398   }
7399 
7400   // C++ [over.built]p18:
7401   //
7402   //   For every triple (L, VQ, R), where L is an arithmetic type,
7403   //   VQ is either volatile or empty, and R is a promoted
7404   //   arithmetic type, there exist candidate operator functions of
7405   //   the form
7406   //
7407   //        VQ L&      operator=(VQ L&, R);
7408   //        VQ L&      operator*=(VQ L&, R);
7409   //        VQ L&      operator/=(VQ L&, R);
7410   //        VQ L&      operator+=(VQ L&, R);
7411   //        VQ L&      operator-=(VQ L&, R);
7412   void addAssignmentArithmeticOverloads(bool isEqualOp) {
7413     if (!HasArithmeticOrEnumeralCandidateType)
7414       return;
7415 
7416     for (unsigned Left = 0; Left < NumArithmeticTypes; ++Left) {
7417       for (unsigned Right = FirstPromotedArithmeticType;
7418            Right < LastPromotedArithmeticType; ++Right) {
7419         QualType ParamTypes[2];
7420         ParamTypes[1] = getArithmeticType(Right);
7421 
7422         // Add this built-in operator as a candidate (VQ is empty).
7423         ParamTypes[0] =
7424           S.Context.getLValueReferenceType(getArithmeticType(Left));
7425         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7426                               /*IsAssigmentOperator=*/isEqualOp);
7427 
7428         // Add this built-in operator as a candidate (VQ is 'volatile').
7429         if (VisibleTypeConversionsQuals.hasVolatile()) {
7430           ParamTypes[0] =
7431             S.Context.getVolatileType(getArithmeticType(Left));
7432           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7433           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7434                                 /*IsAssigmentOperator=*/isEqualOp);
7435         }
7436       }
7437     }
7438 
7439     // Extension: Add the binary operators =, +=, -=, *=, /= for vector types.
7440     for (BuiltinCandidateTypeSet::iterator
7441               Vec1 = CandidateTypes[0].vector_begin(),
7442            Vec1End = CandidateTypes[0].vector_end();
7443          Vec1 != Vec1End; ++Vec1) {
7444       for (BuiltinCandidateTypeSet::iterator
7445                 Vec2 = CandidateTypes[1].vector_begin(),
7446              Vec2End = CandidateTypes[1].vector_end();
7447            Vec2 != Vec2End; ++Vec2) {
7448         QualType ParamTypes[2];
7449         ParamTypes[1] = *Vec2;
7450         // Add this built-in operator as a candidate (VQ is empty).
7451         ParamTypes[0] = S.Context.getLValueReferenceType(*Vec1);
7452         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7453                               /*IsAssigmentOperator=*/isEqualOp);
7454 
7455         // Add this built-in operator as a candidate (VQ is 'volatile').
7456         if (VisibleTypeConversionsQuals.hasVolatile()) {
7457           ParamTypes[0] = S.Context.getVolatileType(*Vec1);
7458           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7459           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet,
7460                                 /*IsAssigmentOperator=*/isEqualOp);
7461         }
7462       }
7463     }
7464   }
7465 
7466   // C++ [over.built]p22:
7467   //
7468   //   For every triple (L, VQ, R), where L is an integral type, VQ
7469   //   is either volatile or empty, and R is a promoted integral
7470   //   type, there exist candidate operator functions of the form
7471   //
7472   //        VQ L&       operator%=(VQ L&, R);
7473   //        VQ L&       operator<<=(VQ L&, R);
7474   //        VQ L&       operator>>=(VQ L&, R);
7475   //        VQ L&       operator&=(VQ L&, R);
7476   //        VQ L&       operator^=(VQ L&, R);
7477   //        VQ L&       operator|=(VQ L&, R);
7478   void addAssignmentIntegralOverloads() {
7479     if (!HasArithmeticOrEnumeralCandidateType)
7480       return;
7481 
7482     for (unsigned Left = FirstIntegralType; Left < LastIntegralType; ++Left) {
7483       for (unsigned Right = FirstPromotedIntegralType;
7484            Right < LastPromotedIntegralType; ++Right) {
7485         QualType ParamTypes[2];
7486         ParamTypes[1] = getArithmeticType(Right);
7487 
7488         // Add this built-in operator as a candidate (VQ is empty).
7489         ParamTypes[0] =
7490           S.Context.getLValueReferenceType(getArithmeticType(Left));
7491         S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7492         if (VisibleTypeConversionsQuals.hasVolatile()) {
7493           // Add this built-in operator as a candidate (VQ is 'volatile').
7494           ParamTypes[0] = getArithmeticType(Left);
7495           ParamTypes[0] = S.Context.getVolatileType(ParamTypes[0]);
7496           ParamTypes[0] = S.Context.getLValueReferenceType(ParamTypes[0]);
7497           S.AddBuiltinCandidate(ParamTypes[0], ParamTypes, Args, CandidateSet);
7498         }
7499       }
7500     }
7501   }
7502 
7503   // C++ [over.operator]p23:
7504   //
7505   //   There also exist candidate operator functions of the form
7506   //
7507   //        bool        operator!(bool);
7508   //        bool        operator&&(bool, bool);
7509   //        bool        operator||(bool, bool);
7510   void addExclaimOverload() {
7511     QualType ParamTy = S.Context.BoolTy;
7512     S.AddBuiltinCandidate(ParamTy, &ParamTy, Args, CandidateSet,
7513                           /*IsAssignmentOperator=*/false,
7514                           /*NumContextualBoolArguments=*/1);
7515   }
7516   void addAmpAmpOrPipePipeOverload() {
7517     QualType ParamTypes[2] = { S.Context.BoolTy, S.Context.BoolTy };
7518     S.AddBuiltinCandidate(S.Context.BoolTy, ParamTypes, Args, CandidateSet,
7519                           /*IsAssignmentOperator=*/false,
7520                           /*NumContextualBoolArguments=*/2);
7521   }
7522 
7523   // C++ [over.built]p13:
7524   //
7525   //   For every cv-qualified or cv-unqualified object type T there
7526   //   exist candidate operator functions of the form
7527   //
7528   //        T*         operator+(T*, ptrdiff_t);     [ABOVE]
7529   //        T&         operator[](T*, ptrdiff_t);
7530   //        T*         operator-(T*, ptrdiff_t);     [ABOVE]
7531   //        T*         operator+(ptrdiff_t, T*);     [ABOVE]
7532   //        T&         operator[](ptrdiff_t, T*);
7533   void addSubscriptOverloads() {
7534     for (BuiltinCandidateTypeSet::iterator
7535               Ptr = CandidateTypes[0].pointer_begin(),
7536            PtrEnd = CandidateTypes[0].pointer_end();
7537          Ptr != PtrEnd; ++Ptr) {
7538       QualType ParamTypes[2] = { *Ptr, S.Context.getPointerDiffType() };
7539       QualType PointeeType = (*Ptr)->getPointeeType();
7540       if (!PointeeType->isObjectType())
7541         continue;
7542 
7543       QualType ResultTy = S.Context.getLValueReferenceType(PointeeType);
7544 
7545       // T& operator[](T*, ptrdiff_t)
7546       S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7547     }
7548 
7549     for (BuiltinCandidateTypeSet::iterator
7550               Ptr = CandidateTypes[1].pointer_begin(),
7551            PtrEnd = CandidateTypes[1].pointer_end();
7552          Ptr != PtrEnd; ++Ptr) {
7553       QualType ParamTypes[2] = { S.Context.getPointerDiffType(), *Ptr };
7554       QualType PointeeType = (*Ptr)->getPointeeType();
7555       if (!PointeeType->isObjectType())
7556         continue;
7557 
7558       QualType ResultTy = S.Context.getLValueReferenceType(PointeeType);
7559 
7560       // T& operator[](ptrdiff_t, T*)
7561       S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7562     }
7563   }
7564 
7565   // C++ [over.built]p11:
7566   //    For every quintuple (C1, C2, T, CV1, CV2), where C2 is a class type,
7567   //    C1 is the same type as C2 or is a derived class of C2, T is an object
7568   //    type or a function type, and CV1 and CV2 are cv-qualifier-seqs,
7569   //    there exist candidate operator functions of the form
7570   //
7571   //      CV12 T& operator->*(CV1 C1*, CV2 T C2::*);
7572   //
7573   //    where CV12 is the union of CV1 and CV2.
7574   void addArrowStarOverloads() {
7575     for (BuiltinCandidateTypeSet::iterator
7576              Ptr = CandidateTypes[0].pointer_begin(),
7577            PtrEnd = CandidateTypes[0].pointer_end();
7578          Ptr != PtrEnd; ++Ptr) {
7579       QualType C1Ty = (*Ptr);
7580       QualType C1;
7581       QualifierCollector Q1;
7582       C1 = QualType(Q1.strip(C1Ty->getPointeeType()), 0);
7583       if (!isa<RecordType>(C1))
7584         continue;
7585       // heuristic to reduce number of builtin candidates in the set.
7586       // Add volatile/restrict version only if there are conversions to a
7587       // volatile/restrict type.
7588       if (!VisibleTypeConversionsQuals.hasVolatile() && Q1.hasVolatile())
7589         continue;
7590       if (!VisibleTypeConversionsQuals.hasRestrict() && Q1.hasRestrict())
7591         continue;
7592       for (BuiltinCandidateTypeSet::iterator
7593                 MemPtr = CandidateTypes[1].member_pointer_begin(),
7594              MemPtrEnd = CandidateTypes[1].member_pointer_end();
7595            MemPtr != MemPtrEnd; ++MemPtr) {
7596         const MemberPointerType *mptr = cast<MemberPointerType>(*MemPtr);
7597         QualType C2 = QualType(mptr->getClass(), 0);
7598         C2 = C2.getUnqualifiedType();
7599         if (C1 != C2 && !S.IsDerivedFrom(C1, C2))
7600           break;
7601         QualType ParamTypes[2] = { *Ptr, *MemPtr };
7602         // build CV12 T&
7603         QualType T = mptr->getPointeeType();
7604         if (!VisibleTypeConversionsQuals.hasVolatile() &&
7605             T.isVolatileQualified())
7606           continue;
7607         if (!VisibleTypeConversionsQuals.hasRestrict() &&
7608             T.isRestrictQualified())
7609           continue;
7610         T = Q1.apply(S.Context, T);
7611         QualType ResultTy = S.Context.getLValueReferenceType(T);
7612         S.AddBuiltinCandidate(ResultTy, ParamTypes, Args, CandidateSet);
7613       }
7614     }
7615   }
7616 
7617   // Note that we don't consider the first argument, since it has been
7618   // contextually converted to bool long ago. The candidates below are
7619   // therefore added as binary.
7620   //
7621   // C++ [over.built]p25:
7622   //   For every type T, where T is a pointer, pointer-to-member, or scoped
7623   //   enumeration type, there exist candidate operator functions of the form
7624   //
7625   //        T        operator?(bool, T, T);
7626   //
7627   void addConditionalOperatorOverloads() {
7628     /// Set of (canonical) types that we've already handled.
7629     llvm::SmallPtrSet<QualType, 8> AddedTypes;
7630 
7631     for (unsigned ArgIdx = 0; ArgIdx < 2; ++ArgIdx) {
7632       for (BuiltinCandidateTypeSet::iterator
7633                 Ptr = CandidateTypes[ArgIdx].pointer_begin(),
7634              PtrEnd = CandidateTypes[ArgIdx].pointer_end();
7635            Ptr != PtrEnd; ++Ptr) {
7636         if (!AddedTypes.insert(S.Context.getCanonicalType(*Ptr)))
7637           continue;
7638 
7639         QualType ParamTypes[2] = { *Ptr, *Ptr };
7640         S.AddBuiltinCandidate(*Ptr, ParamTypes, Args, CandidateSet);
7641       }
7642 
7643       for (BuiltinCandidateTypeSet::iterator
7644                 MemPtr = CandidateTypes[ArgIdx].member_pointer_begin(),
7645              MemPtrEnd = CandidateTypes[ArgIdx].member_pointer_end();
7646            MemPtr != MemPtrEnd; ++MemPtr) {
7647         if (!AddedTypes.insert(S.Context.getCanonicalType(*MemPtr)))
7648           continue;
7649 
7650         QualType ParamTypes[2] = { *MemPtr, *MemPtr };
7651         S.AddBuiltinCandidate(*MemPtr, ParamTypes, Args, CandidateSet);
7652       }
7653 
7654       if (S.getLangOpts().CPlusPlus11) {
7655         for (BuiltinCandidateTypeSet::iterator
7656                   Enum = CandidateTypes[ArgIdx].enumeration_begin(),
7657                EnumEnd = CandidateTypes[ArgIdx].enumeration_end();
7658              Enum != EnumEnd; ++Enum) {
7659           if (!(*Enum)->getAs<EnumType>()->getDecl()->isScoped())
7660             continue;
7661 
7662           if (!AddedTypes.insert(S.Context.getCanonicalType(*Enum)))
7663             continue;
7664 
7665           QualType ParamTypes[2] = { *Enum, *Enum };
7666           S.AddBuiltinCandidate(*Enum, ParamTypes, Args, CandidateSet);
7667         }
7668       }
7669     }
7670   }
7671 };
7672 
7673 } // end anonymous namespace
7674 
7675 /// AddBuiltinOperatorCandidates - Add the appropriate built-in
7676 /// operator overloads to the candidate set (C++ [over.built]), based
7677 /// on the operator @p Op and the arguments given. For example, if the
7678 /// operator is a binary '+', this routine might add "int
7679 /// operator+(int, int)" to cover integer addition.
7680 void
7681 Sema::AddBuiltinOperatorCandidates(OverloadedOperatorKind Op,
7682                                    SourceLocation OpLoc,
7683                                    llvm::ArrayRef<Expr *> Args,
7684                                    OverloadCandidateSet& CandidateSet) {
7685   // Find all of the types that the arguments can convert to, but only
7686   // if the operator we're looking at has built-in operator candidates
7687   // that make use of these types. Also record whether we encounter non-record
7688   // candidate types or either arithmetic or enumeral candidate types.
7689   Qualifiers VisibleTypeConversionsQuals;
7690   VisibleTypeConversionsQuals.addConst();
7691   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx)
7692     VisibleTypeConversionsQuals += CollectVRQualifiers(Context, Args[ArgIdx]);
7693 
7694   bool HasNonRecordCandidateType = false;
7695   bool HasArithmeticOrEnumeralCandidateType = false;
7696   SmallVector<BuiltinCandidateTypeSet, 2> CandidateTypes;
7697   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
7698     CandidateTypes.push_back(BuiltinCandidateTypeSet(*this));
7699     CandidateTypes[ArgIdx].AddTypesConvertedFrom(Args[ArgIdx]->getType(),
7700                                                  OpLoc,
7701                                                  true,
7702                                                  (Op == OO_Exclaim ||
7703                                                   Op == OO_AmpAmp ||
7704                                                   Op == OO_PipePipe),
7705                                                  VisibleTypeConversionsQuals);
7706     HasNonRecordCandidateType = HasNonRecordCandidateType ||
7707         CandidateTypes[ArgIdx].hasNonRecordTypes();
7708     HasArithmeticOrEnumeralCandidateType =
7709         HasArithmeticOrEnumeralCandidateType ||
7710         CandidateTypes[ArgIdx].hasArithmeticOrEnumeralTypes();
7711   }
7712 
7713   // Exit early when no non-record types have been added to the candidate set
7714   // for any of the arguments to the operator.
7715   //
7716   // We can't exit early for !, ||, or &&, since there we have always have
7717   // 'bool' overloads.
7718   if (!HasNonRecordCandidateType &&
7719       !(Op == OO_Exclaim || Op == OO_AmpAmp || Op == OO_PipePipe))
7720     return;
7721 
7722   // Setup an object to manage the common state for building overloads.
7723   BuiltinOperatorOverloadBuilder OpBuilder(*this, Args,
7724                                            VisibleTypeConversionsQuals,
7725                                            HasArithmeticOrEnumeralCandidateType,
7726                                            CandidateTypes, CandidateSet);
7727 
7728   // Dispatch over the operation to add in only those overloads which apply.
7729   switch (Op) {
7730   case OO_None:
7731   case NUM_OVERLOADED_OPERATORS:
7732     llvm_unreachable("Expected an overloaded operator");
7733 
7734   case OO_New:
7735   case OO_Delete:
7736   case OO_Array_New:
7737   case OO_Array_Delete:
7738   case OO_Call:
7739     llvm_unreachable(
7740                     "Special operators don't use AddBuiltinOperatorCandidates");
7741 
7742   case OO_Comma:
7743   case OO_Arrow:
7744     // C++ [over.match.oper]p3:
7745     //   -- For the operator ',', the unary operator '&', or the
7746     //      operator '->', the built-in candidates set is empty.
7747     break;
7748 
7749   case OO_Plus: // '+' is either unary or binary
7750     if (Args.size() == 1)
7751       OpBuilder.addUnaryPlusPointerOverloads();
7752     // Fall through.
7753 
7754   case OO_Minus: // '-' is either unary or binary
7755     if (Args.size() == 1) {
7756       OpBuilder.addUnaryPlusOrMinusArithmeticOverloads();
7757     } else {
7758       OpBuilder.addBinaryPlusOrMinusPointerOverloads(Op);
7759       OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
7760     }
7761     break;
7762 
7763   case OO_Star: // '*' is either unary or binary
7764     if (Args.size() == 1)
7765       OpBuilder.addUnaryStarPointerOverloads();
7766     else
7767       OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
7768     break;
7769 
7770   case OO_Slash:
7771     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
7772     break;
7773 
7774   case OO_PlusPlus:
7775   case OO_MinusMinus:
7776     OpBuilder.addPlusPlusMinusMinusArithmeticOverloads(Op);
7777     OpBuilder.addPlusPlusMinusMinusPointerOverloads();
7778     break;
7779 
7780   case OO_EqualEqual:
7781   case OO_ExclaimEqual:
7782     OpBuilder.addEqualEqualOrNotEqualMemberPointerOverloads();
7783     // Fall through.
7784 
7785   case OO_Less:
7786   case OO_Greater:
7787   case OO_LessEqual:
7788   case OO_GreaterEqual:
7789     OpBuilder.addRelationalPointerOrEnumeralOverloads();
7790     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/true);
7791     break;
7792 
7793   case OO_Percent:
7794   case OO_Caret:
7795   case OO_Pipe:
7796   case OO_LessLess:
7797   case OO_GreaterGreater:
7798     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
7799     break;
7800 
7801   case OO_Amp: // '&' is either unary or binary
7802     if (Args.size() == 1)
7803       // C++ [over.match.oper]p3:
7804       //   -- For the operator ',', the unary operator '&', or the
7805       //      operator '->', the built-in candidates set is empty.
7806       break;
7807 
7808     OpBuilder.addBinaryBitwiseArithmeticOverloads(Op);
7809     break;
7810 
7811   case OO_Tilde:
7812     OpBuilder.addUnaryTildePromotedIntegralOverloads();
7813     break;
7814 
7815   case OO_Equal:
7816     OpBuilder.addAssignmentMemberPointerOrEnumeralOverloads();
7817     // Fall through.
7818 
7819   case OO_PlusEqual:
7820   case OO_MinusEqual:
7821     OpBuilder.addAssignmentPointerOverloads(Op == OO_Equal);
7822     // Fall through.
7823 
7824   case OO_StarEqual:
7825   case OO_SlashEqual:
7826     OpBuilder.addAssignmentArithmeticOverloads(Op == OO_Equal);
7827     break;
7828 
7829   case OO_PercentEqual:
7830   case OO_LessLessEqual:
7831   case OO_GreaterGreaterEqual:
7832   case OO_AmpEqual:
7833   case OO_CaretEqual:
7834   case OO_PipeEqual:
7835     OpBuilder.addAssignmentIntegralOverloads();
7836     break;
7837 
7838   case OO_Exclaim:
7839     OpBuilder.addExclaimOverload();
7840     break;
7841 
7842   case OO_AmpAmp:
7843   case OO_PipePipe:
7844     OpBuilder.addAmpAmpOrPipePipeOverload();
7845     break;
7846 
7847   case OO_Subscript:
7848     OpBuilder.addSubscriptOverloads();
7849     break;
7850 
7851   case OO_ArrowStar:
7852     OpBuilder.addArrowStarOverloads();
7853     break;
7854 
7855   case OO_Conditional:
7856     OpBuilder.addConditionalOperatorOverloads();
7857     OpBuilder.addGenericBinaryArithmeticOverloads(/*isComparison=*/false);
7858     break;
7859   }
7860 }
7861 
7862 /// \brief Add function candidates found via argument-dependent lookup
7863 /// to the set of overloading candidates.
7864 ///
7865 /// This routine performs argument-dependent name lookup based on the
7866 /// given function name (which may also be an operator name) and adds
7867 /// all of the overload candidates found by ADL to the overload
7868 /// candidate set (C++ [basic.lookup.argdep]).
7869 void
7870 Sema::AddArgumentDependentLookupCandidates(DeclarationName Name,
7871                                            bool Operator, SourceLocation Loc,
7872                                            ArrayRef<Expr *> Args,
7873                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
7874                                            OverloadCandidateSet& CandidateSet,
7875                                            bool PartialOverloading) {
7876   ADLResult Fns;
7877 
7878   // FIXME: This approach for uniquing ADL results (and removing
7879   // redundant candidates from the set) relies on pointer-equality,
7880   // which means we need to key off the canonical decl.  However,
7881   // always going back to the canonical decl might not get us the
7882   // right set of default arguments.  What default arguments are
7883   // we supposed to consider on ADL candidates, anyway?
7884 
7885   // FIXME: Pass in the explicit template arguments?
7886   ArgumentDependentLookup(Name, Operator, Loc, Args, Fns);
7887 
7888   // Erase all of the candidates we already knew about.
7889   for (OverloadCandidateSet::iterator Cand = CandidateSet.begin(),
7890                                    CandEnd = CandidateSet.end();
7891        Cand != CandEnd; ++Cand)
7892     if (Cand->Function) {
7893       Fns.erase(Cand->Function);
7894       if (FunctionTemplateDecl *FunTmpl = Cand->Function->getPrimaryTemplate())
7895         Fns.erase(FunTmpl);
7896     }
7897 
7898   // For each of the ADL candidates we found, add it to the overload
7899   // set.
7900   for (ADLResult::iterator I = Fns.begin(), E = Fns.end(); I != E; ++I) {
7901     DeclAccessPair FoundDecl = DeclAccessPair::make(*I, AS_none);
7902     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
7903       if (ExplicitTemplateArgs)
7904         continue;
7905 
7906       AddOverloadCandidate(FD, FoundDecl, Args, CandidateSet, false,
7907                            PartialOverloading);
7908     } else
7909       AddTemplateOverloadCandidate(cast<FunctionTemplateDecl>(*I),
7910                                    FoundDecl, ExplicitTemplateArgs,
7911                                    Args, CandidateSet);
7912   }
7913 }
7914 
7915 /// isBetterOverloadCandidate - Determines whether the first overload
7916 /// candidate is a better candidate than the second (C++ 13.3.3p1).
7917 bool
7918 isBetterOverloadCandidate(Sema &S,
7919                           const OverloadCandidate &Cand1,
7920                           const OverloadCandidate &Cand2,
7921                           SourceLocation Loc,
7922                           bool UserDefinedConversion) {
7923   // Define viable functions to be better candidates than non-viable
7924   // functions.
7925   if (!Cand2.Viable)
7926     return Cand1.Viable;
7927   else if (!Cand1.Viable)
7928     return false;
7929 
7930   // C++ [over.match.best]p1:
7931   //
7932   //   -- if F is a static member function, ICS1(F) is defined such
7933   //      that ICS1(F) is neither better nor worse than ICS1(G) for
7934   //      any function G, and, symmetrically, ICS1(G) is neither
7935   //      better nor worse than ICS1(F).
7936   unsigned StartArg = 0;
7937   if (Cand1.IgnoreObjectArgument || Cand2.IgnoreObjectArgument)
7938     StartArg = 1;
7939 
7940   // C++ [over.match.best]p1:
7941   //   A viable function F1 is defined to be a better function than another
7942   //   viable function F2 if for all arguments i, ICSi(F1) is not a worse
7943   //   conversion sequence than ICSi(F2), and then...
7944   unsigned NumArgs = Cand1.NumConversions;
7945   assert(Cand2.NumConversions == NumArgs && "Overload candidate mismatch");
7946   bool HasBetterConversion = false;
7947   for (unsigned ArgIdx = StartArg; ArgIdx < NumArgs; ++ArgIdx) {
7948     switch (CompareImplicitConversionSequences(S,
7949                                                Cand1.Conversions[ArgIdx],
7950                                                Cand2.Conversions[ArgIdx])) {
7951     case ImplicitConversionSequence::Better:
7952       // Cand1 has a better conversion sequence.
7953       HasBetterConversion = true;
7954       break;
7955 
7956     case ImplicitConversionSequence::Worse:
7957       // Cand1 can't be better than Cand2.
7958       return false;
7959 
7960     case ImplicitConversionSequence::Indistinguishable:
7961       // Do nothing.
7962       break;
7963     }
7964   }
7965 
7966   //    -- for some argument j, ICSj(F1) is a better conversion sequence than
7967   //       ICSj(F2), or, if not that,
7968   if (HasBetterConversion)
7969     return true;
7970 
7971   //     - F1 is a non-template function and F2 is a function template
7972   //       specialization, or, if not that,
7973   if ((!Cand1.Function || !Cand1.Function->getPrimaryTemplate()) &&
7974       Cand2.Function && Cand2.Function->getPrimaryTemplate())
7975     return true;
7976 
7977   //   -- F1 and F2 are function template specializations, and the function
7978   //      template for F1 is more specialized than the template for F2
7979   //      according to the partial ordering rules described in 14.5.5.2, or,
7980   //      if not that,
7981   if (Cand1.Function && Cand1.Function->getPrimaryTemplate() &&
7982       Cand2.Function && Cand2.Function->getPrimaryTemplate()) {
7983     if (FunctionTemplateDecl *BetterTemplate
7984           = S.getMoreSpecializedTemplate(Cand1.Function->getPrimaryTemplate(),
7985                                          Cand2.Function->getPrimaryTemplate(),
7986                                          Loc,
7987                        isa<CXXConversionDecl>(Cand1.Function)? TPOC_Conversion
7988                                                              : TPOC_Call,
7989                                          Cand1.ExplicitCallArguments))
7990       return BetterTemplate == Cand1.Function->getPrimaryTemplate();
7991   }
7992 
7993   //   -- the context is an initialization by user-defined conversion
7994   //      (see 8.5, 13.3.1.5) and the standard conversion sequence
7995   //      from the return type of F1 to the destination type (i.e.,
7996   //      the type of the entity being initialized) is a better
7997   //      conversion sequence than the standard conversion sequence
7998   //      from the return type of F2 to the destination type.
7999   if (UserDefinedConversion && Cand1.Function && Cand2.Function &&
8000       isa<CXXConversionDecl>(Cand1.Function) &&
8001       isa<CXXConversionDecl>(Cand2.Function)) {
8002     // First check whether we prefer one of the conversion functions over the
8003     // other. This only distinguishes the results in non-standard, extension
8004     // cases such as the conversion from a lambda closure type to a function
8005     // pointer or block.
8006     ImplicitConversionSequence::CompareKind FuncResult
8007       = compareConversionFunctions(S, Cand1.Function, Cand2.Function);
8008     if (FuncResult != ImplicitConversionSequence::Indistinguishable)
8009       return FuncResult;
8010 
8011     switch (CompareStandardConversionSequences(S,
8012                                                Cand1.FinalConversion,
8013                                                Cand2.FinalConversion)) {
8014     case ImplicitConversionSequence::Better:
8015       // Cand1 has a better conversion sequence.
8016       return true;
8017 
8018     case ImplicitConversionSequence::Worse:
8019       // Cand1 can't be better than Cand2.
8020       return false;
8021 
8022     case ImplicitConversionSequence::Indistinguishable:
8023       // Do nothing
8024       break;
8025     }
8026   }
8027 
8028   return false;
8029 }
8030 
8031 /// \brief Computes the best viable function (C++ 13.3.3)
8032 /// within an overload candidate set.
8033 ///
8034 /// \param Loc The location of the function name (or operator symbol) for
8035 /// which overload resolution occurs.
8036 ///
8037 /// \param Best If overload resolution was successful or found a deleted
8038 /// function, \p Best points to the candidate function found.
8039 ///
8040 /// \returns The result of overload resolution.
8041 OverloadingResult
8042 OverloadCandidateSet::BestViableFunction(Sema &S, SourceLocation Loc,
8043                                          iterator &Best,
8044                                          bool UserDefinedConversion) {
8045   // Find the best viable function.
8046   Best = end();
8047   for (iterator Cand = begin(); Cand != end(); ++Cand) {
8048     if (Cand->Viable)
8049       if (Best == end() || isBetterOverloadCandidate(S, *Cand, *Best, Loc,
8050                                                      UserDefinedConversion))
8051         Best = Cand;
8052   }
8053 
8054   // If we didn't find any viable functions, abort.
8055   if (Best == end())
8056     return OR_No_Viable_Function;
8057 
8058   // Make sure that this function is better than every other viable
8059   // function. If not, we have an ambiguity.
8060   for (iterator Cand = begin(); Cand != end(); ++Cand) {
8061     if (Cand->Viable &&
8062         Cand != Best &&
8063         !isBetterOverloadCandidate(S, *Best, *Cand, Loc,
8064                                    UserDefinedConversion)) {
8065       Best = end();
8066       return OR_Ambiguous;
8067     }
8068   }
8069 
8070   // Best is the best viable function.
8071   if (Best->Function &&
8072       (Best->Function->isDeleted() ||
8073        S.isFunctionConsideredUnavailable(Best->Function)))
8074     return OR_Deleted;
8075 
8076   return OR_Success;
8077 }
8078 
8079 namespace {
8080 
8081 enum OverloadCandidateKind {
8082   oc_function,
8083   oc_method,
8084   oc_constructor,
8085   oc_function_template,
8086   oc_method_template,
8087   oc_constructor_template,
8088   oc_implicit_default_constructor,
8089   oc_implicit_copy_constructor,
8090   oc_implicit_move_constructor,
8091   oc_implicit_copy_assignment,
8092   oc_implicit_move_assignment,
8093   oc_implicit_inherited_constructor
8094 };
8095 
8096 OverloadCandidateKind ClassifyOverloadCandidate(Sema &S,
8097                                                 FunctionDecl *Fn,
8098                                                 std::string &Description) {
8099   bool isTemplate = false;
8100 
8101   if (FunctionTemplateDecl *FunTmpl = Fn->getPrimaryTemplate()) {
8102     isTemplate = true;
8103     Description = S.getTemplateArgumentBindingsText(
8104       FunTmpl->getTemplateParameters(), *Fn->getTemplateSpecializationArgs());
8105   }
8106 
8107   if (CXXConstructorDecl *Ctor = dyn_cast<CXXConstructorDecl>(Fn)) {
8108     if (!Ctor->isImplicit())
8109       return isTemplate ? oc_constructor_template : oc_constructor;
8110 
8111     if (Ctor->getInheritedConstructor())
8112       return oc_implicit_inherited_constructor;
8113 
8114     if (Ctor->isDefaultConstructor())
8115       return oc_implicit_default_constructor;
8116 
8117     if (Ctor->isMoveConstructor())
8118       return oc_implicit_move_constructor;
8119 
8120     assert(Ctor->isCopyConstructor() &&
8121            "unexpected sort of implicit constructor");
8122     return oc_implicit_copy_constructor;
8123   }
8124 
8125   if (CXXMethodDecl *Meth = dyn_cast<CXXMethodDecl>(Fn)) {
8126     // This actually gets spelled 'candidate function' for now, but
8127     // it doesn't hurt to split it out.
8128     if (!Meth->isImplicit())
8129       return isTemplate ? oc_method_template : oc_method;
8130 
8131     if (Meth->isMoveAssignmentOperator())
8132       return oc_implicit_move_assignment;
8133 
8134     if (Meth->isCopyAssignmentOperator())
8135       return oc_implicit_copy_assignment;
8136 
8137     assert(isa<CXXConversionDecl>(Meth) && "expected conversion");
8138     return oc_method;
8139   }
8140 
8141   return isTemplate ? oc_function_template : oc_function;
8142 }
8143 
8144 void MaybeEmitInheritedConstructorNote(Sema &S, FunctionDecl *Fn) {
8145   const CXXConstructorDecl *Ctor = dyn_cast<CXXConstructorDecl>(Fn);
8146   if (!Ctor) return;
8147 
8148   Ctor = Ctor->getInheritedConstructor();
8149   if (!Ctor) return;
8150 
8151   S.Diag(Ctor->getLocation(), diag::note_ovl_candidate_inherited_constructor);
8152 }
8153 
8154 } // end anonymous namespace
8155 
8156 // Notes the location of an overload candidate.
8157 void Sema::NoteOverloadCandidate(FunctionDecl *Fn, QualType DestType) {
8158   std::string FnDesc;
8159   OverloadCandidateKind K = ClassifyOverloadCandidate(*this, Fn, FnDesc);
8160   PartialDiagnostic PD = PDiag(diag::note_ovl_candidate)
8161                              << (unsigned) K << FnDesc;
8162   HandleFunctionTypeMismatch(PD, Fn->getType(), DestType);
8163   Diag(Fn->getLocation(), PD);
8164   MaybeEmitInheritedConstructorNote(*this, Fn);
8165 }
8166 
8167 //Notes the location of all overload candidates designated through
8168 // OverloadedExpr
8169 void Sema::NoteAllOverloadCandidates(Expr* OverloadedExpr, QualType DestType) {
8170   assert(OverloadedExpr->getType() == Context.OverloadTy);
8171 
8172   OverloadExpr::FindResult Ovl = OverloadExpr::find(OverloadedExpr);
8173   OverloadExpr *OvlExpr = Ovl.Expression;
8174 
8175   for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
8176                             IEnd = OvlExpr->decls_end();
8177        I != IEnd; ++I) {
8178     if (FunctionTemplateDecl *FunTmpl =
8179                 dyn_cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl()) ) {
8180       NoteOverloadCandidate(FunTmpl->getTemplatedDecl(), DestType);
8181     } else if (FunctionDecl *Fun
8182                       = dyn_cast<FunctionDecl>((*I)->getUnderlyingDecl()) ) {
8183       NoteOverloadCandidate(Fun, DestType);
8184     }
8185   }
8186 }
8187 
8188 /// Diagnoses an ambiguous conversion.  The partial diagnostic is the
8189 /// "lead" diagnostic; it will be given two arguments, the source and
8190 /// target types of the conversion.
8191 void ImplicitConversionSequence::DiagnoseAmbiguousConversion(
8192                                  Sema &S,
8193                                  SourceLocation CaretLoc,
8194                                  const PartialDiagnostic &PDiag) const {
8195   S.Diag(CaretLoc, PDiag)
8196     << Ambiguous.getFromType() << Ambiguous.getToType();
8197   // FIXME: The note limiting machinery is borrowed from
8198   // OverloadCandidateSet::NoteCandidates; there's an opportunity for
8199   // refactoring here.
8200   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
8201   unsigned CandsShown = 0;
8202   AmbiguousConversionSequence::const_iterator I, E;
8203   for (I = Ambiguous.begin(), E = Ambiguous.end(); I != E; ++I) {
8204     if (CandsShown >= 4 && ShowOverloads == Ovl_Best)
8205       break;
8206     ++CandsShown;
8207     S.NoteOverloadCandidate(*I);
8208   }
8209   if (I != E)
8210     S.Diag(SourceLocation(), diag::note_ovl_too_many_candidates) << int(E - I);
8211 }
8212 
8213 namespace {
8214 
8215 void DiagnoseBadConversion(Sema &S, OverloadCandidate *Cand, unsigned I) {
8216   const ImplicitConversionSequence &Conv = Cand->Conversions[I];
8217   assert(Conv.isBad());
8218   assert(Cand->Function && "for now, candidate must be a function");
8219   FunctionDecl *Fn = Cand->Function;
8220 
8221   // There's a conversion slot for the object argument if this is a
8222   // non-constructor method.  Note that 'I' corresponds the
8223   // conversion-slot index.
8224   bool isObjectArgument = false;
8225   if (isa<CXXMethodDecl>(Fn) && !isa<CXXConstructorDecl>(Fn)) {
8226     if (I == 0)
8227       isObjectArgument = true;
8228     else
8229       I--;
8230   }
8231 
8232   std::string FnDesc;
8233   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, FnDesc);
8234 
8235   Expr *FromExpr = Conv.Bad.FromExpr;
8236   QualType FromTy = Conv.Bad.getFromType();
8237   QualType ToTy = Conv.Bad.getToType();
8238 
8239   if (FromTy == S.Context.OverloadTy) {
8240     assert(FromExpr && "overload set argument came from implicit argument?");
8241     Expr *E = FromExpr->IgnoreParens();
8242     if (isa<UnaryOperator>(E))
8243       E = cast<UnaryOperator>(E)->getSubExpr()->IgnoreParens();
8244     DeclarationName Name = cast<OverloadExpr>(E)->getName();
8245 
8246     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_overload)
8247       << (unsigned) FnKind << FnDesc
8248       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8249       << ToTy << Name << I+1;
8250     MaybeEmitInheritedConstructorNote(S, Fn);
8251     return;
8252   }
8253 
8254   // Do some hand-waving analysis to see if the non-viability is due
8255   // to a qualifier mismatch.
8256   CanQualType CFromTy = S.Context.getCanonicalType(FromTy);
8257   CanQualType CToTy = S.Context.getCanonicalType(ToTy);
8258   if (CanQual<ReferenceType> RT = CToTy->getAs<ReferenceType>())
8259     CToTy = RT->getPointeeType();
8260   else {
8261     // TODO: detect and diagnose the full richness of const mismatches.
8262     if (CanQual<PointerType> FromPT = CFromTy->getAs<PointerType>())
8263       if (CanQual<PointerType> ToPT = CToTy->getAs<PointerType>())
8264         CFromTy = FromPT->getPointeeType(), CToTy = ToPT->getPointeeType();
8265   }
8266 
8267   if (CToTy.getUnqualifiedType() == CFromTy.getUnqualifiedType() &&
8268       !CToTy.isAtLeastAsQualifiedAs(CFromTy)) {
8269     Qualifiers FromQs = CFromTy.getQualifiers();
8270     Qualifiers ToQs = CToTy.getQualifiers();
8271 
8272     if (FromQs.getAddressSpace() != ToQs.getAddressSpace()) {
8273       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_addrspace)
8274         << (unsigned) FnKind << FnDesc
8275         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8276         << FromTy
8277         << FromQs.getAddressSpace() << ToQs.getAddressSpace()
8278         << (unsigned) isObjectArgument << I+1;
8279       MaybeEmitInheritedConstructorNote(S, Fn);
8280       return;
8281     }
8282 
8283     if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
8284       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_ownership)
8285         << (unsigned) FnKind << FnDesc
8286         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8287         << FromTy
8288         << FromQs.getObjCLifetime() << ToQs.getObjCLifetime()
8289         << (unsigned) isObjectArgument << I+1;
8290       MaybeEmitInheritedConstructorNote(S, Fn);
8291       return;
8292     }
8293 
8294     if (FromQs.getObjCGCAttr() != ToQs.getObjCGCAttr()) {
8295       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_gc)
8296       << (unsigned) FnKind << FnDesc
8297       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8298       << FromTy
8299       << FromQs.getObjCGCAttr() << ToQs.getObjCGCAttr()
8300       << (unsigned) isObjectArgument << I+1;
8301       MaybeEmitInheritedConstructorNote(S, Fn);
8302       return;
8303     }
8304 
8305     unsigned CVR = FromQs.getCVRQualifiers() & ~ToQs.getCVRQualifiers();
8306     assert(CVR && "unexpected qualifiers mismatch");
8307 
8308     if (isObjectArgument) {
8309       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr_this)
8310         << (unsigned) FnKind << FnDesc
8311         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8312         << FromTy << (CVR - 1);
8313     } else {
8314       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_cvr)
8315         << (unsigned) FnKind << FnDesc
8316         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8317         << FromTy << (CVR - 1) << I+1;
8318     }
8319     MaybeEmitInheritedConstructorNote(S, Fn);
8320     return;
8321   }
8322 
8323   // Special diagnostic for failure to convert an initializer list, since
8324   // telling the user that it has type void is not useful.
8325   if (FromExpr && isa<InitListExpr>(FromExpr)) {
8326     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_list_argument)
8327       << (unsigned) FnKind << FnDesc
8328       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8329       << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8330     MaybeEmitInheritedConstructorNote(S, Fn);
8331     return;
8332   }
8333 
8334   // Diagnose references or pointers to incomplete types differently,
8335   // since it's far from impossible that the incompleteness triggered
8336   // the failure.
8337   QualType TempFromTy = FromTy.getNonReferenceType();
8338   if (const PointerType *PTy = TempFromTy->getAs<PointerType>())
8339     TempFromTy = PTy->getPointeeType();
8340   if (TempFromTy->isIncompleteType()) {
8341     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_conv_incomplete)
8342       << (unsigned) FnKind << FnDesc
8343       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8344       << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8345     MaybeEmitInheritedConstructorNote(S, Fn);
8346     return;
8347   }
8348 
8349   // Diagnose base -> derived pointer conversions.
8350   unsigned BaseToDerivedConversion = 0;
8351   if (const PointerType *FromPtrTy = FromTy->getAs<PointerType>()) {
8352     if (const PointerType *ToPtrTy = ToTy->getAs<PointerType>()) {
8353       if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
8354                                                FromPtrTy->getPointeeType()) &&
8355           !FromPtrTy->getPointeeType()->isIncompleteType() &&
8356           !ToPtrTy->getPointeeType()->isIncompleteType() &&
8357           S.IsDerivedFrom(ToPtrTy->getPointeeType(),
8358                           FromPtrTy->getPointeeType()))
8359         BaseToDerivedConversion = 1;
8360     }
8361   } else if (const ObjCObjectPointerType *FromPtrTy
8362                                     = FromTy->getAs<ObjCObjectPointerType>()) {
8363     if (const ObjCObjectPointerType *ToPtrTy
8364                                         = ToTy->getAs<ObjCObjectPointerType>())
8365       if (const ObjCInterfaceDecl *FromIface = FromPtrTy->getInterfaceDecl())
8366         if (const ObjCInterfaceDecl *ToIface = ToPtrTy->getInterfaceDecl())
8367           if (ToPtrTy->getPointeeType().isAtLeastAsQualifiedAs(
8368                                                 FromPtrTy->getPointeeType()) &&
8369               FromIface->isSuperClassOf(ToIface))
8370             BaseToDerivedConversion = 2;
8371   } else if (const ReferenceType *ToRefTy = ToTy->getAs<ReferenceType>()) {
8372     if (ToRefTy->getPointeeType().isAtLeastAsQualifiedAs(FromTy) &&
8373         !FromTy->isIncompleteType() &&
8374         !ToRefTy->getPointeeType()->isIncompleteType() &&
8375         S.IsDerivedFrom(ToRefTy->getPointeeType(), FromTy)) {
8376       BaseToDerivedConversion = 3;
8377     } else if (ToTy->isLValueReferenceType() && !FromExpr->isLValue() &&
8378                ToTy.getNonReferenceType().getCanonicalType() ==
8379                FromTy.getNonReferenceType().getCanonicalType()) {
8380       S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_lvalue)
8381         << (unsigned) FnKind << FnDesc
8382         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8383         << (unsigned) isObjectArgument << I + 1;
8384       MaybeEmitInheritedConstructorNote(S, Fn);
8385       return;
8386     }
8387   }
8388 
8389   if (BaseToDerivedConversion) {
8390     S.Diag(Fn->getLocation(),
8391            diag::note_ovl_candidate_bad_base_to_derived_conv)
8392       << (unsigned) FnKind << FnDesc
8393       << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8394       << (BaseToDerivedConversion - 1)
8395       << FromTy << ToTy << I+1;
8396     MaybeEmitInheritedConstructorNote(S, Fn);
8397     return;
8398   }
8399 
8400   if (isa<ObjCObjectPointerType>(CFromTy) &&
8401       isa<PointerType>(CToTy)) {
8402       Qualifiers FromQs = CFromTy.getQualifiers();
8403       Qualifiers ToQs = CToTy.getQualifiers();
8404       if (FromQs.getObjCLifetime() != ToQs.getObjCLifetime()) {
8405         S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_arc_conv)
8406         << (unsigned) FnKind << FnDesc
8407         << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8408         << FromTy << ToTy << (unsigned) isObjectArgument << I+1;
8409         MaybeEmitInheritedConstructorNote(S, Fn);
8410         return;
8411       }
8412   }
8413 
8414   // Emit the generic diagnostic and, optionally, add the hints to it.
8415   PartialDiagnostic FDiag = S.PDiag(diag::note_ovl_candidate_bad_conv);
8416   FDiag << (unsigned) FnKind << FnDesc
8417     << (FromExpr ? FromExpr->getSourceRange() : SourceRange())
8418     << FromTy << ToTy << (unsigned) isObjectArgument << I + 1
8419     << (unsigned) (Cand->Fix.Kind);
8420 
8421   // If we can fix the conversion, suggest the FixIts.
8422   for (std::vector<FixItHint>::iterator HI = Cand->Fix.Hints.begin(),
8423        HE = Cand->Fix.Hints.end(); HI != HE; ++HI)
8424     FDiag << *HI;
8425   S.Diag(Fn->getLocation(), FDiag);
8426 
8427   MaybeEmitInheritedConstructorNote(S, Fn);
8428 }
8429 
8430 void DiagnoseArityMismatch(Sema &S, OverloadCandidate *Cand,
8431                            unsigned NumFormalArgs) {
8432   // TODO: treat calls to a missing default constructor as a special case
8433 
8434   FunctionDecl *Fn = Cand->Function;
8435   const FunctionProtoType *FnTy = Fn->getType()->getAs<FunctionProtoType>();
8436 
8437   unsigned MinParams = Fn->getMinRequiredArguments();
8438 
8439   // With invalid overloaded operators, it's possible that we think we
8440   // have an arity mismatch when it fact it looks like we have the
8441   // right number of arguments, because only overloaded operators have
8442   // the weird behavior of overloading member and non-member functions.
8443   // Just don't report anything.
8444   if (Fn->isInvalidDecl() &&
8445       Fn->getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
8446     return;
8447 
8448   // at least / at most / exactly
8449   unsigned mode, modeCount;
8450   if (NumFormalArgs < MinParams) {
8451     assert((Cand->FailureKind == ovl_fail_too_few_arguments) ||
8452            (Cand->FailureKind == ovl_fail_bad_deduction &&
8453             Cand->DeductionFailure.Result == Sema::TDK_TooFewArguments));
8454     if (MinParams != FnTy->getNumArgs() ||
8455         FnTy->isVariadic() || FnTy->isTemplateVariadic())
8456       mode = 0; // "at least"
8457     else
8458       mode = 2; // "exactly"
8459     modeCount = MinParams;
8460   } else {
8461     assert((Cand->FailureKind == ovl_fail_too_many_arguments) ||
8462            (Cand->FailureKind == ovl_fail_bad_deduction &&
8463             Cand->DeductionFailure.Result == Sema::TDK_TooManyArguments));
8464     if (MinParams != FnTy->getNumArgs())
8465       mode = 1; // "at most"
8466     else
8467       mode = 2; // "exactly"
8468     modeCount = FnTy->getNumArgs();
8469   }
8470 
8471   std::string Description;
8472   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, Description);
8473 
8474   if (modeCount == 1 && Fn->getParamDecl(0)->getDeclName())
8475     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity_one)
8476       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != 0) << mode
8477       << Fn->getParamDecl(0) << NumFormalArgs;
8478   else
8479     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_arity)
8480       << (unsigned) FnKind << (Fn->getDescribedFunctionTemplate() != 0) << mode
8481       << modeCount << NumFormalArgs;
8482   MaybeEmitInheritedConstructorNote(S, Fn);
8483 }
8484 
8485 /// Diagnose a failed template-argument deduction.
8486 void DiagnoseBadDeduction(Sema &S, OverloadCandidate *Cand,
8487                           unsigned NumArgs) {
8488   FunctionDecl *Fn = Cand->Function; // pattern
8489 
8490   TemplateParameter Param = Cand->DeductionFailure.getTemplateParameter();
8491   NamedDecl *ParamD;
8492   (ParamD = Param.dyn_cast<TemplateTypeParmDecl*>()) ||
8493   (ParamD = Param.dyn_cast<NonTypeTemplateParmDecl*>()) ||
8494   (ParamD = Param.dyn_cast<TemplateTemplateParmDecl*>());
8495   switch (Cand->DeductionFailure.Result) {
8496   case Sema::TDK_Success:
8497     llvm_unreachable("TDK_success while diagnosing bad deduction");
8498 
8499   case Sema::TDK_Incomplete: {
8500     assert(ParamD && "no parameter found for incomplete deduction result");
8501     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_incomplete_deduction)
8502       << ParamD->getDeclName();
8503     MaybeEmitInheritedConstructorNote(S, Fn);
8504     return;
8505   }
8506 
8507   case Sema::TDK_Underqualified: {
8508     assert(ParamD && "no parameter found for bad qualifiers deduction result");
8509     TemplateTypeParmDecl *TParam = cast<TemplateTypeParmDecl>(ParamD);
8510 
8511     QualType Param = Cand->DeductionFailure.getFirstArg()->getAsType();
8512 
8513     // Param will have been canonicalized, but it should just be a
8514     // qualified version of ParamD, so move the qualifiers to that.
8515     QualifierCollector Qs;
8516     Qs.strip(Param);
8517     QualType NonCanonParam = Qs.apply(S.Context, TParam->getTypeForDecl());
8518     assert(S.Context.hasSameType(Param, NonCanonParam));
8519 
8520     // Arg has also been canonicalized, but there's nothing we can do
8521     // about that.  It also doesn't matter as much, because it won't
8522     // have any template parameters in it (because deduction isn't
8523     // done on dependent types).
8524     QualType Arg = Cand->DeductionFailure.getSecondArg()->getAsType();
8525 
8526     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_underqualified)
8527       << ParamD->getDeclName() << Arg << NonCanonParam;
8528     MaybeEmitInheritedConstructorNote(S, Fn);
8529     return;
8530   }
8531 
8532   case Sema::TDK_Inconsistent: {
8533     assert(ParamD && "no parameter found for inconsistent deduction result");
8534     int which = 0;
8535     if (isa<TemplateTypeParmDecl>(ParamD))
8536       which = 0;
8537     else if (isa<NonTypeTemplateParmDecl>(ParamD))
8538       which = 1;
8539     else {
8540       which = 2;
8541     }
8542 
8543     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_inconsistent_deduction)
8544       << which << ParamD->getDeclName()
8545       << *Cand->DeductionFailure.getFirstArg()
8546       << *Cand->DeductionFailure.getSecondArg();
8547     MaybeEmitInheritedConstructorNote(S, Fn);
8548     return;
8549   }
8550 
8551   case Sema::TDK_InvalidExplicitArguments:
8552     assert(ParamD && "no parameter found for invalid explicit arguments");
8553     if (ParamD->getDeclName())
8554       S.Diag(Fn->getLocation(),
8555              diag::note_ovl_candidate_explicit_arg_mismatch_named)
8556         << ParamD->getDeclName();
8557     else {
8558       int index = 0;
8559       if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(ParamD))
8560         index = TTP->getIndex();
8561       else if (NonTypeTemplateParmDecl *NTTP
8562                                   = dyn_cast<NonTypeTemplateParmDecl>(ParamD))
8563         index = NTTP->getIndex();
8564       else
8565         index = cast<TemplateTemplateParmDecl>(ParamD)->getIndex();
8566       S.Diag(Fn->getLocation(),
8567              diag::note_ovl_candidate_explicit_arg_mismatch_unnamed)
8568         << (index + 1);
8569     }
8570     MaybeEmitInheritedConstructorNote(S, Fn);
8571     return;
8572 
8573   case Sema::TDK_TooManyArguments:
8574   case Sema::TDK_TooFewArguments:
8575     DiagnoseArityMismatch(S, Cand, NumArgs);
8576     return;
8577 
8578   case Sema::TDK_InstantiationDepth:
8579     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_instantiation_depth);
8580     MaybeEmitInheritedConstructorNote(S, Fn);
8581     return;
8582 
8583   case Sema::TDK_SubstitutionFailure: {
8584     // Format the template argument list into the argument string.
8585     SmallString<128> TemplateArgString;
8586     if (TemplateArgumentList *Args =
8587           Cand->DeductionFailure.getTemplateArgumentList()) {
8588       TemplateArgString = " ";
8589       TemplateArgString += S.getTemplateArgumentBindingsText(
8590           Fn->getDescribedFunctionTemplate()->getTemplateParameters(), *Args);
8591     }
8592 
8593     // If this candidate was disabled by enable_if, say so.
8594     PartialDiagnosticAt *PDiag = Cand->DeductionFailure.getSFINAEDiagnostic();
8595     if (PDiag && PDiag->second.getDiagID() ==
8596           diag::err_typename_nested_not_found_enable_if) {
8597       // FIXME: Use the source range of the condition, and the fully-qualified
8598       //        name of the enable_if template. These are both present in PDiag.
8599       S.Diag(PDiag->first, diag::note_ovl_candidate_disabled_by_enable_if)
8600         << "'enable_if'" << TemplateArgString;
8601       return;
8602     }
8603 
8604     // Format the SFINAE diagnostic into the argument string.
8605     // FIXME: Add a general mechanism to include a PartialDiagnostic *'s
8606     //        formatted message in another diagnostic.
8607     SmallString<128> SFINAEArgString;
8608     SourceRange R;
8609     if (PDiag) {
8610       SFINAEArgString = ": ";
8611       R = SourceRange(PDiag->first, PDiag->first);
8612       PDiag->second.EmitToString(S.getDiagnostics(), SFINAEArgString);
8613     }
8614 
8615     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_substitution_failure)
8616       << TemplateArgString << SFINAEArgString << R;
8617     MaybeEmitInheritedConstructorNote(S, Fn);
8618     return;
8619   }
8620 
8621   case Sema::TDK_FailedOverloadResolution: {
8622     OverloadExpr::FindResult R =
8623         OverloadExpr::find(Cand->DeductionFailure.getExpr());
8624     S.Diag(Fn->getLocation(),
8625            diag::note_ovl_candidate_failed_overload_resolution)
8626       << R.Expression->getName();
8627     return;
8628   }
8629 
8630   case Sema::TDK_NonDeducedMismatch: {
8631     // FIXME: Provide a source location to indicate what we couldn't match.
8632     TemplateArgument FirstTA = *Cand->DeductionFailure.getFirstArg();
8633     TemplateArgument SecondTA = *Cand->DeductionFailure.getSecondArg();
8634     if (FirstTA.getKind() == TemplateArgument::Template &&
8635         SecondTA.getKind() == TemplateArgument::Template) {
8636       TemplateName FirstTN = FirstTA.getAsTemplate();
8637       TemplateName SecondTN = SecondTA.getAsTemplate();
8638       if (FirstTN.getKind() == TemplateName::Template &&
8639           SecondTN.getKind() == TemplateName::Template) {
8640         if (FirstTN.getAsTemplateDecl()->getName() ==
8641             SecondTN.getAsTemplateDecl()->getName()) {
8642           // FIXME: This fixes a bad diagnostic where both templates are named
8643           // the same.  This particular case is a bit difficult since:
8644           // 1) It is passed as a string to the diagnostic printer.
8645           // 2) The diagnostic printer only attempts to find a better
8646           //    name for types, not decls.
8647           // Ideally, this should folded into the diagnostic printer.
8648           S.Diag(Fn->getLocation(),
8649                  diag::note_ovl_candidate_non_deduced_mismatch_qualified)
8650               << FirstTN.getAsTemplateDecl() << SecondTN.getAsTemplateDecl();
8651           return;
8652         }
8653       }
8654     }
8655     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_non_deduced_mismatch)
8656       << FirstTA << SecondTA;
8657     return;
8658   }
8659   // TODO: diagnose these individually, then kill off
8660   // note_ovl_candidate_bad_deduction, which is uselessly vague.
8661   case Sema::TDK_MiscellaneousDeductionFailure:
8662     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_bad_deduction);
8663     MaybeEmitInheritedConstructorNote(S, Fn);
8664     return;
8665   }
8666 }
8667 
8668 /// CUDA: diagnose an invalid call across targets.
8669 void DiagnoseBadTarget(Sema &S, OverloadCandidate *Cand) {
8670   FunctionDecl *Caller = cast<FunctionDecl>(S.CurContext);
8671   FunctionDecl *Callee = Cand->Function;
8672 
8673   Sema::CUDAFunctionTarget CallerTarget = S.IdentifyCUDATarget(Caller),
8674                            CalleeTarget = S.IdentifyCUDATarget(Callee);
8675 
8676   std::string FnDesc;
8677   OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Callee, FnDesc);
8678 
8679   S.Diag(Callee->getLocation(), diag::note_ovl_candidate_bad_target)
8680       << (unsigned) FnKind << CalleeTarget << CallerTarget;
8681 }
8682 
8683 /// Generates a 'note' diagnostic for an overload candidate.  We've
8684 /// already generated a primary error at the call site.
8685 ///
8686 /// It really does need to be a single diagnostic with its caret
8687 /// pointed at the candidate declaration.  Yes, this creates some
8688 /// major challenges of technical writing.  Yes, this makes pointing
8689 /// out problems with specific arguments quite awkward.  It's still
8690 /// better than generating twenty screens of text for every failed
8691 /// overload.
8692 ///
8693 /// It would be great to be able to express per-candidate problems
8694 /// more richly for those diagnostic clients that cared, but we'd
8695 /// still have to be just as careful with the default diagnostics.
8696 void NoteFunctionCandidate(Sema &S, OverloadCandidate *Cand,
8697                            unsigned NumArgs) {
8698   FunctionDecl *Fn = Cand->Function;
8699 
8700   // Note deleted candidates, but only if they're viable.
8701   if (Cand->Viable && (Fn->isDeleted() ||
8702       S.isFunctionConsideredUnavailable(Fn))) {
8703     std::string FnDesc;
8704     OverloadCandidateKind FnKind = ClassifyOverloadCandidate(S, Fn, FnDesc);
8705 
8706     S.Diag(Fn->getLocation(), diag::note_ovl_candidate_deleted)
8707       << FnKind << FnDesc
8708       << (Fn->isDeleted() ? (Fn->isDeletedAsWritten() ? 1 : 2) : 0);
8709     MaybeEmitInheritedConstructorNote(S, Fn);
8710     return;
8711   }
8712 
8713   // We don't really have anything else to say about viable candidates.
8714   if (Cand->Viable) {
8715     S.NoteOverloadCandidate(Fn);
8716     return;
8717   }
8718 
8719   switch (Cand->FailureKind) {
8720   case ovl_fail_too_many_arguments:
8721   case ovl_fail_too_few_arguments:
8722     return DiagnoseArityMismatch(S, Cand, NumArgs);
8723 
8724   case ovl_fail_bad_deduction:
8725     return DiagnoseBadDeduction(S, Cand, NumArgs);
8726 
8727   case ovl_fail_trivial_conversion:
8728   case ovl_fail_bad_final_conversion:
8729   case ovl_fail_final_conversion_not_exact:
8730     return S.NoteOverloadCandidate(Fn);
8731 
8732   case ovl_fail_bad_conversion: {
8733     unsigned I = (Cand->IgnoreObjectArgument ? 1 : 0);
8734     for (unsigned N = Cand->NumConversions; I != N; ++I)
8735       if (Cand->Conversions[I].isBad())
8736         return DiagnoseBadConversion(S, Cand, I);
8737 
8738     // FIXME: this currently happens when we're called from SemaInit
8739     // when user-conversion overload fails.  Figure out how to handle
8740     // those conditions and diagnose them well.
8741     return S.NoteOverloadCandidate(Fn);
8742   }
8743 
8744   case ovl_fail_bad_target:
8745     return DiagnoseBadTarget(S, Cand);
8746   }
8747 }
8748 
8749 void NoteSurrogateCandidate(Sema &S, OverloadCandidate *Cand) {
8750   // Desugar the type of the surrogate down to a function type,
8751   // retaining as many typedefs as possible while still showing
8752   // the function type (and, therefore, its parameter types).
8753   QualType FnType = Cand->Surrogate->getConversionType();
8754   bool isLValueReference = false;
8755   bool isRValueReference = false;
8756   bool isPointer = false;
8757   if (const LValueReferenceType *FnTypeRef =
8758         FnType->getAs<LValueReferenceType>()) {
8759     FnType = FnTypeRef->getPointeeType();
8760     isLValueReference = true;
8761   } else if (const RValueReferenceType *FnTypeRef =
8762                FnType->getAs<RValueReferenceType>()) {
8763     FnType = FnTypeRef->getPointeeType();
8764     isRValueReference = true;
8765   }
8766   if (const PointerType *FnTypePtr = FnType->getAs<PointerType>()) {
8767     FnType = FnTypePtr->getPointeeType();
8768     isPointer = true;
8769   }
8770   // Desugar down to a function type.
8771   FnType = QualType(FnType->getAs<FunctionType>(), 0);
8772   // Reconstruct the pointer/reference as appropriate.
8773   if (isPointer) FnType = S.Context.getPointerType(FnType);
8774   if (isRValueReference) FnType = S.Context.getRValueReferenceType(FnType);
8775   if (isLValueReference) FnType = S.Context.getLValueReferenceType(FnType);
8776 
8777   S.Diag(Cand->Surrogate->getLocation(), diag::note_ovl_surrogate_cand)
8778     << FnType;
8779   MaybeEmitInheritedConstructorNote(S, Cand->Surrogate);
8780 }
8781 
8782 void NoteBuiltinOperatorCandidate(Sema &S,
8783                                   StringRef Opc,
8784                                   SourceLocation OpLoc,
8785                                   OverloadCandidate *Cand) {
8786   assert(Cand->NumConversions <= 2 && "builtin operator is not binary");
8787   std::string TypeStr("operator");
8788   TypeStr += Opc;
8789   TypeStr += "(";
8790   TypeStr += Cand->BuiltinTypes.ParamTypes[0].getAsString();
8791   if (Cand->NumConversions == 1) {
8792     TypeStr += ")";
8793     S.Diag(OpLoc, diag::note_ovl_builtin_unary_candidate) << TypeStr;
8794   } else {
8795     TypeStr += ", ";
8796     TypeStr += Cand->BuiltinTypes.ParamTypes[1].getAsString();
8797     TypeStr += ")";
8798     S.Diag(OpLoc, diag::note_ovl_builtin_binary_candidate) << TypeStr;
8799   }
8800 }
8801 
8802 void NoteAmbiguousUserConversions(Sema &S, SourceLocation OpLoc,
8803                                   OverloadCandidate *Cand) {
8804   unsigned NoOperands = Cand->NumConversions;
8805   for (unsigned ArgIdx = 0; ArgIdx < NoOperands; ++ArgIdx) {
8806     const ImplicitConversionSequence &ICS = Cand->Conversions[ArgIdx];
8807     if (ICS.isBad()) break; // all meaningless after first invalid
8808     if (!ICS.isAmbiguous()) continue;
8809 
8810     ICS.DiagnoseAmbiguousConversion(S, OpLoc,
8811                               S.PDiag(diag::note_ambiguous_type_conversion));
8812   }
8813 }
8814 
8815 SourceLocation GetLocationForCandidate(const OverloadCandidate *Cand) {
8816   if (Cand->Function)
8817     return Cand->Function->getLocation();
8818   if (Cand->IsSurrogate)
8819     return Cand->Surrogate->getLocation();
8820   return SourceLocation();
8821 }
8822 
8823 static unsigned
8824 RankDeductionFailure(const OverloadCandidate::DeductionFailureInfo &DFI) {
8825   switch ((Sema::TemplateDeductionResult)DFI.Result) {
8826   case Sema::TDK_Success:
8827     llvm_unreachable("TDK_success while diagnosing bad deduction");
8828 
8829   case Sema::TDK_Invalid:
8830   case Sema::TDK_Incomplete:
8831     return 1;
8832 
8833   case Sema::TDK_Underqualified:
8834   case Sema::TDK_Inconsistent:
8835     return 2;
8836 
8837   case Sema::TDK_SubstitutionFailure:
8838   case Sema::TDK_NonDeducedMismatch:
8839   case Sema::TDK_MiscellaneousDeductionFailure:
8840     return 3;
8841 
8842   case Sema::TDK_InstantiationDepth:
8843   case Sema::TDK_FailedOverloadResolution:
8844     return 4;
8845 
8846   case Sema::TDK_InvalidExplicitArguments:
8847     return 5;
8848 
8849   case Sema::TDK_TooManyArguments:
8850   case Sema::TDK_TooFewArguments:
8851     return 6;
8852   }
8853   llvm_unreachable("Unhandled deduction result");
8854 }
8855 
8856 struct CompareOverloadCandidatesForDisplay {
8857   Sema &S;
8858   CompareOverloadCandidatesForDisplay(Sema &S) : S(S) {}
8859 
8860   bool operator()(const OverloadCandidate *L,
8861                   const OverloadCandidate *R) {
8862     // Fast-path this check.
8863     if (L == R) return false;
8864 
8865     // Order first by viability.
8866     if (L->Viable) {
8867       if (!R->Viable) return true;
8868 
8869       // TODO: introduce a tri-valued comparison for overload
8870       // candidates.  Would be more worthwhile if we had a sort
8871       // that could exploit it.
8872       if (isBetterOverloadCandidate(S, *L, *R, SourceLocation())) return true;
8873       if (isBetterOverloadCandidate(S, *R, *L, SourceLocation())) return false;
8874     } else if (R->Viable)
8875       return false;
8876 
8877     assert(L->Viable == R->Viable);
8878 
8879     // Criteria by which we can sort non-viable candidates:
8880     if (!L->Viable) {
8881       // 1. Arity mismatches come after other candidates.
8882       if (L->FailureKind == ovl_fail_too_many_arguments ||
8883           L->FailureKind == ovl_fail_too_few_arguments)
8884         return false;
8885       if (R->FailureKind == ovl_fail_too_many_arguments ||
8886           R->FailureKind == ovl_fail_too_few_arguments)
8887         return true;
8888 
8889       // 2. Bad conversions come first and are ordered by the number
8890       // of bad conversions and quality of good conversions.
8891       if (L->FailureKind == ovl_fail_bad_conversion) {
8892         if (R->FailureKind != ovl_fail_bad_conversion)
8893           return true;
8894 
8895         // The conversion that can be fixed with a smaller number of changes,
8896         // comes first.
8897         unsigned numLFixes = L->Fix.NumConversionsFixed;
8898         unsigned numRFixes = R->Fix.NumConversionsFixed;
8899         numLFixes = (numLFixes == 0) ? UINT_MAX : numLFixes;
8900         numRFixes = (numRFixes == 0) ? UINT_MAX : numRFixes;
8901         if (numLFixes != numRFixes) {
8902           if (numLFixes < numRFixes)
8903             return true;
8904           else
8905             return false;
8906         }
8907 
8908         // If there's any ordering between the defined conversions...
8909         // FIXME: this might not be transitive.
8910         assert(L->NumConversions == R->NumConversions);
8911 
8912         int leftBetter = 0;
8913         unsigned I = (L->IgnoreObjectArgument || R->IgnoreObjectArgument);
8914         for (unsigned E = L->NumConversions; I != E; ++I) {
8915           switch (CompareImplicitConversionSequences(S,
8916                                                      L->Conversions[I],
8917                                                      R->Conversions[I])) {
8918           case ImplicitConversionSequence::Better:
8919             leftBetter++;
8920             break;
8921 
8922           case ImplicitConversionSequence::Worse:
8923             leftBetter--;
8924             break;
8925 
8926           case ImplicitConversionSequence::Indistinguishable:
8927             break;
8928           }
8929         }
8930         if (leftBetter > 0) return true;
8931         if (leftBetter < 0) return false;
8932 
8933       } else if (R->FailureKind == ovl_fail_bad_conversion)
8934         return false;
8935 
8936       if (L->FailureKind == ovl_fail_bad_deduction) {
8937         if (R->FailureKind != ovl_fail_bad_deduction)
8938           return true;
8939 
8940         if (L->DeductionFailure.Result != R->DeductionFailure.Result)
8941           return RankDeductionFailure(L->DeductionFailure)
8942                < RankDeductionFailure(R->DeductionFailure);
8943       } else if (R->FailureKind == ovl_fail_bad_deduction)
8944         return false;
8945 
8946       // TODO: others?
8947     }
8948 
8949     // Sort everything else by location.
8950     SourceLocation LLoc = GetLocationForCandidate(L);
8951     SourceLocation RLoc = GetLocationForCandidate(R);
8952 
8953     // Put candidates without locations (e.g. builtins) at the end.
8954     if (LLoc.isInvalid()) return false;
8955     if (RLoc.isInvalid()) return true;
8956 
8957     return S.SourceMgr.isBeforeInTranslationUnit(LLoc, RLoc);
8958   }
8959 };
8960 
8961 /// CompleteNonViableCandidate - Normally, overload resolution only
8962 /// computes up to the first. Produces the FixIt set if possible.
8963 void CompleteNonViableCandidate(Sema &S, OverloadCandidate *Cand,
8964                                 ArrayRef<Expr *> Args) {
8965   assert(!Cand->Viable);
8966 
8967   // Don't do anything on failures other than bad conversion.
8968   if (Cand->FailureKind != ovl_fail_bad_conversion) return;
8969 
8970   // We only want the FixIts if all the arguments can be corrected.
8971   bool Unfixable = false;
8972   // Use a implicit copy initialization to check conversion fixes.
8973   Cand->Fix.setConversionChecker(TryCopyInitialization);
8974 
8975   // Skip forward to the first bad conversion.
8976   unsigned ConvIdx = (Cand->IgnoreObjectArgument ? 1 : 0);
8977   unsigned ConvCount = Cand->NumConversions;
8978   while (true) {
8979     assert(ConvIdx != ConvCount && "no bad conversion in candidate");
8980     ConvIdx++;
8981     if (Cand->Conversions[ConvIdx - 1].isBad()) {
8982       Unfixable = !Cand->TryToFixBadConversion(ConvIdx - 1, S);
8983       break;
8984     }
8985   }
8986 
8987   if (ConvIdx == ConvCount)
8988     return;
8989 
8990   assert(!Cand->Conversions[ConvIdx].isInitialized() &&
8991          "remaining conversion is initialized?");
8992 
8993   // FIXME: this should probably be preserved from the overload
8994   // operation somehow.
8995   bool SuppressUserConversions = false;
8996 
8997   const FunctionProtoType* Proto;
8998   unsigned ArgIdx = ConvIdx;
8999 
9000   if (Cand->IsSurrogate) {
9001     QualType ConvType
9002       = Cand->Surrogate->getConversionType().getNonReferenceType();
9003     if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
9004       ConvType = ConvPtrType->getPointeeType();
9005     Proto = ConvType->getAs<FunctionProtoType>();
9006     ArgIdx--;
9007   } else if (Cand->Function) {
9008     Proto = Cand->Function->getType()->getAs<FunctionProtoType>();
9009     if (isa<CXXMethodDecl>(Cand->Function) &&
9010         !isa<CXXConstructorDecl>(Cand->Function))
9011       ArgIdx--;
9012   } else {
9013     // Builtin binary operator with a bad first conversion.
9014     assert(ConvCount <= 3);
9015     for (; ConvIdx != ConvCount; ++ConvIdx)
9016       Cand->Conversions[ConvIdx]
9017         = TryCopyInitialization(S, Args[ConvIdx],
9018                                 Cand->BuiltinTypes.ParamTypes[ConvIdx],
9019                                 SuppressUserConversions,
9020                                 /*InOverloadResolution*/ true,
9021                                 /*AllowObjCWritebackConversion=*/
9022                                   S.getLangOpts().ObjCAutoRefCount);
9023     return;
9024   }
9025 
9026   // Fill in the rest of the conversions.
9027   unsigned NumArgsInProto = Proto->getNumArgs();
9028   for (; ConvIdx != ConvCount; ++ConvIdx, ++ArgIdx) {
9029     if (ArgIdx < NumArgsInProto) {
9030       Cand->Conversions[ConvIdx]
9031         = TryCopyInitialization(S, Args[ArgIdx], Proto->getArgType(ArgIdx),
9032                                 SuppressUserConversions,
9033                                 /*InOverloadResolution=*/true,
9034                                 /*AllowObjCWritebackConversion=*/
9035                                   S.getLangOpts().ObjCAutoRefCount);
9036       // Store the FixIt in the candidate if it exists.
9037       if (!Unfixable && Cand->Conversions[ConvIdx].isBad())
9038         Unfixable = !Cand->TryToFixBadConversion(ConvIdx, S);
9039     }
9040     else
9041       Cand->Conversions[ConvIdx].setEllipsis();
9042   }
9043 }
9044 
9045 } // end anonymous namespace
9046 
9047 /// PrintOverloadCandidates - When overload resolution fails, prints
9048 /// diagnostic messages containing the candidates in the candidate
9049 /// set.
9050 void OverloadCandidateSet::NoteCandidates(Sema &S,
9051                                           OverloadCandidateDisplayKind OCD,
9052                                           ArrayRef<Expr *> Args,
9053                                           StringRef Opc,
9054                                           SourceLocation OpLoc) {
9055   // Sort the candidates by viability and position.  Sorting directly would
9056   // be prohibitive, so we make a set of pointers and sort those.
9057   SmallVector<OverloadCandidate*, 32> Cands;
9058   if (OCD == OCD_AllCandidates) Cands.reserve(size());
9059   for (iterator Cand = begin(), LastCand = end(); Cand != LastCand; ++Cand) {
9060     if (Cand->Viable)
9061       Cands.push_back(Cand);
9062     else if (OCD == OCD_AllCandidates) {
9063       CompleteNonViableCandidate(S, Cand, Args);
9064       if (Cand->Function || Cand->IsSurrogate)
9065         Cands.push_back(Cand);
9066       // Otherwise, this a non-viable builtin candidate.  We do not, in general,
9067       // want to list every possible builtin candidate.
9068     }
9069   }
9070 
9071   std::sort(Cands.begin(), Cands.end(),
9072             CompareOverloadCandidatesForDisplay(S));
9073 
9074   bool ReportedAmbiguousConversions = false;
9075 
9076   SmallVectorImpl<OverloadCandidate*>::iterator I, E;
9077   const OverloadsShown ShowOverloads = S.Diags.getShowOverloads();
9078   unsigned CandsShown = 0;
9079   for (I = Cands.begin(), E = Cands.end(); I != E; ++I) {
9080     OverloadCandidate *Cand = *I;
9081 
9082     // Set an arbitrary limit on the number of candidate functions we'll spam
9083     // the user with.  FIXME: This limit should depend on details of the
9084     // candidate list.
9085     if (CandsShown >= 4 && ShowOverloads == Ovl_Best) {
9086       break;
9087     }
9088     ++CandsShown;
9089 
9090     if (Cand->Function)
9091       NoteFunctionCandidate(S, Cand, Args.size());
9092     else if (Cand->IsSurrogate)
9093       NoteSurrogateCandidate(S, Cand);
9094     else {
9095       assert(Cand->Viable &&
9096              "Non-viable built-in candidates are not added to Cands.");
9097       // Generally we only see ambiguities including viable builtin
9098       // operators if overload resolution got screwed up by an
9099       // ambiguous user-defined conversion.
9100       //
9101       // FIXME: It's quite possible for different conversions to see
9102       // different ambiguities, though.
9103       if (!ReportedAmbiguousConversions) {
9104         NoteAmbiguousUserConversions(S, OpLoc, Cand);
9105         ReportedAmbiguousConversions = true;
9106       }
9107 
9108       // If this is a viable builtin, print it.
9109       NoteBuiltinOperatorCandidate(S, Opc, OpLoc, Cand);
9110     }
9111   }
9112 
9113   if (I != E)
9114     S.Diag(OpLoc, diag::note_ovl_too_many_candidates) << int(E - I);
9115 }
9116 
9117 // [PossiblyAFunctionType]  -->   [Return]
9118 // NonFunctionType --> NonFunctionType
9119 // R (A) --> R(A)
9120 // R (*)(A) --> R (A)
9121 // R (&)(A) --> R (A)
9122 // R (S::*)(A) --> R (A)
9123 QualType Sema::ExtractUnqualifiedFunctionType(QualType PossiblyAFunctionType) {
9124   QualType Ret = PossiblyAFunctionType;
9125   if (const PointerType *ToTypePtr =
9126     PossiblyAFunctionType->getAs<PointerType>())
9127     Ret = ToTypePtr->getPointeeType();
9128   else if (const ReferenceType *ToTypeRef =
9129     PossiblyAFunctionType->getAs<ReferenceType>())
9130     Ret = ToTypeRef->getPointeeType();
9131   else if (const MemberPointerType *MemTypePtr =
9132     PossiblyAFunctionType->getAs<MemberPointerType>())
9133     Ret = MemTypePtr->getPointeeType();
9134   Ret =
9135     Context.getCanonicalType(Ret).getUnqualifiedType();
9136   return Ret;
9137 }
9138 
9139 // A helper class to help with address of function resolution
9140 // - allows us to avoid passing around all those ugly parameters
9141 class AddressOfFunctionResolver
9142 {
9143   Sema& S;
9144   Expr* SourceExpr;
9145   const QualType& TargetType;
9146   QualType TargetFunctionType; // Extracted function type from target type
9147 
9148   bool Complain;
9149   //DeclAccessPair& ResultFunctionAccessPair;
9150   ASTContext& Context;
9151 
9152   bool TargetTypeIsNonStaticMemberFunction;
9153   bool FoundNonTemplateFunction;
9154 
9155   OverloadExpr::FindResult OvlExprInfo;
9156   OverloadExpr *OvlExpr;
9157   TemplateArgumentListInfo OvlExplicitTemplateArgs;
9158   SmallVector<std::pair<DeclAccessPair, FunctionDecl*>, 4> Matches;
9159 
9160 public:
9161   AddressOfFunctionResolver(Sema &S, Expr* SourceExpr,
9162                             const QualType& TargetType, bool Complain)
9163     : S(S), SourceExpr(SourceExpr), TargetType(TargetType),
9164       Complain(Complain), Context(S.getASTContext()),
9165       TargetTypeIsNonStaticMemberFunction(
9166                                     !!TargetType->getAs<MemberPointerType>()),
9167       FoundNonTemplateFunction(false),
9168       OvlExprInfo(OverloadExpr::find(SourceExpr)),
9169       OvlExpr(OvlExprInfo.Expression)
9170   {
9171     ExtractUnqualifiedFunctionTypeFromTargetType();
9172 
9173     if (!TargetFunctionType->isFunctionType()) {
9174       if (OvlExpr->hasExplicitTemplateArgs()) {
9175         DeclAccessPair dap;
9176         if (FunctionDecl* Fn = S.ResolveSingleFunctionTemplateSpecialization(
9177                                             OvlExpr, false, &dap) ) {
9178 
9179           if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
9180             if (!Method->isStatic()) {
9181               // If the target type is a non-function type and the function
9182               // found is a non-static member function, pretend as if that was
9183               // the target, it's the only possible type to end up with.
9184               TargetTypeIsNonStaticMemberFunction = true;
9185 
9186               // And skip adding the function if its not in the proper form.
9187               // We'll diagnose this due to an empty set of functions.
9188               if (!OvlExprInfo.HasFormOfMemberPointer)
9189                 return;
9190             }
9191           }
9192 
9193           Matches.push_back(std::make_pair(dap,Fn));
9194         }
9195       }
9196       return;
9197     }
9198 
9199     if (OvlExpr->hasExplicitTemplateArgs())
9200       OvlExpr->getExplicitTemplateArgs().copyInto(OvlExplicitTemplateArgs);
9201 
9202     if (FindAllFunctionsThatMatchTargetTypeExactly()) {
9203       // C++ [over.over]p4:
9204       //   If more than one function is selected, [...]
9205       if (Matches.size() > 1) {
9206         if (FoundNonTemplateFunction)
9207           EliminateAllTemplateMatches();
9208         else
9209           EliminateAllExceptMostSpecializedTemplate();
9210       }
9211     }
9212   }
9213 
9214 private:
9215   bool isTargetTypeAFunction() const {
9216     return TargetFunctionType->isFunctionType();
9217   }
9218 
9219   // [ToType]     [Return]
9220 
9221   // R (*)(A) --> R (A), IsNonStaticMemberFunction = false
9222   // R (&)(A) --> R (A), IsNonStaticMemberFunction = false
9223   // R (S::*)(A) --> R (A), IsNonStaticMemberFunction = true
9224   void inline ExtractUnqualifiedFunctionTypeFromTargetType() {
9225     TargetFunctionType = S.ExtractUnqualifiedFunctionType(TargetType);
9226   }
9227 
9228   // return true if any matching specializations were found
9229   bool AddMatchingTemplateFunction(FunctionTemplateDecl* FunctionTemplate,
9230                                    const DeclAccessPair& CurAccessFunPair) {
9231     if (CXXMethodDecl *Method
9232               = dyn_cast<CXXMethodDecl>(FunctionTemplate->getTemplatedDecl())) {
9233       // Skip non-static function templates when converting to pointer, and
9234       // static when converting to member pointer.
9235       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
9236         return false;
9237     }
9238     else if (TargetTypeIsNonStaticMemberFunction)
9239       return false;
9240 
9241     // C++ [over.over]p2:
9242     //   If the name is a function template, template argument deduction is
9243     //   done (14.8.2.2), and if the argument deduction succeeds, the
9244     //   resulting template argument list is used to generate a single
9245     //   function template specialization, which is added to the set of
9246     //   overloaded functions considered.
9247     FunctionDecl *Specialization = 0;
9248     TemplateDeductionInfo Info(OvlExpr->getNameLoc());
9249     if (Sema::TemplateDeductionResult Result
9250           = S.DeduceTemplateArguments(FunctionTemplate,
9251                                       &OvlExplicitTemplateArgs,
9252                                       TargetFunctionType, Specialization,
9253                                       Info, /*InOverloadResolution=*/true)) {
9254       // FIXME: make a note of the failed deduction for diagnostics.
9255       (void)Result;
9256       return false;
9257     }
9258 
9259     // Template argument deduction ensures that we have an exact match or
9260     // compatible pointer-to-function arguments that would be adjusted by ICS.
9261     // This function template specicalization works.
9262     Specialization = cast<FunctionDecl>(Specialization->getCanonicalDecl());
9263     assert(S.isSameOrCompatibleFunctionType(
9264               Context.getCanonicalType(Specialization->getType()),
9265               Context.getCanonicalType(TargetFunctionType)));
9266     Matches.push_back(std::make_pair(CurAccessFunPair, Specialization));
9267     return true;
9268   }
9269 
9270   bool AddMatchingNonTemplateFunction(NamedDecl* Fn,
9271                                       const DeclAccessPair& CurAccessFunPair) {
9272     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
9273       // Skip non-static functions when converting to pointer, and static
9274       // when converting to member pointer.
9275       if (Method->isStatic() == TargetTypeIsNonStaticMemberFunction)
9276         return false;
9277     }
9278     else if (TargetTypeIsNonStaticMemberFunction)
9279       return false;
9280 
9281     if (FunctionDecl *FunDecl = dyn_cast<FunctionDecl>(Fn)) {
9282       if (S.getLangOpts().CUDA)
9283         if (FunctionDecl *Caller = dyn_cast<FunctionDecl>(S.CurContext))
9284           if (S.CheckCUDATarget(Caller, FunDecl))
9285             return false;
9286 
9287       // If any candidate has a placeholder return type, trigger its deduction
9288       // now.
9289       if (S.getLangOpts().CPlusPlus1y &&
9290           FunDecl->getResultType()->isUndeducedType() &&
9291           S.DeduceReturnType(FunDecl, SourceExpr->getLocStart(), Complain))
9292         return false;
9293 
9294       QualType ResultTy;
9295       if (Context.hasSameUnqualifiedType(TargetFunctionType,
9296                                          FunDecl->getType()) ||
9297           S.IsNoReturnConversion(FunDecl->getType(), TargetFunctionType,
9298                                  ResultTy)) {
9299         Matches.push_back(std::make_pair(CurAccessFunPair,
9300           cast<FunctionDecl>(FunDecl->getCanonicalDecl())));
9301         FoundNonTemplateFunction = true;
9302         return true;
9303       }
9304     }
9305 
9306     return false;
9307   }
9308 
9309   bool FindAllFunctionsThatMatchTargetTypeExactly() {
9310     bool Ret = false;
9311 
9312     // If the overload expression doesn't have the form of a pointer to
9313     // member, don't try to convert it to a pointer-to-member type.
9314     if (IsInvalidFormOfPointerToMemberFunction())
9315       return false;
9316 
9317     for (UnresolvedSetIterator I = OvlExpr->decls_begin(),
9318                                E = OvlExpr->decls_end();
9319          I != E; ++I) {
9320       // Look through any using declarations to find the underlying function.
9321       NamedDecl *Fn = (*I)->getUnderlyingDecl();
9322 
9323       // C++ [over.over]p3:
9324       //   Non-member functions and static member functions match
9325       //   targets of type "pointer-to-function" or "reference-to-function."
9326       //   Nonstatic member functions match targets of
9327       //   type "pointer-to-member-function."
9328       // Note that according to DR 247, the containing class does not matter.
9329       if (FunctionTemplateDecl *FunctionTemplate
9330                                         = dyn_cast<FunctionTemplateDecl>(Fn)) {
9331         if (AddMatchingTemplateFunction(FunctionTemplate, I.getPair()))
9332           Ret = true;
9333       }
9334       // If we have explicit template arguments supplied, skip non-templates.
9335       else if (!OvlExpr->hasExplicitTemplateArgs() &&
9336                AddMatchingNonTemplateFunction(Fn, I.getPair()))
9337         Ret = true;
9338     }
9339     assert(Ret || Matches.empty());
9340     return Ret;
9341   }
9342 
9343   void EliminateAllExceptMostSpecializedTemplate() {
9344     //   [...] and any given function template specialization F1 is
9345     //   eliminated if the set contains a second function template
9346     //   specialization whose function template is more specialized
9347     //   than the function template of F1 according to the partial
9348     //   ordering rules of 14.5.5.2.
9349 
9350     // The algorithm specified above is quadratic. We instead use a
9351     // two-pass algorithm (similar to the one used to identify the
9352     // best viable function in an overload set) that identifies the
9353     // best function template (if it exists).
9354 
9355     UnresolvedSet<4> MatchesCopy; // TODO: avoid!
9356     for (unsigned I = 0, E = Matches.size(); I != E; ++I)
9357       MatchesCopy.addDecl(Matches[I].second, Matches[I].first.getAccess());
9358 
9359     UnresolvedSetIterator Result =
9360       S.getMostSpecialized(MatchesCopy.begin(), MatchesCopy.end(),
9361                            TPOC_Other, 0, SourceExpr->getLocStart(),
9362                            S.PDiag(),
9363                            S.PDiag(diag::err_addr_ovl_ambiguous)
9364                              << Matches[0].second->getDeclName(),
9365                            S.PDiag(diag::note_ovl_candidate)
9366                              << (unsigned) oc_function_template,
9367                            Complain, TargetFunctionType);
9368 
9369     if (Result != MatchesCopy.end()) {
9370       // Make it the first and only element
9371       Matches[0].first = Matches[Result - MatchesCopy.begin()].first;
9372       Matches[0].second = cast<FunctionDecl>(*Result);
9373       Matches.resize(1);
9374     }
9375   }
9376 
9377   void EliminateAllTemplateMatches() {
9378     //   [...] any function template specializations in the set are
9379     //   eliminated if the set also contains a non-template function, [...]
9380     for (unsigned I = 0, N = Matches.size(); I != N; ) {
9381       if (Matches[I].second->getPrimaryTemplate() == 0)
9382         ++I;
9383       else {
9384         Matches[I] = Matches[--N];
9385         Matches.set_size(N);
9386       }
9387     }
9388   }
9389 
9390 public:
9391   void ComplainNoMatchesFound() const {
9392     assert(Matches.empty());
9393     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_no_viable)
9394         << OvlExpr->getName() << TargetFunctionType
9395         << OvlExpr->getSourceRange();
9396     S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType);
9397   }
9398 
9399   bool IsInvalidFormOfPointerToMemberFunction() const {
9400     return TargetTypeIsNonStaticMemberFunction &&
9401       !OvlExprInfo.HasFormOfMemberPointer;
9402   }
9403 
9404   void ComplainIsInvalidFormOfPointerToMemberFunction() const {
9405       // TODO: Should we condition this on whether any functions might
9406       // have matched, or is it more appropriate to do that in callers?
9407       // TODO: a fixit wouldn't hurt.
9408       S.Diag(OvlExpr->getNameLoc(), diag::err_addr_ovl_no_qualifier)
9409         << TargetType << OvlExpr->getSourceRange();
9410   }
9411 
9412   void ComplainOfInvalidConversion() const {
9413     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_not_func_ptrref)
9414       << OvlExpr->getName() << TargetType;
9415   }
9416 
9417   void ComplainMultipleMatchesFound() const {
9418     assert(Matches.size() > 1);
9419     S.Diag(OvlExpr->getLocStart(), diag::err_addr_ovl_ambiguous)
9420       << OvlExpr->getName()
9421       << OvlExpr->getSourceRange();
9422     S.NoteAllOverloadCandidates(OvlExpr, TargetFunctionType);
9423   }
9424 
9425   bool hadMultipleCandidates() const { return (OvlExpr->getNumDecls() > 1); }
9426 
9427   int getNumMatches() const { return Matches.size(); }
9428 
9429   FunctionDecl* getMatchingFunctionDecl() const {
9430     if (Matches.size() != 1) return 0;
9431     return Matches[0].second;
9432   }
9433 
9434   const DeclAccessPair* getMatchingFunctionAccessPair() const {
9435     if (Matches.size() != 1) return 0;
9436     return &Matches[0].first;
9437   }
9438 };
9439 
9440 /// ResolveAddressOfOverloadedFunction - Try to resolve the address of
9441 /// an overloaded function (C++ [over.over]), where @p From is an
9442 /// expression with overloaded function type and @p ToType is the type
9443 /// we're trying to resolve to. For example:
9444 ///
9445 /// @code
9446 /// int f(double);
9447 /// int f(int);
9448 ///
9449 /// int (*pfd)(double) = f; // selects f(double)
9450 /// @endcode
9451 ///
9452 /// This routine returns the resulting FunctionDecl if it could be
9453 /// resolved, and NULL otherwise. When @p Complain is true, this
9454 /// routine will emit diagnostics if there is an error.
9455 FunctionDecl *
9456 Sema::ResolveAddressOfOverloadedFunction(Expr *AddressOfExpr,
9457                                          QualType TargetType,
9458                                          bool Complain,
9459                                          DeclAccessPair &FoundResult,
9460                                          bool *pHadMultipleCandidates) {
9461   assert(AddressOfExpr->getType() == Context.OverloadTy);
9462 
9463   AddressOfFunctionResolver Resolver(*this, AddressOfExpr, TargetType,
9464                                      Complain);
9465   int NumMatches = Resolver.getNumMatches();
9466   FunctionDecl* Fn = 0;
9467   if (NumMatches == 0 && Complain) {
9468     if (Resolver.IsInvalidFormOfPointerToMemberFunction())
9469       Resolver.ComplainIsInvalidFormOfPointerToMemberFunction();
9470     else
9471       Resolver.ComplainNoMatchesFound();
9472   }
9473   else if (NumMatches > 1 && Complain)
9474     Resolver.ComplainMultipleMatchesFound();
9475   else if (NumMatches == 1) {
9476     Fn = Resolver.getMatchingFunctionDecl();
9477     assert(Fn);
9478     FoundResult = *Resolver.getMatchingFunctionAccessPair();
9479     if (Complain)
9480       CheckAddressOfMemberAccess(AddressOfExpr, FoundResult);
9481   }
9482 
9483   if (pHadMultipleCandidates)
9484     *pHadMultipleCandidates = Resolver.hadMultipleCandidates();
9485   return Fn;
9486 }
9487 
9488 /// \brief Given an expression that refers to an overloaded function, try to
9489 /// resolve that overloaded function expression down to a single function.
9490 ///
9491 /// This routine can only resolve template-ids that refer to a single function
9492 /// template, where that template-id refers to a single template whose template
9493 /// arguments are either provided by the template-id or have defaults,
9494 /// as described in C++0x [temp.arg.explicit]p3.
9495 FunctionDecl *
9496 Sema::ResolveSingleFunctionTemplateSpecialization(OverloadExpr *ovl,
9497                                                   bool Complain,
9498                                                   DeclAccessPair *FoundResult) {
9499   // C++ [over.over]p1:
9500   //   [...] [Note: any redundant set of parentheses surrounding the
9501   //   overloaded function name is ignored (5.1). ]
9502   // C++ [over.over]p1:
9503   //   [...] The overloaded function name can be preceded by the &
9504   //   operator.
9505 
9506   // If we didn't actually find any template-ids, we're done.
9507   if (!ovl->hasExplicitTemplateArgs())
9508     return 0;
9509 
9510   TemplateArgumentListInfo ExplicitTemplateArgs;
9511   ovl->getExplicitTemplateArgs().copyInto(ExplicitTemplateArgs);
9512 
9513   // Look through all of the overloaded functions, searching for one
9514   // whose type matches exactly.
9515   FunctionDecl *Matched = 0;
9516   for (UnresolvedSetIterator I = ovl->decls_begin(),
9517          E = ovl->decls_end(); I != E; ++I) {
9518     // C++0x [temp.arg.explicit]p3:
9519     //   [...] In contexts where deduction is done and fails, or in contexts
9520     //   where deduction is not done, if a template argument list is
9521     //   specified and it, along with any default template arguments,
9522     //   identifies a single function template specialization, then the
9523     //   template-id is an lvalue for the function template specialization.
9524     FunctionTemplateDecl *FunctionTemplate
9525       = cast<FunctionTemplateDecl>((*I)->getUnderlyingDecl());
9526 
9527     // C++ [over.over]p2:
9528     //   If the name is a function template, template argument deduction is
9529     //   done (14.8.2.2), and if the argument deduction succeeds, the
9530     //   resulting template argument list is used to generate a single
9531     //   function template specialization, which is added to the set of
9532     //   overloaded functions considered.
9533     FunctionDecl *Specialization = 0;
9534     TemplateDeductionInfo Info(ovl->getNameLoc());
9535     if (TemplateDeductionResult Result
9536           = DeduceTemplateArguments(FunctionTemplate, &ExplicitTemplateArgs,
9537                                     Specialization, Info,
9538                                     /*InOverloadResolution=*/true)) {
9539       // FIXME: make a note of the failed deduction for diagnostics.
9540       (void)Result;
9541       continue;
9542     }
9543 
9544     assert(Specialization && "no specialization and no error?");
9545 
9546     // Multiple matches; we can't resolve to a single declaration.
9547     if (Matched) {
9548       if (Complain) {
9549         Diag(ovl->getExprLoc(), diag::err_addr_ovl_ambiguous)
9550           << ovl->getName();
9551         NoteAllOverloadCandidates(ovl);
9552       }
9553       return 0;
9554     }
9555 
9556     Matched = Specialization;
9557     if (FoundResult) *FoundResult = I.getPair();
9558   }
9559 
9560   if (Matched && getLangOpts().CPlusPlus1y &&
9561       Matched->getResultType()->isUndeducedType() &&
9562       DeduceReturnType(Matched, ovl->getExprLoc(), Complain))
9563     return 0;
9564 
9565   return Matched;
9566 }
9567 
9568 
9569 
9570 
9571 // Resolve and fix an overloaded expression that can be resolved
9572 // because it identifies a single function template specialization.
9573 //
9574 // Last three arguments should only be supplied if Complain = true
9575 //
9576 // Return true if it was logically possible to so resolve the
9577 // expression, regardless of whether or not it succeeded.  Always
9578 // returns true if 'complain' is set.
9579 bool Sema::ResolveAndFixSingleFunctionTemplateSpecialization(
9580                       ExprResult &SrcExpr, bool doFunctionPointerConverion,
9581                    bool complain, const SourceRange& OpRangeForComplaining,
9582                                            QualType DestTypeForComplaining,
9583                                             unsigned DiagIDForComplaining) {
9584   assert(SrcExpr.get()->getType() == Context.OverloadTy);
9585 
9586   OverloadExpr::FindResult ovl = OverloadExpr::find(SrcExpr.get());
9587 
9588   DeclAccessPair found;
9589   ExprResult SingleFunctionExpression;
9590   if (FunctionDecl *fn = ResolveSingleFunctionTemplateSpecialization(
9591                            ovl.Expression, /*complain*/ false, &found)) {
9592     if (DiagnoseUseOfDecl(fn, SrcExpr.get()->getLocStart())) {
9593       SrcExpr = ExprError();
9594       return true;
9595     }
9596 
9597     // It is only correct to resolve to an instance method if we're
9598     // resolving a form that's permitted to be a pointer to member.
9599     // Otherwise we'll end up making a bound member expression, which
9600     // is illegal in all the contexts we resolve like this.
9601     if (!ovl.HasFormOfMemberPointer &&
9602         isa<CXXMethodDecl>(fn) &&
9603         cast<CXXMethodDecl>(fn)->isInstance()) {
9604       if (!complain) return false;
9605 
9606       Diag(ovl.Expression->getExprLoc(),
9607            diag::err_bound_member_function)
9608         << 0 << ovl.Expression->getSourceRange();
9609 
9610       // TODO: I believe we only end up here if there's a mix of
9611       // static and non-static candidates (otherwise the expression
9612       // would have 'bound member' type, not 'overload' type).
9613       // Ideally we would note which candidate was chosen and why
9614       // the static candidates were rejected.
9615       SrcExpr = ExprError();
9616       return true;
9617     }
9618 
9619     // Fix the expression to refer to 'fn'.
9620     SingleFunctionExpression =
9621       Owned(FixOverloadedFunctionReference(SrcExpr.take(), found, fn));
9622 
9623     // If desired, do function-to-pointer decay.
9624     if (doFunctionPointerConverion) {
9625       SingleFunctionExpression =
9626         DefaultFunctionArrayLvalueConversion(SingleFunctionExpression.take());
9627       if (SingleFunctionExpression.isInvalid()) {
9628         SrcExpr = ExprError();
9629         return true;
9630       }
9631     }
9632   }
9633 
9634   if (!SingleFunctionExpression.isUsable()) {
9635     if (complain) {
9636       Diag(OpRangeForComplaining.getBegin(), DiagIDForComplaining)
9637         << ovl.Expression->getName()
9638         << DestTypeForComplaining
9639         << OpRangeForComplaining
9640         << ovl.Expression->getQualifierLoc().getSourceRange();
9641       NoteAllOverloadCandidates(SrcExpr.get());
9642 
9643       SrcExpr = ExprError();
9644       return true;
9645     }
9646 
9647     return false;
9648   }
9649 
9650   SrcExpr = SingleFunctionExpression;
9651   return true;
9652 }
9653 
9654 /// \brief Add a single candidate to the overload set.
9655 static void AddOverloadedCallCandidate(Sema &S,
9656                                        DeclAccessPair FoundDecl,
9657                                  TemplateArgumentListInfo *ExplicitTemplateArgs,
9658                                        ArrayRef<Expr *> Args,
9659                                        OverloadCandidateSet &CandidateSet,
9660                                        bool PartialOverloading,
9661                                        bool KnownValid) {
9662   NamedDecl *Callee = FoundDecl.getDecl();
9663   if (isa<UsingShadowDecl>(Callee))
9664     Callee = cast<UsingShadowDecl>(Callee)->getTargetDecl();
9665 
9666   if (FunctionDecl *Func = dyn_cast<FunctionDecl>(Callee)) {
9667     if (ExplicitTemplateArgs) {
9668       assert(!KnownValid && "Explicit template arguments?");
9669       return;
9670     }
9671     S.AddOverloadCandidate(Func, FoundDecl, Args, CandidateSet, false,
9672                            PartialOverloading);
9673     return;
9674   }
9675 
9676   if (FunctionTemplateDecl *FuncTemplate
9677       = dyn_cast<FunctionTemplateDecl>(Callee)) {
9678     S.AddTemplateOverloadCandidate(FuncTemplate, FoundDecl,
9679                                    ExplicitTemplateArgs, Args, CandidateSet);
9680     return;
9681   }
9682 
9683   assert(!KnownValid && "unhandled case in overloaded call candidate");
9684 }
9685 
9686 /// \brief Add the overload candidates named by callee and/or found by argument
9687 /// dependent lookup to the given overload set.
9688 void Sema::AddOverloadedCallCandidates(UnresolvedLookupExpr *ULE,
9689                                        ArrayRef<Expr *> Args,
9690                                        OverloadCandidateSet &CandidateSet,
9691                                        bool PartialOverloading) {
9692 
9693 #ifndef NDEBUG
9694   // Verify that ArgumentDependentLookup is consistent with the rules
9695   // in C++0x [basic.lookup.argdep]p3:
9696   //
9697   //   Let X be the lookup set produced by unqualified lookup (3.4.1)
9698   //   and let Y be the lookup set produced by argument dependent
9699   //   lookup (defined as follows). If X contains
9700   //
9701   //     -- a declaration of a class member, or
9702   //
9703   //     -- a block-scope function declaration that is not a
9704   //        using-declaration, or
9705   //
9706   //     -- a declaration that is neither a function or a function
9707   //        template
9708   //
9709   //   then Y is empty.
9710 
9711   if (ULE->requiresADL()) {
9712     for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
9713            E = ULE->decls_end(); I != E; ++I) {
9714       assert(!(*I)->getDeclContext()->isRecord());
9715       assert(isa<UsingShadowDecl>(*I) ||
9716              !(*I)->getDeclContext()->isFunctionOrMethod());
9717       assert((*I)->getUnderlyingDecl()->isFunctionOrFunctionTemplate());
9718     }
9719   }
9720 #endif
9721 
9722   // It would be nice to avoid this copy.
9723   TemplateArgumentListInfo TABuffer;
9724   TemplateArgumentListInfo *ExplicitTemplateArgs = 0;
9725   if (ULE->hasExplicitTemplateArgs()) {
9726     ULE->copyTemplateArgumentsInto(TABuffer);
9727     ExplicitTemplateArgs = &TABuffer;
9728   }
9729 
9730   for (UnresolvedLookupExpr::decls_iterator I = ULE->decls_begin(),
9731          E = ULE->decls_end(); I != E; ++I)
9732     AddOverloadedCallCandidate(*this, I.getPair(), ExplicitTemplateArgs, Args,
9733                                CandidateSet, PartialOverloading,
9734                                /*KnownValid*/ true);
9735 
9736   if (ULE->requiresADL())
9737     AddArgumentDependentLookupCandidates(ULE->getName(), /*Operator*/ false,
9738                                          ULE->getExprLoc(),
9739                                          Args, ExplicitTemplateArgs,
9740                                          CandidateSet, PartialOverloading);
9741 }
9742 
9743 /// Determine whether a declaration with the specified name could be moved into
9744 /// a different namespace.
9745 static bool canBeDeclaredInNamespace(const DeclarationName &Name) {
9746   switch (Name.getCXXOverloadedOperator()) {
9747   case OO_New: case OO_Array_New:
9748   case OO_Delete: case OO_Array_Delete:
9749     return false;
9750 
9751   default:
9752     return true;
9753   }
9754 }
9755 
9756 /// Attempt to recover from an ill-formed use of a non-dependent name in a
9757 /// template, where the non-dependent name was declared after the template
9758 /// was defined. This is common in code written for a compilers which do not
9759 /// correctly implement two-stage name lookup.
9760 ///
9761 /// Returns true if a viable candidate was found and a diagnostic was issued.
9762 static bool
9763 DiagnoseTwoPhaseLookup(Sema &SemaRef, SourceLocation FnLoc,
9764                        const CXXScopeSpec &SS, LookupResult &R,
9765                        TemplateArgumentListInfo *ExplicitTemplateArgs,
9766                        ArrayRef<Expr *> Args) {
9767   if (SemaRef.ActiveTemplateInstantiations.empty() || !SS.isEmpty())
9768     return false;
9769 
9770   for (DeclContext *DC = SemaRef.CurContext; DC; DC = DC->getParent()) {
9771     if (DC->isTransparentContext())
9772       continue;
9773 
9774     SemaRef.LookupQualifiedName(R, DC);
9775 
9776     if (!R.empty()) {
9777       R.suppressDiagnostics();
9778 
9779       if (isa<CXXRecordDecl>(DC)) {
9780         // Don't diagnose names we find in classes; we get much better
9781         // diagnostics for these from DiagnoseEmptyLookup.
9782         R.clear();
9783         return false;
9784       }
9785 
9786       OverloadCandidateSet Candidates(FnLoc);
9787       for (LookupResult::iterator I = R.begin(), E = R.end(); I != E; ++I)
9788         AddOverloadedCallCandidate(SemaRef, I.getPair(),
9789                                    ExplicitTemplateArgs, Args,
9790                                    Candidates, false, /*KnownValid*/ false);
9791 
9792       OverloadCandidateSet::iterator Best;
9793       if (Candidates.BestViableFunction(SemaRef, FnLoc, Best) != OR_Success) {
9794         // No viable functions. Don't bother the user with notes for functions
9795         // which don't work and shouldn't be found anyway.
9796         R.clear();
9797         return false;
9798       }
9799 
9800       // Find the namespaces where ADL would have looked, and suggest
9801       // declaring the function there instead.
9802       Sema::AssociatedNamespaceSet AssociatedNamespaces;
9803       Sema::AssociatedClassSet AssociatedClasses;
9804       SemaRef.FindAssociatedClassesAndNamespaces(FnLoc, Args,
9805                                                  AssociatedNamespaces,
9806                                                  AssociatedClasses);
9807       Sema::AssociatedNamespaceSet SuggestedNamespaces;
9808       if (canBeDeclaredInNamespace(R.getLookupName())) {
9809         DeclContext *Std = SemaRef.getStdNamespace();
9810         for (Sema::AssociatedNamespaceSet::iterator
9811                it = AssociatedNamespaces.begin(),
9812                end = AssociatedNamespaces.end(); it != end; ++it) {
9813           // Never suggest declaring a function within namespace 'std'.
9814           if (Std && Std->Encloses(*it))
9815             continue;
9816 
9817           // Never suggest declaring a function within a namespace with a
9818           // reserved name, like __gnu_cxx.
9819           NamespaceDecl *NS = dyn_cast<NamespaceDecl>(*it);
9820           if (NS &&
9821               NS->getQualifiedNameAsString().find("__") != std::string::npos)
9822             continue;
9823 
9824           SuggestedNamespaces.insert(*it);
9825         }
9826       }
9827 
9828       SemaRef.Diag(R.getNameLoc(), diag::err_not_found_by_two_phase_lookup)
9829         << R.getLookupName();
9830       if (SuggestedNamespaces.empty()) {
9831         SemaRef.Diag(Best->Function->getLocation(),
9832                      diag::note_not_found_by_two_phase_lookup)
9833           << R.getLookupName() << 0;
9834       } else if (SuggestedNamespaces.size() == 1) {
9835         SemaRef.Diag(Best->Function->getLocation(),
9836                      diag::note_not_found_by_two_phase_lookup)
9837           << R.getLookupName() << 1 << *SuggestedNamespaces.begin();
9838       } else {
9839         // FIXME: It would be useful to list the associated namespaces here,
9840         // but the diagnostics infrastructure doesn't provide a way to produce
9841         // a localized representation of a list of items.
9842         SemaRef.Diag(Best->Function->getLocation(),
9843                      diag::note_not_found_by_two_phase_lookup)
9844           << R.getLookupName() << 2;
9845       }
9846 
9847       // Try to recover by calling this function.
9848       return true;
9849     }
9850 
9851     R.clear();
9852   }
9853 
9854   return false;
9855 }
9856 
9857 /// Attempt to recover from ill-formed use of a non-dependent operator in a
9858 /// template, where the non-dependent operator was declared after the template
9859 /// was defined.
9860 ///
9861 /// Returns true if a viable candidate was found and a diagnostic was issued.
9862 static bool
9863 DiagnoseTwoPhaseOperatorLookup(Sema &SemaRef, OverloadedOperatorKind Op,
9864                                SourceLocation OpLoc,
9865                                ArrayRef<Expr *> Args) {
9866   DeclarationName OpName =
9867     SemaRef.Context.DeclarationNames.getCXXOperatorName(Op);
9868   LookupResult R(SemaRef, OpName, OpLoc, Sema::LookupOperatorName);
9869   return DiagnoseTwoPhaseLookup(SemaRef, OpLoc, CXXScopeSpec(), R,
9870                                 /*ExplicitTemplateArgs=*/0, Args);
9871 }
9872 
9873 namespace {
9874 // Callback to limit the allowed keywords and to only accept typo corrections
9875 // that are keywords or whose decls refer to functions (or template functions)
9876 // that accept the given number of arguments.
9877 class RecoveryCallCCC : public CorrectionCandidateCallback {
9878  public:
9879   RecoveryCallCCC(Sema &SemaRef, unsigned NumArgs, bool HasExplicitTemplateArgs)
9880       : NumArgs(NumArgs), HasExplicitTemplateArgs(HasExplicitTemplateArgs) {
9881     WantTypeSpecifiers = SemaRef.getLangOpts().CPlusPlus;
9882     WantRemainingKeywords = false;
9883   }
9884 
9885   virtual bool ValidateCandidate(const TypoCorrection &candidate) {
9886     if (!candidate.getCorrectionDecl())
9887       return candidate.isKeyword();
9888 
9889     for (TypoCorrection::const_decl_iterator DI = candidate.begin(),
9890            DIEnd = candidate.end(); DI != DIEnd; ++DI) {
9891       FunctionDecl *FD = 0;
9892       NamedDecl *ND = (*DI)->getUnderlyingDecl();
9893       if (FunctionTemplateDecl *FTD = dyn_cast<FunctionTemplateDecl>(ND))
9894         FD = FTD->getTemplatedDecl();
9895       if (!HasExplicitTemplateArgs && !FD) {
9896         if (!(FD = dyn_cast<FunctionDecl>(ND)) && isa<ValueDecl>(ND)) {
9897           // If the Decl is neither a function nor a template function,
9898           // determine if it is a pointer or reference to a function. If so,
9899           // check against the number of arguments expected for the pointee.
9900           QualType ValType = cast<ValueDecl>(ND)->getType();
9901           if (ValType->isAnyPointerType() || ValType->isReferenceType())
9902             ValType = ValType->getPointeeType();
9903           if (const FunctionProtoType *FPT = ValType->getAs<FunctionProtoType>())
9904             if (FPT->getNumArgs() == NumArgs)
9905               return true;
9906         }
9907       }
9908       if (FD && FD->getNumParams() >= NumArgs &&
9909           FD->getMinRequiredArguments() <= NumArgs)
9910         return true;
9911     }
9912     return false;
9913   }
9914 
9915  private:
9916   unsigned NumArgs;
9917   bool HasExplicitTemplateArgs;
9918 };
9919 
9920 // Callback that effectively disabled typo correction
9921 class NoTypoCorrectionCCC : public CorrectionCandidateCallback {
9922  public:
9923   NoTypoCorrectionCCC() {
9924     WantTypeSpecifiers = false;
9925     WantExpressionKeywords = false;
9926     WantCXXNamedCasts = false;
9927     WantRemainingKeywords = false;
9928   }
9929 
9930   virtual bool ValidateCandidate(const TypoCorrection &candidate) {
9931     return false;
9932   }
9933 };
9934 
9935 class BuildRecoveryCallExprRAII {
9936   Sema &SemaRef;
9937 public:
9938   BuildRecoveryCallExprRAII(Sema &S) : SemaRef(S) {
9939     assert(SemaRef.IsBuildingRecoveryCallExpr == false);
9940     SemaRef.IsBuildingRecoveryCallExpr = true;
9941   }
9942 
9943   ~BuildRecoveryCallExprRAII() {
9944     SemaRef.IsBuildingRecoveryCallExpr = false;
9945   }
9946 };
9947 
9948 }
9949 
9950 /// Attempts to recover from a call where no functions were found.
9951 ///
9952 /// Returns true if new candidates were found.
9953 static ExprResult
9954 BuildRecoveryCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
9955                       UnresolvedLookupExpr *ULE,
9956                       SourceLocation LParenLoc,
9957                       llvm::MutableArrayRef<Expr *> Args,
9958                       SourceLocation RParenLoc,
9959                       bool EmptyLookup, bool AllowTypoCorrection) {
9960   // Do not try to recover if it is already building a recovery call.
9961   // This stops infinite loops for template instantiations like
9962   //
9963   // template <typename T> auto foo(T t) -> decltype(foo(t)) {}
9964   // template <typename T> auto foo(T t) -> decltype(foo(&t)) {}
9965   //
9966   if (SemaRef.IsBuildingRecoveryCallExpr)
9967     return ExprError();
9968   BuildRecoveryCallExprRAII RCE(SemaRef);
9969 
9970   CXXScopeSpec SS;
9971   SS.Adopt(ULE->getQualifierLoc());
9972   SourceLocation TemplateKWLoc = ULE->getTemplateKeywordLoc();
9973 
9974   TemplateArgumentListInfo TABuffer;
9975   TemplateArgumentListInfo *ExplicitTemplateArgs = 0;
9976   if (ULE->hasExplicitTemplateArgs()) {
9977     ULE->copyTemplateArgumentsInto(TABuffer);
9978     ExplicitTemplateArgs = &TABuffer;
9979   }
9980 
9981   LookupResult R(SemaRef, ULE->getName(), ULE->getNameLoc(),
9982                  Sema::LookupOrdinaryName);
9983   RecoveryCallCCC Validator(SemaRef, Args.size(), ExplicitTemplateArgs != 0);
9984   NoTypoCorrectionCCC RejectAll;
9985   CorrectionCandidateCallback *CCC = AllowTypoCorrection ?
9986       (CorrectionCandidateCallback*)&Validator :
9987       (CorrectionCandidateCallback*)&RejectAll;
9988   if (!DiagnoseTwoPhaseLookup(SemaRef, Fn->getExprLoc(), SS, R,
9989                               ExplicitTemplateArgs, Args) &&
9990       (!EmptyLookup ||
9991        SemaRef.DiagnoseEmptyLookup(S, SS, R, *CCC,
9992                                    ExplicitTemplateArgs, Args)))
9993     return ExprError();
9994 
9995   assert(!R.empty() && "lookup results empty despite recovery");
9996 
9997   // Build an implicit member call if appropriate.  Just drop the
9998   // casts and such from the call, we don't really care.
9999   ExprResult NewFn = ExprError();
10000   if ((*R.begin())->isCXXClassMember())
10001     NewFn = SemaRef.BuildPossibleImplicitMemberExpr(SS, TemplateKWLoc,
10002                                                     R, ExplicitTemplateArgs);
10003   else if (ExplicitTemplateArgs || TemplateKWLoc.isValid())
10004     NewFn = SemaRef.BuildTemplateIdExpr(SS, TemplateKWLoc, R, false,
10005                                         ExplicitTemplateArgs);
10006   else
10007     NewFn = SemaRef.BuildDeclarationNameExpr(SS, R, false);
10008 
10009   if (NewFn.isInvalid())
10010     return ExprError();
10011 
10012   // This shouldn't cause an infinite loop because we're giving it
10013   // an expression with viable lookup results, which should never
10014   // end up here.
10015   return SemaRef.ActOnCallExpr(/*Scope*/ 0, NewFn.take(), LParenLoc,
10016                                MultiExprArg(Args.data(), Args.size()),
10017                                RParenLoc);
10018 }
10019 
10020 /// \brief Constructs and populates an OverloadedCandidateSet from
10021 /// the given function.
10022 /// \returns true when an the ExprResult output parameter has been set.
10023 bool Sema::buildOverloadedCallSet(Scope *S, Expr *Fn,
10024                                   UnresolvedLookupExpr *ULE,
10025                                   MultiExprArg Args,
10026                                   SourceLocation RParenLoc,
10027                                   OverloadCandidateSet *CandidateSet,
10028                                   ExprResult *Result) {
10029 #ifndef NDEBUG
10030   if (ULE->requiresADL()) {
10031     // To do ADL, we must have found an unqualified name.
10032     assert(!ULE->getQualifier() && "qualified name with ADL");
10033 
10034     // We don't perform ADL for implicit declarations of builtins.
10035     // Verify that this was correctly set up.
10036     FunctionDecl *F;
10037     if (ULE->decls_begin() + 1 == ULE->decls_end() &&
10038         (F = dyn_cast<FunctionDecl>(*ULE->decls_begin())) &&
10039         F->getBuiltinID() && F->isImplicit())
10040       llvm_unreachable("performing ADL for builtin");
10041 
10042     // We don't perform ADL in C.
10043     assert(getLangOpts().CPlusPlus && "ADL enabled in C");
10044   }
10045 #endif
10046 
10047   UnbridgedCastsSet UnbridgedCasts;
10048   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts)) {
10049     *Result = ExprError();
10050     return true;
10051   }
10052 
10053   // Add the functions denoted by the callee to the set of candidate
10054   // functions, including those from argument-dependent lookup.
10055   AddOverloadedCallCandidates(ULE, Args, *CandidateSet);
10056 
10057   // If we found nothing, try to recover.
10058   // BuildRecoveryCallExpr diagnoses the error itself, so we just bail
10059   // out if it fails.
10060   if (CandidateSet->empty()) {
10061     // In Microsoft mode, if we are inside a template class member function then
10062     // create a type dependent CallExpr. The goal is to postpone name lookup
10063     // to instantiation time to be able to search into type dependent base
10064     // classes.
10065     if (getLangOpts().MicrosoftMode && CurContext->isDependentContext() &&
10066         (isa<FunctionDecl>(CurContext) || isa<CXXRecordDecl>(CurContext))) {
10067       CallExpr *CE = new (Context) CallExpr(Context, Fn, Args,
10068                                             Context.DependentTy, VK_RValue,
10069                                             RParenLoc);
10070       CE->setTypeDependent(true);
10071       *Result = Owned(CE);
10072       return true;
10073     }
10074     return false;
10075   }
10076 
10077   UnbridgedCasts.restore();
10078   return false;
10079 }
10080 
10081 /// FinishOverloadedCallExpr - given an OverloadCandidateSet, builds and returns
10082 /// the completed call expression. If overload resolution fails, emits
10083 /// diagnostics and returns ExprError()
10084 static ExprResult FinishOverloadedCallExpr(Sema &SemaRef, Scope *S, Expr *Fn,
10085                                            UnresolvedLookupExpr *ULE,
10086                                            SourceLocation LParenLoc,
10087                                            MultiExprArg Args,
10088                                            SourceLocation RParenLoc,
10089                                            Expr *ExecConfig,
10090                                            OverloadCandidateSet *CandidateSet,
10091                                            OverloadCandidateSet::iterator *Best,
10092                                            OverloadingResult OverloadResult,
10093                                            bool AllowTypoCorrection) {
10094   if (CandidateSet->empty())
10095     return BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc, Args,
10096                                  RParenLoc, /*EmptyLookup=*/true,
10097                                  AllowTypoCorrection);
10098 
10099   switch (OverloadResult) {
10100   case OR_Success: {
10101     FunctionDecl *FDecl = (*Best)->Function;
10102     SemaRef.CheckUnresolvedLookupAccess(ULE, (*Best)->FoundDecl);
10103     if (SemaRef.DiagnoseUseOfDecl(FDecl, ULE->getNameLoc()))
10104       return ExprError();
10105     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
10106     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
10107                                          ExecConfig);
10108   }
10109 
10110   case OR_No_Viable_Function: {
10111     // Try to recover by looking for viable functions which the user might
10112     // have meant to call.
10113     ExprResult Recovery = BuildRecoveryCallExpr(SemaRef, S, Fn, ULE, LParenLoc,
10114                                                 Args, RParenLoc,
10115                                                 /*EmptyLookup=*/false,
10116                                                 AllowTypoCorrection);
10117     if (!Recovery.isInvalid())
10118       return Recovery;
10119 
10120     SemaRef.Diag(Fn->getLocStart(),
10121          diag::err_ovl_no_viable_function_in_call)
10122       << ULE->getName() << Fn->getSourceRange();
10123     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
10124     break;
10125   }
10126 
10127   case OR_Ambiguous:
10128     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_ambiguous_call)
10129       << ULE->getName() << Fn->getSourceRange();
10130     CandidateSet->NoteCandidates(SemaRef, OCD_ViableCandidates, Args);
10131     break;
10132 
10133   case OR_Deleted: {
10134     SemaRef.Diag(Fn->getLocStart(), diag::err_ovl_deleted_call)
10135       << (*Best)->Function->isDeleted()
10136       << ULE->getName()
10137       << SemaRef.getDeletedOrUnavailableSuffix((*Best)->Function)
10138       << Fn->getSourceRange();
10139     CandidateSet->NoteCandidates(SemaRef, OCD_AllCandidates, Args);
10140 
10141     // We emitted an error for the unvailable/deleted function call but keep
10142     // the call in the AST.
10143     FunctionDecl *FDecl = (*Best)->Function;
10144     Fn = SemaRef.FixOverloadedFunctionReference(Fn, (*Best)->FoundDecl, FDecl);
10145     return SemaRef.BuildResolvedCallExpr(Fn, FDecl, LParenLoc, Args, RParenLoc,
10146                                          ExecConfig);
10147   }
10148   }
10149 
10150   // Overload resolution failed.
10151   return ExprError();
10152 }
10153 
10154 /// BuildOverloadedCallExpr - Given the call expression that calls Fn
10155 /// (which eventually refers to the declaration Func) and the call
10156 /// arguments Args/NumArgs, attempt to resolve the function call down
10157 /// to a specific function. If overload resolution succeeds, returns
10158 /// the call expression produced by overload resolution.
10159 /// Otherwise, emits diagnostics and returns ExprError.
10160 ExprResult Sema::BuildOverloadedCallExpr(Scope *S, Expr *Fn,
10161                                          UnresolvedLookupExpr *ULE,
10162                                          SourceLocation LParenLoc,
10163                                          MultiExprArg Args,
10164                                          SourceLocation RParenLoc,
10165                                          Expr *ExecConfig,
10166                                          bool AllowTypoCorrection) {
10167   OverloadCandidateSet CandidateSet(Fn->getExprLoc());
10168   ExprResult result;
10169 
10170   if (buildOverloadedCallSet(S, Fn, ULE, Args, LParenLoc, &CandidateSet,
10171                              &result))
10172     return result;
10173 
10174   OverloadCandidateSet::iterator Best;
10175   OverloadingResult OverloadResult =
10176       CandidateSet.BestViableFunction(*this, Fn->getLocStart(), Best);
10177 
10178   return FinishOverloadedCallExpr(*this, S, Fn, ULE, LParenLoc, Args,
10179                                   RParenLoc, ExecConfig, &CandidateSet,
10180                                   &Best, OverloadResult,
10181                                   AllowTypoCorrection);
10182 }
10183 
10184 static bool IsOverloaded(const UnresolvedSetImpl &Functions) {
10185   return Functions.size() > 1 ||
10186     (Functions.size() == 1 && isa<FunctionTemplateDecl>(*Functions.begin()));
10187 }
10188 
10189 /// \brief Create a unary operation that may resolve to an overloaded
10190 /// operator.
10191 ///
10192 /// \param OpLoc The location of the operator itself (e.g., '*').
10193 ///
10194 /// \param OpcIn The UnaryOperator::Opcode that describes this
10195 /// operator.
10196 ///
10197 /// \param Fns The set of non-member functions that will be
10198 /// considered by overload resolution. The caller needs to build this
10199 /// set based on the context using, e.g.,
10200 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
10201 /// set should not contain any member functions; those will be added
10202 /// by CreateOverloadedUnaryOp().
10203 ///
10204 /// \param Input The input argument.
10205 ExprResult
10206 Sema::CreateOverloadedUnaryOp(SourceLocation OpLoc, unsigned OpcIn,
10207                               const UnresolvedSetImpl &Fns,
10208                               Expr *Input) {
10209   UnaryOperator::Opcode Opc = static_cast<UnaryOperator::Opcode>(OpcIn);
10210 
10211   OverloadedOperatorKind Op = UnaryOperator::getOverloadedOperator(Opc);
10212   assert(Op != OO_None && "Invalid opcode for overloaded unary operator");
10213   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
10214   // TODO: provide better source location info.
10215   DeclarationNameInfo OpNameInfo(OpName, OpLoc);
10216 
10217   if (checkPlaceholderForOverload(*this, Input))
10218     return ExprError();
10219 
10220   Expr *Args[2] = { Input, 0 };
10221   unsigned NumArgs = 1;
10222 
10223   // For post-increment and post-decrement, add the implicit '0' as
10224   // the second argument, so that we know this is a post-increment or
10225   // post-decrement.
10226   if (Opc == UO_PostInc || Opc == UO_PostDec) {
10227     llvm::APSInt Zero(Context.getTypeSize(Context.IntTy), false);
10228     Args[1] = IntegerLiteral::Create(Context, Zero, Context.IntTy,
10229                                      SourceLocation());
10230     NumArgs = 2;
10231   }
10232 
10233   ArrayRef<Expr *> ArgsArray(Args, NumArgs);
10234 
10235   if (Input->isTypeDependent()) {
10236     if (Fns.empty())
10237       return Owned(new (Context) UnaryOperator(Input,
10238                                                Opc,
10239                                                Context.DependentTy,
10240                                                VK_RValue, OK_Ordinary,
10241                                                OpLoc));
10242 
10243     CXXRecordDecl *NamingClass = 0; // because lookup ignores member operators
10244     UnresolvedLookupExpr *Fn
10245       = UnresolvedLookupExpr::Create(Context, NamingClass,
10246                                      NestedNameSpecifierLoc(), OpNameInfo,
10247                                      /*ADL*/ true, IsOverloaded(Fns),
10248                                      Fns.begin(), Fns.end());
10249     return Owned(new (Context) CXXOperatorCallExpr(Context, Op, Fn, ArgsArray,
10250                                                    Context.DependentTy,
10251                                                    VK_RValue,
10252                                                    OpLoc, false));
10253   }
10254 
10255   // Build an empty overload set.
10256   OverloadCandidateSet CandidateSet(OpLoc);
10257 
10258   // Add the candidates from the given function set.
10259   AddFunctionCandidates(Fns, ArgsArray, CandidateSet, false);
10260 
10261   // Add operator candidates that are member functions.
10262   AddMemberOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
10263 
10264   // Add candidates from ADL.
10265   AddArgumentDependentLookupCandidates(OpName, /*Operator*/ true, OpLoc,
10266                                        ArgsArray, /*ExplicitTemplateArgs*/ 0,
10267                                        CandidateSet);
10268 
10269   // Add builtin operator candidates.
10270   AddBuiltinOperatorCandidates(Op, OpLoc, ArgsArray, CandidateSet);
10271 
10272   bool HadMultipleCandidates = (CandidateSet.size() > 1);
10273 
10274   // Perform overload resolution.
10275   OverloadCandidateSet::iterator Best;
10276   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
10277   case OR_Success: {
10278     // We found a built-in operator or an overloaded operator.
10279     FunctionDecl *FnDecl = Best->Function;
10280 
10281     if (FnDecl) {
10282       // We matched an overloaded operator. Build a call to that
10283       // operator.
10284 
10285       // Convert the arguments.
10286       if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
10287         CheckMemberOperatorAccess(OpLoc, Args[0], 0, Best->FoundDecl);
10288 
10289         ExprResult InputRes =
10290           PerformObjectArgumentInitialization(Input, /*Qualifier=*/0,
10291                                               Best->FoundDecl, Method);
10292         if (InputRes.isInvalid())
10293           return ExprError();
10294         Input = InputRes.take();
10295       } else {
10296         // Convert the arguments.
10297         ExprResult InputInit
10298           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
10299                                                       Context,
10300                                                       FnDecl->getParamDecl(0)),
10301                                       SourceLocation(),
10302                                       Input);
10303         if (InputInit.isInvalid())
10304           return ExprError();
10305         Input = InputInit.take();
10306       }
10307 
10308       // Determine the result type.
10309       QualType ResultTy = FnDecl->getResultType();
10310       ExprValueKind VK = Expr::getValueKindForType(ResultTy);
10311       ResultTy = ResultTy.getNonLValueExprType(Context);
10312 
10313       // Build the actual expression node.
10314       ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl, Best->FoundDecl,
10315                                                 HadMultipleCandidates, OpLoc);
10316       if (FnExpr.isInvalid())
10317         return ExprError();
10318 
10319       Args[0] = Input;
10320       CallExpr *TheCall =
10321         new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.take(), ArgsArray,
10322                                           ResultTy, VK, OpLoc, false);
10323 
10324       if (CheckCallReturnType(FnDecl->getResultType(), OpLoc, TheCall,
10325                               FnDecl))
10326         return ExprError();
10327 
10328       return MaybeBindToTemporary(TheCall);
10329     } else {
10330       // We matched a built-in operator. Convert the arguments, then
10331       // break out so that we will build the appropriate built-in
10332       // operator node.
10333       ExprResult InputRes =
10334         PerformImplicitConversion(Input, Best->BuiltinTypes.ParamTypes[0],
10335                                   Best->Conversions[0], AA_Passing);
10336       if (InputRes.isInvalid())
10337         return ExprError();
10338       Input = InputRes.take();
10339       break;
10340     }
10341   }
10342 
10343   case OR_No_Viable_Function:
10344     // This is an erroneous use of an operator which can be overloaded by
10345     // a non-member function. Check for non-member operators which were
10346     // defined too late to be candidates.
10347     if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, ArgsArray))
10348       // FIXME: Recover by calling the found function.
10349       return ExprError();
10350 
10351     // No viable function; fall through to handling this as a
10352     // built-in operator, which will produce an error message for us.
10353     break;
10354 
10355   case OR_Ambiguous:
10356     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
10357         << UnaryOperator::getOpcodeStr(Opc)
10358         << Input->getType()
10359         << Input->getSourceRange();
10360     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, ArgsArray,
10361                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
10362     return ExprError();
10363 
10364   case OR_Deleted:
10365     Diag(OpLoc, diag::err_ovl_deleted_oper)
10366       << Best->Function->isDeleted()
10367       << UnaryOperator::getOpcodeStr(Opc)
10368       << getDeletedOrUnavailableSuffix(Best->Function)
10369       << Input->getSourceRange();
10370     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, ArgsArray,
10371                                 UnaryOperator::getOpcodeStr(Opc), OpLoc);
10372     return ExprError();
10373   }
10374 
10375   // Either we found no viable overloaded operator or we matched a
10376   // built-in operator. In either case, fall through to trying to
10377   // build a built-in operation.
10378   return CreateBuiltinUnaryOp(OpLoc, Opc, Input);
10379 }
10380 
10381 /// \brief Create a binary operation that may resolve to an overloaded
10382 /// operator.
10383 ///
10384 /// \param OpLoc The location of the operator itself (e.g., '+').
10385 ///
10386 /// \param OpcIn The BinaryOperator::Opcode that describes this
10387 /// operator.
10388 ///
10389 /// \param Fns The set of non-member functions that will be
10390 /// considered by overload resolution. The caller needs to build this
10391 /// set based on the context using, e.g.,
10392 /// LookupOverloadedOperatorName() and ArgumentDependentLookup(). This
10393 /// set should not contain any member functions; those will be added
10394 /// by CreateOverloadedBinOp().
10395 ///
10396 /// \param LHS Left-hand argument.
10397 /// \param RHS Right-hand argument.
10398 ExprResult
10399 Sema::CreateOverloadedBinOp(SourceLocation OpLoc,
10400                             unsigned OpcIn,
10401                             const UnresolvedSetImpl &Fns,
10402                             Expr *LHS, Expr *RHS) {
10403   Expr *Args[2] = { LHS, RHS };
10404   LHS=RHS=0; //Please use only Args instead of LHS/RHS couple
10405 
10406   BinaryOperator::Opcode Opc = static_cast<BinaryOperator::Opcode>(OpcIn);
10407   OverloadedOperatorKind Op = BinaryOperator::getOverloadedOperator(Opc);
10408   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(Op);
10409 
10410   // If either side is type-dependent, create an appropriate dependent
10411   // expression.
10412   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
10413     if (Fns.empty()) {
10414       // If there are no functions to store, just build a dependent
10415       // BinaryOperator or CompoundAssignment.
10416       if (Opc <= BO_Assign || Opc > BO_OrAssign)
10417         return Owned(new (Context) BinaryOperator(Args[0], Args[1], Opc,
10418                                                   Context.DependentTy,
10419                                                   VK_RValue, OK_Ordinary,
10420                                                   OpLoc,
10421                                                   FPFeatures.fp_contract));
10422 
10423       return Owned(new (Context) CompoundAssignOperator(Args[0], Args[1], Opc,
10424                                                         Context.DependentTy,
10425                                                         VK_LValue,
10426                                                         OK_Ordinary,
10427                                                         Context.DependentTy,
10428                                                         Context.DependentTy,
10429                                                         OpLoc,
10430                                                         FPFeatures.fp_contract));
10431     }
10432 
10433     // FIXME: save results of ADL from here?
10434     CXXRecordDecl *NamingClass = 0; // because lookup ignores member operators
10435     // TODO: provide better source location info in DNLoc component.
10436     DeclarationNameInfo OpNameInfo(OpName, OpLoc);
10437     UnresolvedLookupExpr *Fn
10438       = UnresolvedLookupExpr::Create(Context, NamingClass,
10439                                      NestedNameSpecifierLoc(), OpNameInfo,
10440                                      /*ADL*/ true, IsOverloaded(Fns),
10441                                      Fns.begin(), Fns.end());
10442     return Owned(new (Context) CXXOperatorCallExpr(Context, Op, Fn, Args,
10443                                                 Context.DependentTy, VK_RValue,
10444                                                 OpLoc, FPFeatures.fp_contract));
10445   }
10446 
10447   // Always do placeholder-like conversions on the RHS.
10448   if (checkPlaceholderForOverload(*this, Args[1]))
10449     return ExprError();
10450 
10451   // Do placeholder-like conversion on the LHS; note that we should
10452   // not get here with a PseudoObject LHS.
10453   assert(Args[0]->getObjectKind() != OK_ObjCProperty);
10454   if (checkPlaceholderForOverload(*this, Args[0]))
10455     return ExprError();
10456 
10457   // If this is the assignment operator, we only perform overload resolution
10458   // if the left-hand side is a class or enumeration type. This is actually
10459   // a hack. The standard requires that we do overload resolution between the
10460   // various built-in candidates, but as DR507 points out, this can lead to
10461   // problems. So we do it this way, which pretty much follows what GCC does.
10462   // Note that we go the traditional code path for compound assignment forms.
10463   if (Opc == BO_Assign && !Args[0]->getType()->isOverloadableType())
10464     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
10465 
10466   // If this is the .* operator, which is not overloadable, just
10467   // create a built-in binary operator.
10468   if (Opc == BO_PtrMemD)
10469     return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
10470 
10471   // Build an empty overload set.
10472   OverloadCandidateSet CandidateSet(OpLoc);
10473 
10474   // Add the candidates from the given function set.
10475   AddFunctionCandidates(Fns, Args, CandidateSet, false);
10476 
10477   // Add operator candidates that are member functions.
10478   AddMemberOperatorCandidates(Op, OpLoc, Args, CandidateSet);
10479 
10480   // Add candidates from ADL.
10481   AddArgumentDependentLookupCandidates(OpName, /*Operator*/ true,
10482                                        OpLoc, Args,
10483                                        /*ExplicitTemplateArgs*/ 0,
10484                                        CandidateSet);
10485 
10486   // Add builtin operator candidates.
10487   AddBuiltinOperatorCandidates(Op, OpLoc, Args, CandidateSet);
10488 
10489   bool HadMultipleCandidates = (CandidateSet.size() > 1);
10490 
10491   // Perform overload resolution.
10492   OverloadCandidateSet::iterator Best;
10493   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
10494     case OR_Success: {
10495       // We found a built-in operator or an overloaded operator.
10496       FunctionDecl *FnDecl = Best->Function;
10497 
10498       if (FnDecl) {
10499         // We matched an overloaded operator. Build a call to that
10500         // operator.
10501 
10502         // Convert the arguments.
10503         if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(FnDecl)) {
10504           // Best->Access is only meaningful for class members.
10505           CheckMemberOperatorAccess(OpLoc, Args[0], Args[1], Best->FoundDecl);
10506 
10507           ExprResult Arg1 =
10508             PerformCopyInitialization(
10509               InitializedEntity::InitializeParameter(Context,
10510                                                      FnDecl->getParamDecl(0)),
10511               SourceLocation(), Owned(Args[1]));
10512           if (Arg1.isInvalid())
10513             return ExprError();
10514 
10515           ExprResult Arg0 =
10516             PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/0,
10517                                                 Best->FoundDecl, Method);
10518           if (Arg0.isInvalid())
10519             return ExprError();
10520           Args[0] = Arg0.takeAs<Expr>();
10521           Args[1] = RHS = Arg1.takeAs<Expr>();
10522         } else {
10523           // Convert the arguments.
10524           ExprResult Arg0 = PerformCopyInitialization(
10525             InitializedEntity::InitializeParameter(Context,
10526                                                    FnDecl->getParamDecl(0)),
10527             SourceLocation(), Owned(Args[0]));
10528           if (Arg0.isInvalid())
10529             return ExprError();
10530 
10531           ExprResult Arg1 =
10532             PerformCopyInitialization(
10533               InitializedEntity::InitializeParameter(Context,
10534                                                      FnDecl->getParamDecl(1)),
10535               SourceLocation(), Owned(Args[1]));
10536           if (Arg1.isInvalid())
10537             return ExprError();
10538           Args[0] = LHS = Arg0.takeAs<Expr>();
10539           Args[1] = RHS = Arg1.takeAs<Expr>();
10540         }
10541 
10542         // Determine the result type.
10543         QualType ResultTy = FnDecl->getResultType();
10544         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
10545         ResultTy = ResultTy.getNonLValueExprType(Context);
10546 
10547         // Build the actual expression node.
10548         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
10549                                                   Best->FoundDecl,
10550                                                   HadMultipleCandidates, OpLoc);
10551         if (FnExpr.isInvalid())
10552           return ExprError();
10553 
10554         CXXOperatorCallExpr *TheCall =
10555           new (Context) CXXOperatorCallExpr(Context, Op, FnExpr.take(),
10556                                             Args, ResultTy, VK, OpLoc,
10557                                             FPFeatures.fp_contract);
10558 
10559         if (CheckCallReturnType(FnDecl->getResultType(), OpLoc, TheCall,
10560                                 FnDecl))
10561           return ExprError();
10562 
10563         ArrayRef<const Expr *> ArgsArray(Args, 2);
10564         // Cut off the implicit 'this'.
10565         if (isa<CXXMethodDecl>(FnDecl))
10566           ArgsArray = ArgsArray.slice(1);
10567         checkCall(FnDecl, ArgsArray, 0, isa<CXXMethodDecl>(FnDecl), OpLoc,
10568                   TheCall->getSourceRange(), VariadicDoesNotApply);
10569 
10570         return MaybeBindToTemporary(TheCall);
10571       } else {
10572         // We matched a built-in operator. Convert the arguments, then
10573         // break out so that we will build the appropriate built-in
10574         // operator node.
10575         ExprResult ArgsRes0 =
10576           PerformImplicitConversion(Args[0], Best->BuiltinTypes.ParamTypes[0],
10577                                     Best->Conversions[0], AA_Passing);
10578         if (ArgsRes0.isInvalid())
10579           return ExprError();
10580         Args[0] = ArgsRes0.take();
10581 
10582         ExprResult ArgsRes1 =
10583           PerformImplicitConversion(Args[1], Best->BuiltinTypes.ParamTypes[1],
10584                                     Best->Conversions[1], AA_Passing);
10585         if (ArgsRes1.isInvalid())
10586           return ExprError();
10587         Args[1] = ArgsRes1.take();
10588         break;
10589       }
10590     }
10591 
10592     case OR_No_Viable_Function: {
10593       // C++ [over.match.oper]p9:
10594       //   If the operator is the operator , [...] and there are no
10595       //   viable functions, then the operator is assumed to be the
10596       //   built-in operator and interpreted according to clause 5.
10597       if (Opc == BO_Comma)
10598         break;
10599 
10600       // For class as left operand for assignment or compound assigment
10601       // operator do not fall through to handling in built-in, but report that
10602       // no overloaded assignment operator found
10603       ExprResult Result = ExprError();
10604       if (Args[0]->getType()->isRecordType() &&
10605           Opc >= BO_Assign && Opc <= BO_OrAssign) {
10606         Diag(OpLoc,  diag::err_ovl_no_viable_oper)
10607              << BinaryOperator::getOpcodeStr(Opc)
10608              << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10609       } else {
10610         // This is an erroneous use of an operator which can be overloaded by
10611         // a non-member function. Check for non-member operators which were
10612         // defined too late to be candidates.
10613         if (DiagnoseTwoPhaseOperatorLookup(*this, Op, OpLoc, Args))
10614           // FIXME: Recover by calling the found function.
10615           return ExprError();
10616 
10617         // No viable function; try to create a built-in operation, which will
10618         // produce an error. Then, show the non-viable candidates.
10619         Result = CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
10620       }
10621       assert(Result.isInvalid() &&
10622              "C++ binary operator overloading is missing candidates!");
10623       if (Result.isInvalid())
10624         CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
10625                                     BinaryOperator::getOpcodeStr(Opc), OpLoc);
10626       return Result;
10627     }
10628 
10629     case OR_Ambiguous:
10630       Diag(OpLoc,  diag::err_ovl_ambiguous_oper_binary)
10631           << BinaryOperator::getOpcodeStr(Opc)
10632           << Args[0]->getType() << Args[1]->getType()
10633           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10634       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
10635                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
10636       return ExprError();
10637 
10638     case OR_Deleted:
10639       if (isImplicitlyDeleted(Best->Function)) {
10640         CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
10641         Diag(OpLoc, diag::err_ovl_deleted_special_oper)
10642           << Context.getRecordType(Method->getParent())
10643           << getSpecialMember(Method);
10644 
10645         // The user probably meant to call this special member. Just
10646         // explain why it's deleted.
10647         NoteDeletedFunction(Method);
10648         return ExprError();
10649       } else {
10650         Diag(OpLoc, diag::err_ovl_deleted_oper)
10651           << Best->Function->isDeleted()
10652           << BinaryOperator::getOpcodeStr(Opc)
10653           << getDeletedOrUnavailableSuffix(Best->Function)
10654           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10655       }
10656       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
10657                                   BinaryOperator::getOpcodeStr(Opc), OpLoc);
10658       return ExprError();
10659   }
10660 
10661   // We matched a built-in operator; build it.
10662   return CreateBuiltinBinOp(OpLoc, Opc, Args[0], Args[1]);
10663 }
10664 
10665 ExprResult
10666 Sema::CreateOverloadedArraySubscriptExpr(SourceLocation LLoc,
10667                                          SourceLocation RLoc,
10668                                          Expr *Base, Expr *Idx) {
10669   Expr *Args[2] = { Base, Idx };
10670   DeclarationName OpName =
10671       Context.DeclarationNames.getCXXOperatorName(OO_Subscript);
10672 
10673   // If either side is type-dependent, create an appropriate dependent
10674   // expression.
10675   if (Args[0]->isTypeDependent() || Args[1]->isTypeDependent()) {
10676 
10677     CXXRecordDecl *NamingClass = 0; // because lookup ignores member operators
10678     // CHECKME: no 'operator' keyword?
10679     DeclarationNameInfo OpNameInfo(OpName, LLoc);
10680     OpNameInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
10681     UnresolvedLookupExpr *Fn
10682       = UnresolvedLookupExpr::Create(Context, NamingClass,
10683                                      NestedNameSpecifierLoc(), OpNameInfo,
10684                                      /*ADL*/ true, /*Overloaded*/ false,
10685                                      UnresolvedSetIterator(),
10686                                      UnresolvedSetIterator());
10687     // Can't add any actual overloads yet
10688 
10689     return Owned(new (Context) CXXOperatorCallExpr(Context, OO_Subscript, Fn,
10690                                                    Args,
10691                                                    Context.DependentTy,
10692                                                    VK_RValue,
10693                                                    RLoc, false));
10694   }
10695 
10696   // Handle placeholders on both operands.
10697   if (checkPlaceholderForOverload(*this, Args[0]))
10698     return ExprError();
10699   if (checkPlaceholderForOverload(*this, Args[1]))
10700     return ExprError();
10701 
10702   // Build an empty overload set.
10703   OverloadCandidateSet CandidateSet(LLoc);
10704 
10705   // Subscript can only be overloaded as a member function.
10706 
10707   // Add operator candidates that are member functions.
10708   AddMemberOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
10709 
10710   // Add builtin operator candidates.
10711   AddBuiltinOperatorCandidates(OO_Subscript, LLoc, Args, CandidateSet);
10712 
10713   bool HadMultipleCandidates = (CandidateSet.size() > 1);
10714 
10715   // Perform overload resolution.
10716   OverloadCandidateSet::iterator Best;
10717   switch (CandidateSet.BestViableFunction(*this, LLoc, Best)) {
10718     case OR_Success: {
10719       // We found a built-in operator or an overloaded operator.
10720       FunctionDecl *FnDecl = Best->Function;
10721 
10722       if (FnDecl) {
10723         // We matched an overloaded operator. Build a call to that
10724         // operator.
10725 
10726         CheckMemberOperatorAccess(LLoc, Args[0], Args[1], Best->FoundDecl);
10727 
10728         // Convert the arguments.
10729         CXXMethodDecl *Method = cast<CXXMethodDecl>(FnDecl);
10730         ExprResult Arg0 =
10731           PerformObjectArgumentInitialization(Args[0], /*Qualifier=*/0,
10732                                               Best->FoundDecl, Method);
10733         if (Arg0.isInvalid())
10734           return ExprError();
10735         Args[0] = Arg0.take();
10736 
10737         // Convert the arguments.
10738         ExprResult InputInit
10739           = PerformCopyInitialization(InitializedEntity::InitializeParameter(
10740                                                       Context,
10741                                                       FnDecl->getParamDecl(0)),
10742                                       SourceLocation(),
10743                                       Owned(Args[1]));
10744         if (InputInit.isInvalid())
10745           return ExprError();
10746 
10747         Args[1] = InputInit.takeAs<Expr>();
10748 
10749         // Determine the result type
10750         QualType ResultTy = FnDecl->getResultType();
10751         ExprValueKind VK = Expr::getValueKindForType(ResultTy);
10752         ResultTy = ResultTy.getNonLValueExprType(Context);
10753 
10754         // Build the actual expression node.
10755         DeclarationNameInfo OpLocInfo(OpName, LLoc);
10756         OpLocInfo.setCXXOperatorNameRange(SourceRange(LLoc, RLoc));
10757         ExprResult FnExpr = CreateFunctionRefExpr(*this, FnDecl,
10758                                                   Best->FoundDecl,
10759                                                   HadMultipleCandidates,
10760                                                   OpLocInfo.getLoc(),
10761                                                   OpLocInfo.getInfo());
10762         if (FnExpr.isInvalid())
10763           return ExprError();
10764 
10765         CXXOperatorCallExpr *TheCall =
10766           new (Context) CXXOperatorCallExpr(Context, OO_Subscript,
10767                                             FnExpr.take(), Args,
10768                                             ResultTy, VK, RLoc,
10769                                             false);
10770 
10771         if (CheckCallReturnType(FnDecl->getResultType(), LLoc, TheCall,
10772                                 FnDecl))
10773           return ExprError();
10774 
10775         return MaybeBindToTemporary(TheCall);
10776       } else {
10777         // We matched a built-in operator. Convert the arguments, then
10778         // break out so that we will build the appropriate built-in
10779         // operator node.
10780         ExprResult ArgsRes0 =
10781           PerformImplicitConversion(Args[0], Best->BuiltinTypes.ParamTypes[0],
10782                                     Best->Conversions[0], AA_Passing);
10783         if (ArgsRes0.isInvalid())
10784           return ExprError();
10785         Args[0] = ArgsRes0.take();
10786 
10787         ExprResult ArgsRes1 =
10788           PerformImplicitConversion(Args[1], Best->BuiltinTypes.ParamTypes[1],
10789                                     Best->Conversions[1], AA_Passing);
10790         if (ArgsRes1.isInvalid())
10791           return ExprError();
10792         Args[1] = ArgsRes1.take();
10793 
10794         break;
10795       }
10796     }
10797 
10798     case OR_No_Viable_Function: {
10799       if (CandidateSet.empty())
10800         Diag(LLoc, diag::err_ovl_no_oper)
10801           << Args[0]->getType() << /*subscript*/ 0
10802           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10803       else
10804         Diag(LLoc, diag::err_ovl_no_viable_subscript)
10805           << Args[0]->getType()
10806           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10807       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
10808                                   "[]", LLoc);
10809       return ExprError();
10810     }
10811 
10812     case OR_Ambiguous:
10813       Diag(LLoc,  diag::err_ovl_ambiguous_oper_binary)
10814           << "[]"
10815           << Args[0]->getType() << Args[1]->getType()
10816           << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10817       CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args,
10818                                   "[]", LLoc);
10819       return ExprError();
10820 
10821     case OR_Deleted:
10822       Diag(LLoc, diag::err_ovl_deleted_oper)
10823         << Best->Function->isDeleted() << "[]"
10824         << getDeletedOrUnavailableSuffix(Best->Function)
10825         << Args[0]->getSourceRange() << Args[1]->getSourceRange();
10826       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args,
10827                                   "[]", LLoc);
10828       return ExprError();
10829     }
10830 
10831   // We matched a built-in operator; build it.
10832   return CreateBuiltinArraySubscriptExpr(Args[0], LLoc, Args[1], RLoc);
10833 }
10834 
10835 /// BuildCallToMemberFunction - Build a call to a member
10836 /// function. MemExpr is the expression that refers to the member
10837 /// function (and includes the object parameter), Args/NumArgs are the
10838 /// arguments to the function call (not including the object
10839 /// parameter). The caller needs to validate that the member
10840 /// expression refers to a non-static member function or an overloaded
10841 /// member function.
10842 ExprResult
10843 Sema::BuildCallToMemberFunction(Scope *S, Expr *MemExprE,
10844                                 SourceLocation LParenLoc,
10845                                 MultiExprArg Args,
10846                                 SourceLocation RParenLoc) {
10847   assert(MemExprE->getType() == Context.BoundMemberTy ||
10848          MemExprE->getType() == Context.OverloadTy);
10849 
10850   // Dig out the member expression. This holds both the object
10851   // argument and the member function we're referring to.
10852   Expr *NakedMemExpr = MemExprE->IgnoreParens();
10853 
10854   // Determine whether this is a call to a pointer-to-member function.
10855   if (BinaryOperator *op = dyn_cast<BinaryOperator>(NakedMemExpr)) {
10856     assert(op->getType() == Context.BoundMemberTy);
10857     assert(op->getOpcode() == BO_PtrMemD || op->getOpcode() == BO_PtrMemI);
10858 
10859     QualType fnType =
10860       op->getRHS()->getType()->castAs<MemberPointerType>()->getPointeeType();
10861 
10862     const FunctionProtoType *proto = fnType->castAs<FunctionProtoType>();
10863     QualType resultType = proto->getCallResultType(Context);
10864     ExprValueKind valueKind = Expr::getValueKindForType(proto->getResultType());
10865 
10866     // Check that the object type isn't more qualified than the
10867     // member function we're calling.
10868     Qualifiers funcQuals = Qualifiers::fromCVRMask(proto->getTypeQuals());
10869 
10870     QualType objectType = op->getLHS()->getType();
10871     if (op->getOpcode() == BO_PtrMemI)
10872       objectType = objectType->castAs<PointerType>()->getPointeeType();
10873     Qualifiers objectQuals = objectType.getQualifiers();
10874 
10875     Qualifiers difference = objectQuals - funcQuals;
10876     difference.removeObjCGCAttr();
10877     difference.removeAddressSpace();
10878     if (difference) {
10879       std::string qualsString = difference.getAsString();
10880       Diag(LParenLoc, diag::err_pointer_to_member_call_drops_quals)
10881         << fnType.getUnqualifiedType()
10882         << qualsString
10883         << (qualsString.find(' ') == std::string::npos ? 1 : 2);
10884     }
10885 
10886     CXXMemberCallExpr *call
10887       = new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
10888                                         resultType, valueKind, RParenLoc);
10889 
10890     if (CheckCallReturnType(proto->getResultType(),
10891                             op->getRHS()->getLocStart(),
10892                             call, 0))
10893       return ExprError();
10894 
10895     if (ConvertArgumentsForCall(call, op, 0, proto, Args, RParenLoc))
10896       return ExprError();
10897 
10898     return MaybeBindToTemporary(call);
10899   }
10900 
10901   UnbridgedCastsSet UnbridgedCasts;
10902   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
10903     return ExprError();
10904 
10905   MemberExpr *MemExpr;
10906   CXXMethodDecl *Method = 0;
10907   DeclAccessPair FoundDecl = DeclAccessPair::make(0, AS_public);
10908   NestedNameSpecifier *Qualifier = 0;
10909   if (isa<MemberExpr>(NakedMemExpr)) {
10910     MemExpr = cast<MemberExpr>(NakedMemExpr);
10911     Method = cast<CXXMethodDecl>(MemExpr->getMemberDecl());
10912     FoundDecl = MemExpr->getFoundDecl();
10913     Qualifier = MemExpr->getQualifier();
10914     UnbridgedCasts.restore();
10915   } else {
10916     UnresolvedMemberExpr *UnresExpr = cast<UnresolvedMemberExpr>(NakedMemExpr);
10917     Qualifier = UnresExpr->getQualifier();
10918 
10919     QualType ObjectType = UnresExpr->getBaseType();
10920     Expr::Classification ObjectClassification
10921       = UnresExpr->isArrow()? Expr::Classification::makeSimpleLValue()
10922                             : UnresExpr->getBase()->Classify(Context);
10923 
10924     // Add overload candidates
10925     OverloadCandidateSet CandidateSet(UnresExpr->getMemberLoc());
10926 
10927     // FIXME: avoid copy.
10928     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = 0;
10929     if (UnresExpr->hasExplicitTemplateArgs()) {
10930       UnresExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
10931       TemplateArgs = &TemplateArgsBuffer;
10932     }
10933 
10934     for (UnresolvedMemberExpr::decls_iterator I = UnresExpr->decls_begin(),
10935            E = UnresExpr->decls_end(); I != E; ++I) {
10936 
10937       NamedDecl *Func = *I;
10938       CXXRecordDecl *ActingDC = cast<CXXRecordDecl>(Func->getDeclContext());
10939       if (isa<UsingShadowDecl>(Func))
10940         Func = cast<UsingShadowDecl>(Func)->getTargetDecl();
10941 
10942 
10943       // Microsoft supports direct constructor calls.
10944       if (getLangOpts().MicrosoftExt && isa<CXXConstructorDecl>(Func)) {
10945         AddOverloadCandidate(cast<CXXConstructorDecl>(Func), I.getPair(),
10946                              Args, CandidateSet);
10947       } else if ((Method = dyn_cast<CXXMethodDecl>(Func))) {
10948         // If explicit template arguments were provided, we can't call a
10949         // non-template member function.
10950         if (TemplateArgs)
10951           continue;
10952 
10953         AddMethodCandidate(Method, I.getPair(), ActingDC, ObjectType,
10954                            ObjectClassification, Args, CandidateSet,
10955                            /*SuppressUserConversions=*/false);
10956       } else {
10957         AddMethodTemplateCandidate(cast<FunctionTemplateDecl>(Func),
10958                                    I.getPair(), ActingDC, TemplateArgs,
10959                                    ObjectType,  ObjectClassification,
10960                                    Args, CandidateSet,
10961                                    /*SuppressUsedConversions=*/false);
10962       }
10963     }
10964 
10965     DeclarationName DeclName = UnresExpr->getMemberName();
10966 
10967     UnbridgedCasts.restore();
10968 
10969     OverloadCandidateSet::iterator Best;
10970     switch (CandidateSet.BestViableFunction(*this, UnresExpr->getLocStart(),
10971                                             Best)) {
10972     case OR_Success:
10973       Method = cast<CXXMethodDecl>(Best->Function);
10974       FoundDecl = Best->FoundDecl;
10975       CheckUnresolvedMemberAccess(UnresExpr, Best->FoundDecl);
10976       if (DiagnoseUseOfDecl(Best->FoundDecl, UnresExpr->getNameLoc()))
10977         return ExprError();
10978       // If FoundDecl is different from Method (such as if one is a template
10979       // and the other a specialization), make sure DiagnoseUseOfDecl is
10980       // called on both.
10981       // FIXME: This would be more comprehensively addressed by modifying
10982       // DiagnoseUseOfDecl to accept both the FoundDecl and the decl
10983       // being used.
10984       if (Method != FoundDecl.getDecl() &&
10985                       DiagnoseUseOfDecl(Method, UnresExpr->getNameLoc()))
10986         return ExprError();
10987       break;
10988 
10989     case OR_No_Viable_Function:
10990       Diag(UnresExpr->getMemberLoc(),
10991            diag::err_ovl_no_viable_member_function_in_call)
10992         << DeclName << MemExprE->getSourceRange();
10993       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
10994       // FIXME: Leaking incoming expressions!
10995       return ExprError();
10996 
10997     case OR_Ambiguous:
10998       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_ambiguous_member_call)
10999         << DeclName << MemExprE->getSourceRange();
11000       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11001       // FIXME: Leaking incoming expressions!
11002       return ExprError();
11003 
11004     case OR_Deleted:
11005       Diag(UnresExpr->getMemberLoc(), diag::err_ovl_deleted_member_call)
11006         << Best->Function->isDeleted()
11007         << DeclName
11008         << getDeletedOrUnavailableSuffix(Best->Function)
11009         << MemExprE->getSourceRange();
11010       CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11011       // FIXME: Leaking incoming expressions!
11012       return ExprError();
11013     }
11014 
11015     MemExprE = FixOverloadedFunctionReference(MemExprE, FoundDecl, Method);
11016 
11017     // If overload resolution picked a static member, build a
11018     // non-member call based on that function.
11019     if (Method->isStatic()) {
11020       return BuildResolvedCallExpr(MemExprE, Method, LParenLoc, Args,
11021                                    RParenLoc);
11022     }
11023 
11024     MemExpr = cast<MemberExpr>(MemExprE->IgnoreParens());
11025   }
11026 
11027   QualType ResultType = Method->getResultType();
11028   ExprValueKind VK = Expr::getValueKindForType(ResultType);
11029   ResultType = ResultType.getNonLValueExprType(Context);
11030 
11031   assert(Method && "Member call to something that isn't a method?");
11032   CXXMemberCallExpr *TheCall =
11033     new (Context) CXXMemberCallExpr(Context, MemExprE, Args,
11034                                     ResultType, VK, RParenLoc);
11035 
11036   // Check for a valid return type.
11037   if (CheckCallReturnType(Method->getResultType(), MemExpr->getMemberLoc(),
11038                           TheCall, Method))
11039     return ExprError();
11040 
11041   // Convert the object argument (for a non-static member function call).
11042   // We only need to do this if there was actually an overload; otherwise
11043   // it was done at lookup.
11044   if (!Method->isStatic()) {
11045     ExprResult ObjectArg =
11046       PerformObjectArgumentInitialization(MemExpr->getBase(), Qualifier,
11047                                           FoundDecl, Method);
11048     if (ObjectArg.isInvalid())
11049       return ExprError();
11050     MemExpr->setBase(ObjectArg.take());
11051   }
11052 
11053   // Convert the rest of the arguments
11054   const FunctionProtoType *Proto =
11055     Method->getType()->getAs<FunctionProtoType>();
11056   if (ConvertArgumentsForCall(TheCall, MemExpr, Method, Proto, Args,
11057                               RParenLoc))
11058     return ExprError();
11059 
11060   DiagnoseSentinelCalls(Method, LParenLoc, Args);
11061 
11062   if (CheckFunctionCall(Method, TheCall, Proto))
11063     return ExprError();
11064 
11065   if ((isa<CXXConstructorDecl>(CurContext) ||
11066        isa<CXXDestructorDecl>(CurContext)) &&
11067       TheCall->getMethodDecl()->isPure()) {
11068     const CXXMethodDecl *MD = TheCall->getMethodDecl();
11069 
11070     if (isa<CXXThisExpr>(MemExpr->getBase()->IgnoreParenCasts())) {
11071       Diag(MemExpr->getLocStart(),
11072            diag::warn_call_to_pure_virtual_member_function_from_ctor_dtor)
11073         << MD->getDeclName() << isa<CXXDestructorDecl>(CurContext)
11074         << MD->getParent()->getDeclName();
11075 
11076       Diag(MD->getLocStart(), diag::note_previous_decl) << MD->getDeclName();
11077     }
11078   }
11079   return MaybeBindToTemporary(TheCall);
11080 }
11081 
11082 /// BuildCallToObjectOfClassType - Build a call to an object of class
11083 /// type (C++ [over.call.object]), which can end up invoking an
11084 /// overloaded function call operator (@c operator()) or performing a
11085 /// user-defined conversion on the object argument.
11086 ExprResult
11087 Sema::BuildCallToObjectOfClassType(Scope *S, Expr *Obj,
11088                                    SourceLocation LParenLoc,
11089                                    MultiExprArg Args,
11090                                    SourceLocation RParenLoc) {
11091   if (checkPlaceholderForOverload(*this, Obj))
11092     return ExprError();
11093   ExprResult Object = Owned(Obj);
11094 
11095   UnbridgedCastsSet UnbridgedCasts;
11096   if (checkArgPlaceholdersForOverload(*this, Args, UnbridgedCasts))
11097     return ExprError();
11098 
11099   assert(Object.get()->getType()->isRecordType() && "Requires object type argument");
11100   const RecordType *Record = Object.get()->getType()->getAs<RecordType>();
11101 
11102   // C++ [over.call.object]p1:
11103   //  If the primary-expression E in the function call syntax
11104   //  evaluates to a class object of type "cv T", then the set of
11105   //  candidate functions includes at least the function call
11106   //  operators of T. The function call operators of T are obtained by
11107   //  ordinary lookup of the name operator() in the context of
11108   //  (E).operator().
11109   OverloadCandidateSet CandidateSet(LParenLoc);
11110   DeclarationName OpName = Context.DeclarationNames.getCXXOperatorName(OO_Call);
11111 
11112   if (RequireCompleteType(LParenLoc, Object.get()->getType(),
11113                           diag::err_incomplete_object_call, Object.get()))
11114     return true;
11115 
11116   LookupResult R(*this, OpName, LParenLoc, LookupOrdinaryName);
11117   LookupQualifiedName(R, Record->getDecl());
11118   R.suppressDiagnostics();
11119 
11120   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
11121        Oper != OperEnd; ++Oper) {
11122     AddMethodCandidate(Oper.getPair(), Object.get()->getType(),
11123                        Object.get()->Classify(Context),
11124                        Args, CandidateSet,
11125                        /*SuppressUserConversions=*/ false);
11126   }
11127 
11128   // C++ [over.call.object]p2:
11129   //   In addition, for each (non-explicit in C++0x) conversion function
11130   //   declared in T of the form
11131   //
11132   //        operator conversion-type-id () cv-qualifier;
11133   //
11134   //   where cv-qualifier is the same cv-qualification as, or a
11135   //   greater cv-qualification than, cv, and where conversion-type-id
11136   //   denotes the type "pointer to function of (P1,...,Pn) returning
11137   //   R", or the type "reference to pointer to function of
11138   //   (P1,...,Pn) returning R", or the type "reference to function
11139   //   of (P1,...,Pn) returning R", a surrogate call function [...]
11140   //   is also considered as a candidate function. Similarly,
11141   //   surrogate call functions are added to the set of candidate
11142   //   functions for each conversion function declared in an
11143   //   accessible base class provided the function is not hidden
11144   //   within T by another intervening declaration.
11145   std::pair<CXXRecordDecl::conversion_iterator,
11146             CXXRecordDecl::conversion_iterator> Conversions
11147     = cast<CXXRecordDecl>(Record->getDecl())->getVisibleConversionFunctions();
11148   for (CXXRecordDecl::conversion_iterator
11149          I = Conversions.first, E = Conversions.second; I != E; ++I) {
11150     NamedDecl *D = *I;
11151     CXXRecordDecl *ActingContext = cast<CXXRecordDecl>(D->getDeclContext());
11152     if (isa<UsingShadowDecl>(D))
11153       D = cast<UsingShadowDecl>(D)->getTargetDecl();
11154 
11155     // Skip over templated conversion functions; they aren't
11156     // surrogates.
11157     if (isa<FunctionTemplateDecl>(D))
11158       continue;
11159 
11160     CXXConversionDecl *Conv = cast<CXXConversionDecl>(D);
11161     if (!Conv->isExplicit()) {
11162       // Strip the reference type (if any) and then the pointer type (if
11163       // any) to get down to what might be a function type.
11164       QualType ConvType = Conv->getConversionType().getNonReferenceType();
11165       if (const PointerType *ConvPtrType = ConvType->getAs<PointerType>())
11166         ConvType = ConvPtrType->getPointeeType();
11167 
11168       if (const FunctionProtoType *Proto = ConvType->getAs<FunctionProtoType>())
11169       {
11170         AddSurrogateCandidate(Conv, I.getPair(), ActingContext, Proto,
11171                               Object.get(), Args, CandidateSet);
11172       }
11173     }
11174   }
11175 
11176   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11177 
11178   // Perform overload resolution.
11179   OverloadCandidateSet::iterator Best;
11180   switch (CandidateSet.BestViableFunction(*this, Object.get()->getLocStart(),
11181                              Best)) {
11182   case OR_Success:
11183     // Overload resolution succeeded; we'll build the appropriate call
11184     // below.
11185     break;
11186 
11187   case OR_No_Viable_Function:
11188     if (CandidateSet.empty())
11189       Diag(Object.get()->getLocStart(), diag::err_ovl_no_oper)
11190         << Object.get()->getType() << /*call*/ 1
11191         << Object.get()->getSourceRange();
11192     else
11193       Diag(Object.get()->getLocStart(),
11194            diag::err_ovl_no_viable_object_call)
11195         << Object.get()->getType() << Object.get()->getSourceRange();
11196     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11197     break;
11198 
11199   case OR_Ambiguous:
11200     Diag(Object.get()->getLocStart(),
11201          diag::err_ovl_ambiguous_object_call)
11202       << Object.get()->getType() << Object.get()->getSourceRange();
11203     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
11204     break;
11205 
11206   case OR_Deleted:
11207     Diag(Object.get()->getLocStart(),
11208          diag::err_ovl_deleted_object_call)
11209       << Best->Function->isDeleted()
11210       << Object.get()->getType()
11211       << getDeletedOrUnavailableSuffix(Best->Function)
11212       << Object.get()->getSourceRange();
11213     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11214     break;
11215   }
11216 
11217   if (Best == CandidateSet.end())
11218     return true;
11219 
11220   UnbridgedCasts.restore();
11221 
11222   if (Best->Function == 0) {
11223     // Since there is no function declaration, this is one of the
11224     // surrogate candidates. Dig out the conversion function.
11225     CXXConversionDecl *Conv
11226       = cast<CXXConversionDecl>(
11227                          Best->Conversions[0].UserDefined.ConversionFunction);
11228 
11229     CheckMemberOperatorAccess(LParenLoc, Object.get(), 0, Best->FoundDecl);
11230     if (DiagnoseUseOfDecl(Best->FoundDecl, LParenLoc))
11231       return ExprError();
11232     assert(Conv == Best->FoundDecl.getDecl() &&
11233              "Found Decl & conversion-to-functionptr should be same, right?!");
11234     // We selected one of the surrogate functions that converts the
11235     // object parameter to a function pointer. Perform the conversion
11236     // on the object argument, then let ActOnCallExpr finish the job.
11237 
11238     // Create an implicit member expr to refer to the conversion operator.
11239     // and then call it.
11240     ExprResult Call = BuildCXXMemberCallExpr(Object.get(), Best->FoundDecl,
11241                                              Conv, HadMultipleCandidates);
11242     if (Call.isInvalid())
11243       return ExprError();
11244     // Record usage of conversion in an implicit cast.
11245     Call = Owned(ImplicitCastExpr::Create(Context, Call.get()->getType(),
11246                                           CK_UserDefinedConversion,
11247                                           Call.get(), 0, VK_RValue));
11248 
11249     return ActOnCallExpr(S, Call.get(), LParenLoc, Args, RParenLoc);
11250   }
11251 
11252   CheckMemberOperatorAccess(LParenLoc, Object.get(), 0, Best->FoundDecl);
11253 
11254   // We found an overloaded operator(). Build a CXXOperatorCallExpr
11255   // that calls this method, using Object for the implicit object
11256   // parameter and passing along the remaining arguments.
11257   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
11258 
11259   // An error diagnostic has already been printed when parsing the declaration.
11260   if (Method->isInvalidDecl())
11261     return ExprError();
11262 
11263   const FunctionProtoType *Proto =
11264     Method->getType()->getAs<FunctionProtoType>();
11265 
11266   unsigned NumArgsInProto = Proto->getNumArgs();
11267   unsigned NumArgsToCheck = Args.size();
11268 
11269   // Build the full argument list for the method call (the
11270   // implicit object parameter is placed at the beginning of the
11271   // list).
11272   Expr **MethodArgs;
11273   if (Args.size() < NumArgsInProto) {
11274     NumArgsToCheck = NumArgsInProto;
11275     MethodArgs = new Expr*[NumArgsInProto + 1];
11276   } else {
11277     MethodArgs = new Expr*[Args.size() + 1];
11278   }
11279   MethodArgs[0] = Object.get();
11280   for (unsigned ArgIdx = 0, e = Args.size(); ArgIdx != e; ++ArgIdx)
11281     MethodArgs[ArgIdx + 1] = Args[ArgIdx];
11282 
11283   DeclarationNameInfo OpLocInfo(
11284                Context.DeclarationNames.getCXXOperatorName(OO_Call), LParenLoc);
11285   OpLocInfo.setCXXOperatorNameRange(SourceRange(LParenLoc, RParenLoc));
11286   ExprResult NewFn = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
11287                                            HadMultipleCandidates,
11288                                            OpLocInfo.getLoc(),
11289                                            OpLocInfo.getInfo());
11290   if (NewFn.isInvalid())
11291     return true;
11292 
11293   // Once we've built TheCall, all of the expressions are properly
11294   // owned.
11295   QualType ResultTy = Method->getResultType();
11296   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11297   ResultTy = ResultTy.getNonLValueExprType(Context);
11298 
11299   CXXOperatorCallExpr *TheCall =
11300     new (Context) CXXOperatorCallExpr(Context, OO_Call, NewFn.take(),
11301                                       llvm::makeArrayRef(MethodArgs, Args.size()+1),
11302                                       ResultTy, VK, RParenLoc, false);
11303   delete [] MethodArgs;
11304 
11305   if (CheckCallReturnType(Method->getResultType(), LParenLoc, TheCall,
11306                           Method))
11307     return true;
11308 
11309   // We may have default arguments. If so, we need to allocate more
11310   // slots in the call for them.
11311   if (Args.size() < NumArgsInProto)
11312     TheCall->setNumArgs(Context, NumArgsInProto + 1);
11313   else if (Args.size() > NumArgsInProto)
11314     NumArgsToCheck = NumArgsInProto;
11315 
11316   bool IsError = false;
11317 
11318   // Initialize the implicit object parameter.
11319   ExprResult ObjRes =
11320     PerformObjectArgumentInitialization(Object.get(), /*Qualifier=*/0,
11321                                         Best->FoundDecl, Method);
11322   if (ObjRes.isInvalid())
11323     IsError = true;
11324   else
11325     Object = ObjRes;
11326   TheCall->setArg(0, Object.take());
11327 
11328   // Check the argument types.
11329   for (unsigned i = 0; i != NumArgsToCheck; i++) {
11330     Expr *Arg;
11331     if (i < Args.size()) {
11332       Arg = Args[i];
11333 
11334       // Pass the argument.
11335 
11336       ExprResult InputInit
11337         = PerformCopyInitialization(InitializedEntity::InitializeParameter(
11338                                                     Context,
11339                                                     Method->getParamDecl(i)),
11340                                     SourceLocation(), Arg);
11341 
11342       IsError |= InputInit.isInvalid();
11343       Arg = InputInit.takeAs<Expr>();
11344     } else {
11345       ExprResult DefArg
11346         = BuildCXXDefaultArgExpr(LParenLoc, Method, Method->getParamDecl(i));
11347       if (DefArg.isInvalid()) {
11348         IsError = true;
11349         break;
11350       }
11351 
11352       Arg = DefArg.takeAs<Expr>();
11353     }
11354 
11355     TheCall->setArg(i + 1, Arg);
11356   }
11357 
11358   // If this is a variadic call, handle args passed through "...".
11359   if (Proto->isVariadic()) {
11360     // Promote the arguments (C99 6.5.2.2p7).
11361     for (unsigned i = NumArgsInProto, e = Args.size(); i < e; i++) {
11362       ExprResult Arg = DefaultVariadicArgumentPromotion(Args[i], VariadicMethod, 0);
11363       IsError |= Arg.isInvalid();
11364       TheCall->setArg(i + 1, Arg.take());
11365     }
11366   }
11367 
11368   if (IsError) return true;
11369 
11370   DiagnoseSentinelCalls(Method, LParenLoc, Args);
11371 
11372   if (CheckFunctionCall(Method, TheCall, Proto))
11373     return true;
11374 
11375   return MaybeBindToTemporary(TheCall);
11376 }
11377 
11378 /// BuildOverloadedArrowExpr - Build a call to an overloaded @c operator->
11379 ///  (if one exists), where @c Base is an expression of class type and
11380 /// @c Member is the name of the member we're trying to find.
11381 ExprResult
11382 Sema::BuildOverloadedArrowExpr(Scope *S, Expr *Base, SourceLocation OpLoc) {
11383   assert(Base->getType()->isRecordType() &&
11384          "left-hand side must have class type");
11385 
11386   if (checkPlaceholderForOverload(*this, Base))
11387     return ExprError();
11388 
11389   SourceLocation Loc = Base->getExprLoc();
11390 
11391   // C++ [over.ref]p1:
11392   //
11393   //   [...] An expression x->m is interpreted as (x.operator->())->m
11394   //   for a class object x of type T if T::operator->() exists and if
11395   //   the operator is selected as the best match function by the
11396   //   overload resolution mechanism (13.3).
11397   DeclarationName OpName =
11398     Context.DeclarationNames.getCXXOperatorName(OO_Arrow);
11399   OverloadCandidateSet CandidateSet(Loc);
11400   const RecordType *BaseRecord = Base->getType()->getAs<RecordType>();
11401 
11402   if (RequireCompleteType(Loc, Base->getType(),
11403                           diag::err_typecheck_incomplete_tag, Base))
11404     return ExprError();
11405 
11406   LookupResult R(*this, OpName, OpLoc, LookupOrdinaryName);
11407   LookupQualifiedName(R, BaseRecord->getDecl());
11408   R.suppressDiagnostics();
11409 
11410   for (LookupResult::iterator Oper = R.begin(), OperEnd = R.end();
11411        Oper != OperEnd; ++Oper) {
11412     AddMethodCandidate(Oper.getPair(), Base->getType(), Base->Classify(Context),
11413                        None, CandidateSet, /*SuppressUserConversions=*/false);
11414   }
11415 
11416   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11417 
11418   // Perform overload resolution.
11419   OverloadCandidateSet::iterator Best;
11420   switch (CandidateSet.BestViableFunction(*this, OpLoc, Best)) {
11421   case OR_Success:
11422     // Overload resolution succeeded; we'll build the call below.
11423     break;
11424 
11425   case OR_No_Viable_Function:
11426     if (CandidateSet.empty())
11427       Diag(OpLoc, diag::err_typecheck_member_reference_arrow)
11428         << Base->getType() << Base->getSourceRange();
11429     else
11430       Diag(OpLoc, diag::err_ovl_no_viable_oper)
11431         << "operator->" << Base->getSourceRange();
11432     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
11433     return ExprError();
11434 
11435   case OR_Ambiguous:
11436     Diag(OpLoc,  diag::err_ovl_ambiguous_oper_unary)
11437       << "->" << Base->getType() << Base->getSourceRange();
11438     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Base);
11439     return ExprError();
11440 
11441   case OR_Deleted:
11442     Diag(OpLoc,  diag::err_ovl_deleted_oper)
11443       << Best->Function->isDeleted()
11444       << "->"
11445       << getDeletedOrUnavailableSuffix(Best->Function)
11446       << Base->getSourceRange();
11447     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Base);
11448     return ExprError();
11449   }
11450 
11451   CheckMemberOperatorAccess(OpLoc, Base, 0, Best->FoundDecl);
11452 
11453   // Convert the object parameter.
11454   CXXMethodDecl *Method = cast<CXXMethodDecl>(Best->Function);
11455   ExprResult BaseResult =
11456     PerformObjectArgumentInitialization(Base, /*Qualifier=*/0,
11457                                         Best->FoundDecl, Method);
11458   if (BaseResult.isInvalid())
11459     return ExprError();
11460   Base = BaseResult.take();
11461 
11462   // Build the operator call.
11463   ExprResult FnExpr = CreateFunctionRefExpr(*this, Method, Best->FoundDecl,
11464                                             HadMultipleCandidates, OpLoc);
11465   if (FnExpr.isInvalid())
11466     return ExprError();
11467 
11468   QualType ResultTy = Method->getResultType();
11469   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11470   ResultTy = ResultTy.getNonLValueExprType(Context);
11471   CXXOperatorCallExpr *TheCall =
11472     new (Context) CXXOperatorCallExpr(Context, OO_Arrow, FnExpr.take(),
11473                                       Base, ResultTy, VK, OpLoc, false);
11474 
11475   if (CheckCallReturnType(Method->getResultType(), OpLoc, TheCall,
11476                           Method))
11477           return ExprError();
11478 
11479   return MaybeBindToTemporary(TheCall);
11480 }
11481 
11482 /// BuildLiteralOperatorCall - Build a UserDefinedLiteral by creating a call to
11483 /// a literal operator described by the provided lookup results.
11484 ExprResult Sema::BuildLiteralOperatorCall(LookupResult &R,
11485                                           DeclarationNameInfo &SuffixInfo,
11486                                           ArrayRef<Expr*> Args,
11487                                           SourceLocation LitEndLoc,
11488                                        TemplateArgumentListInfo *TemplateArgs) {
11489   SourceLocation UDSuffixLoc = SuffixInfo.getCXXLiteralOperatorNameLoc();
11490 
11491   OverloadCandidateSet CandidateSet(UDSuffixLoc);
11492   AddFunctionCandidates(R.asUnresolvedSet(), Args, CandidateSet, true,
11493                         TemplateArgs);
11494 
11495   bool HadMultipleCandidates = (CandidateSet.size() > 1);
11496 
11497   // Perform overload resolution. This will usually be trivial, but might need
11498   // to perform substitutions for a literal operator template.
11499   OverloadCandidateSet::iterator Best;
11500   switch (CandidateSet.BestViableFunction(*this, UDSuffixLoc, Best)) {
11501   case OR_Success:
11502   case OR_Deleted:
11503     break;
11504 
11505   case OR_No_Viable_Function:
11506     Diag(UDSuffixLoc, diag::err_ovl_no_viable_function_in_call)
11507       << R.getLookupName();
11508     CandidateSet.NoteCandidates(*this, OCD_AllCandidates, Args);
11509     return ExprError();
11510 
11511   case OR_Ambiguous:
11512     Diag(R.getNameLoc(), diag::err_ovl_ambiguous_call) << R.getLookupName();
11513     CandidateSet.NoteCandidates(*this, OCD_ViableCandidates, Args);
11514     return ExprError();
11515   }
11516 
11517   FunctionDecl *FD = Best->Function;
11518   ExprResult Fn = CreateFunctionRefExpr(*this, FD, Best->FoundDecl,
11519                                         HadMultipleCandidates,
11520                                         SuffixInfo.getLoc(),
11521                                         SuffixInfo.getInfo());
11522   if (Fn.isInvalid())
11523     return true;
11524 
11525   // Check the argument types. This should almost always be a no-op, except
11526   // that array-to-pointer decay is applied to string literals.
11527   Expr *ConvArgs[2];
11528   for (unsigned ArgIdx = 0, N = Args.size(); ArgIdx != N; ++ArgIdx) {
11529     ExprResult InputInit = PerformCopyInitialization(
11530       InitializedEntity::InitializeParameter(Context, FD->getParamDecl(ArgIdx)),
11531       SourceLocation(), Args[ArgIdx]);
11532     if (InputInit.isInvalid())
11533       return true;
11534     ConvArgs[ArgIdx] = InputInit.take();
11535   }
11536 
11537   QualType ResultTy = FD->getResultType();
11538   ExprValueKind VK = Expr::getValueKindForType(ResultTy);
11539   ResultTy = ResultTy.getNonLValueExprType(Context);
11540 
11541   UserDefinedLiteral *UDL =
11542     new (Context) UserDefinedLiteral(Context, Fn.take(),
11543                                      llvm::makeArrayRef(ConvArgs, Args.size()),
11544                                      ResultTy, VK, LitEndLoc, UDSuffixLoc);
11545 
11546   if (CheckCallReturnType(FD->getResultType(), UDSuffixLoc, UDL, FD))
11547     return ExprError();
11548 
11549   if (CheckFunctionCall(FD, UDL, NULL))
11550     return ExprError();
11551 
11552   return MaybeBindToTemporary(UDL);
11553 }
11554 
11555 /// Build a call to 'begin' or 'end' for a C++11 for-range statement. If the
11556 /// given LookupResult is non-empty, it is assumed to describe a member which
11557 /// will be invoked. Otherwise, the function will be found via argument
11558 /// dependent lookup.
11559 /// CallExpr is set to a valid expression and FRS_Success returned on success,
11560 /// otherwise CallExpr is set to ExprError() and some non-success value
11561 /// is returned.
11562 Sema::ForRangeStatus
11563 Sema::BuildForRangeBeginEndCall(Scope *S, SourceLocation Loc,
11564                                 SourceLocation RangeLoc, VarDecl *Decl,
11565                                 BeginEndFunction BEF,
11566                                 const DeclarationNameInfo &NameInfo,
11567                                 LookupResult &MemberLookup,
11568                                 OverloadCandidateSet *CandidateSet,
11569                                 Expr *Range, ExprResult *CallExpr) {
11570   CandidateSet->clear();
11571   if (!MemberLookup.empty()) {
11572     ExprResult MemberRef =
11573         BuildMemberReferenceExpr(Range, Range->getType(), Loc,
11574                                  /*IsPtr=*/false, CXXScopeSpec(),
11575                                  /*TemplateKWLoc=*/SourceLocation(),
11576                                  /*FirstQualifierInScope=*/0,
11577                                  MemberLookup,
11578                                  /*TemplateArgs=*/0);
11579     if (MemberRef.isInvalid()) {
11580       *CallExpr = ExprError();
11581       Diag(Range->getLocStart(), diag::note_in_for_range)
11582           << RangeLoc << BEF << Range->getType();
11583       return FRS_DiagnosticIssued;
11584     }
11585     *CallExpr = ActOnCallExpr(S, MemberRef.get(), Loc, None, Loc, 0);
11586     if (CallExpr->isInvalid()) {
11587       *CallExpr = ExprError();
11588       Diag(Range->getLocStart(), diag::note_in_for_range)
11589           << RangeLoc << BEF << Range->getType();
11590       return FRS_DiagnosticIssued;
11591     }
11592   } else {
11593     UnresolvedSet<0> FoundNames;
11594     UnresolvedLookupExpr *Fn =
11595       UnresolvedLookupExpr::Create(Context, /*NamingClass=*/0,
11596                                    NestedNameSpecifierLoc(), NameInfo,
11597                                    /*NeedsADL=*/true, /*Overloaded=*/false,
11598                                    FoundNames.begin(), FoundNames.end());
11599 
11600     bool CandidateSetError = buildOverloadedCallSet(S, Fn, Fn, Range, Loc,
11601                                                     CandidateSet, CallExpr);
11602     if (CandidateSet->empty() || CandidateSetError) {
11603       *CallExpr = ExprError();
11604       return FRS_NoViableFunction;
11605     }
11606     OverloadCandidateSet::iterator Best;
11607     OverloadingResult OverloadResult =
11608         CandidateSet->BestViableFunction(*this, Fn->getLocStart(), Best);
11609 
11610     if (OverloadResult == OR_No_Viable_Function) {
11611       *CallExpr = ExprError();
11612       return FRS_NoViableFunction;
11613     }
11614     *CallExpr = FinishOverloadedCallExpr(*this, S, Fn, Fn, Loc, Range,
11615                                          Loc, 0, CandidateSet, &Best,
11616                                          OverloadResult,
11617                                          /*AllowTypoCorrection=*/false);
11618     if (CallExpr->isInvalid() || OverloadResult != OR_Success) {
11619       *CallExpr = ExprError();
11620       Diag(Range->getLocStart(), diag::note_in_for_range)
11621           << RangeLoc << BEF << Range->getType();
11622       return FRS_DiagnosticIssued;
11623     }
11624   }
11625   return FRS_Success;
11626 }
11627 
11628 
11629 /// FixOverloadedFunctionReference - E is an expression that refers to
11630 /// a C++ overloaded function (possibly with some parentheses and
11631 /// perhaps a '&' around it). We have resolved the overloaded function
11632 /// to the function declaration Fn, so patch up the expression E to
11633 /// refer (possibly indirectly) to Fn. Returns the new expr.
11634 Expr *Sema::FixOverloadedFunctionReference(Expr *E, DeclAccessPair Found,
11635                                            FunctionDecl *Fn) {
11636   if (ParenExpr *PE = dyn_cast<ParenExpr>(E)) {
11637     Expr *SubExpr = FixOverloadedFunctionReference(PE->getSubExpr(),
11638                                                    Found, Fn);
11639     if (SubExpr == PE->getSubExpr())
11640       return PE;
11641 
11642     return new (Context) ParenExpr(PE->getLParen(), PE->getRParen(), SubExpr);
11643   }
11644 
11645   if (ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(E)) {
11646     Expr *SubExpr = FixOverloadedFunctionReference(ICE->getSubExpr(),
11647                                                    Found, Fn);
11648     assert(Context.hasSameType(ICE->getSubExpr()->getType(),
11649                                SubExpr->getType()) &&
11650            "Implicit cast type cannot be determined from overload");
11651     assert(ICE->path_empty() && "fixing up hierarchy conversion?");
11652     if (SubExpr == ICE->getSubExpr())
11653       return ICE;
11654 
11655     return ImplicitCastExpr::Create(Context, ICE->getType(),
11656                                     ICE->getCastKind(),
11657                                     SubExpr, 0,
11658                                     ICE->getValueKind());
11659   }
11660 
11661   if (UnaryOperator *UnOp = dyn_cast<UnaryOperator>(E)) {
11662     assert(UnOp->getOpcode() == UO_AddrOf &&
11663            "Can only take the address of an overloaded function");
11664     if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(Fn)) {
11665       if (Method->isStatic()) {
11666         // Do nothing: static member functions aren't any different
11667         // from non-member functions.
11668       } else {
11669         // Fix the sub expression, which really has to be an
11670         // UnresolvedLookupExpr holding an overloaded member function
11671         // or template.
11672         Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
11673                                                        Found, Fn);
11674         if (SubExpr == UnOp->getSubExpr())
11675           return UnOp;
11676 
11677         assert(isa<DeclRefExpr>(SubExpr)
11678                && "fixed to something other than a decl ref");
11679         assert(cast<DeclRefExpr>(SubExpr)->getQualifier()
11680                && "fixed to a member ref with no nested name qualifier");
11681 
11682         // We have taken the address of a pointer to member
11683         // function. Perform the computation here so that we get the
11684         // appropriate pointer to member type.
11685         QualType ClassType
11686           = Context.getTypeDeclType(cast<RecordDecl>(Method->getDeclContext()));
11687         QualType MemPtrType
11688           = Context.getMemberPointerType(Fn->getType(), ClassType.getTypePtr());
11689 
11690         return new (Context) UnaryOperator(SubExpr, UO_AddrOf, MemPtrType,
11691                                            VK_RValue, OK_Ordinary,
11692                                            UnOp->getOperatorLoc());
11693       }
11694     }
11695     Expr *SubExpr = FixOverloadedFunctionReference(UnOp->getSubExpr(),
11696                                                    Found, Fn);
11697     if (SubExpr == UnOp->getSubExpr())
11698       return UnOp;
11699 
11700     return new (Context) UnaryOperator(SubExpr, UO_AddrOf,
11701                                      Context.getPointerType(SubExpr->getType()),
11702                                        VK_RValue, OK_Ordinary,
11703                                        UnOp->getOperatorLoc());
11704   }
11705 
11706   if (UnresolvedLookupExpr *ULE = dyn_cast<UnresolvedLookupExpr>(E)) {
11707     // FIXME: avoid copy.
11708     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = 0;
11709     if (ULE->hasExplicitTemplateArgs()) {
11710       ULE->copyTemplateArgumentsInto(TemplateArgsBuffer);
11711       TemplateArgs = &TemplateArgsBuffer;
11712     }
11713 
11714     DeclRefExpr *DRE = DeclRefExpr::Create(Context,
11715                                            ULE->getQualifierLoc(),
11716                                            ULE->getTemplateKeywordLoc(),
11717                                            Fn,
11718                                            /*enclosing*/ false, // FIXME?
11719                                            ULE->getNameLoc(),
11720                                            Fn->getType(),
11721                                            VK_LValue,
11722                                            Found.getDecl(),
11723                                            TemplateArgs);
11724     MarkDeclRefReferenced(DRE);
11725     DRE->setHadMultipleCandidates(ULE->getNumDecls() > 1);
11726     return DRE;
11727   }
11728 
11729   if (UnresolvedMemberExpr *MemExpr = dyn_cast<UnresolvedMemberExpr>(E)) {
11730     // FIXME: avoid copy.
11731     TemplateArgumentListInfo TemplateArgsBuffer, *TemplateArgs = 0;
11732     if (MemExpr->hasExplicitTemplateArgs()) {
11733       MemExpr->copyTemplateArgumentsInto(TemplateArgsBuffer);
11734       TemplateArgs = &TemplateArgsBuffer;
11735     }
11736 
11737     Expr *Base;
11738 
11739     // If we're filling in a static method where we used to have an
11740     // implicit member access, rewrite to a simple decl ref.
11741     if (MemExpr->isImplicitAccess()) {
11742       if (cast<CXXMethodDecl>(Fn)->isStatic()) {
11743         DeclRefExpr *DRE = DeclRefExpr::Create(Context,
11744                                                MemExpr->getQualifierLoc(),
11745                                                MemExpr->getTemplateKeywordLoc(),
11746                                                Fn,
11747                                                /*enclosing*/ false,
11748                                                MemExpr->getMemberLoc(),
11749                                                Fn->getType(),
11750                                                VK_LValue,
11751                                                Found.getDecl(),
11752                                                TemplateArgs);
11753         MarkDeclRefReferenced(DRE);
11754         DRE->setHadMultipleCandidates(MemExpr->getNumDecls() > 1);
11755         return DRE;
11756       } else {
11757         SourceLocation Loc = MemExpr->getMemberLoc();
11758         if (MemExpr->getQualifier())
11759           Loc = MemExpr->getQualifierLoc().getBeginLoc();
11760         CheckCXXThisCapture(Loc);
11761         Base = new (Context) CXXThisExpr(Loc,
11762                                          MemExpr->getBaseType(),
11763                                          /*isImplicit=*/true);
11764       }
11765     } else
11766       Base = MemExpr->getBase();
11767 
11768     ExprValueKind valueKind;
11769     QualType type;
11770     if (cast<CXXMethodDecl>(Fn)->isStatic()) {
11771       valueKind = VK_LValue;
11772       type = Fn->getType();
11773     } else {
11774       valueKind = VK_RValue;
11775       type = Context.BoundMemberTy;
11776     }
11777 
11778     MemberExpr *ME = MemberExpr::Create(Context, Base,
11779                                         MemExpr->isArrow(),
11780                                         MemExpr->getQualifierLoc(),
11781                                         MemExpr->getTemplateKeywordLoc(),
11782                                         Fn,
11783                                         Found,
11784                                         MemExpr->getMemberNameInfo(),
11785                                         TemplateArgs,
11786                                         type, valueKind, OK_Ordinary);
11787     ME->setHadMultipleCandidates(true);
11788     MarkMemberReferenced(ME);
11789     return ME;
11790   }
11791 
11792   llvm_unreachable("Invalid reference to overloaded function");
11793 }
11794 
11795 ExprResult Sema::FixOverloadedFunctionReference(ExprResult E,
11796                                                 DeclAccessPair Found,
11797                                                 FunctionDecl *Fn) {
11798   return Owned(FixOverloadedFunctionReference((Expr *)E.get(), Found, Fn));
11799 }
11800 
11801 } // end namespace clang
11802