//===------ SemaDeclCXX.cpp - Semantic Analysis for C++ Declarations ------===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// // // This file implements semantic analysis for C++ declarations. // //===----------------------------------------------------------------------===// #include "Sema.h" #include "SemaInherit.h" #include "clang/AST/ASTConsumer.h" #include "clang/AST/ASTContext.h" #include "clang/AST/TypeOrdering.h" #include "clang/AST/StmtVisitor.h" #include "clang/Lex/Preprocessor.h" #include "clang/Basic/Diagnostic.h" #include "clang/Parse/DeclSpec.h" #include "llvm/Support/Compiler.h" #include // for std::equal #include using namespace clang; //===----------------------------------------------------------------------===// // CheckDefaultArgumentVisitor //===----------------------------------------------------------------------===// namespace { /// CheckDefaultArgumentVisitor - C++ [dcl.fct.default] Traverses /// the default argument of a parameter to determine whether it /// contains any ill-formed subexpressions. For example, this will /// diagnose the use of local variables or parameters within the /// default argument expression. class VISIBILITY_HIDDEN CheckDefaultArgumentVisitor : public StmtVisitor { Expr *DefaultArg; Sema *S; public: CheckDefaultArgumentVisitor(Expr *defarg, Sema *s) : DefaultArg(defarg), S(s) {} bool VisitExpr(Expr *Node); bool VisitDeclRefExpr(DeclRefExpr *DRE); bool VisitCXXThisExpr(CXXThisExpr *ThisE); }; /// VisitExpr - Visit all of the children of this expression. bool CheckDefaultArgumentVisitor::VisitExpr(Expr *Node) { bool IsInvalid = false; for (Stmt::child_iterator I = Node->child_begin(), E = Node->child_end(); I != E; ++I) IsInvalid |= Visit(*I); return IsInvalid; } /// VisitDeclRefExpr - Visit a reference to a declaration, to /// determine whether this declaration can be used in the default /// argument expression. bool CheckDefaultArgumentVisitor::VisitDeclRefExpr(DeclRefExpr *DRE) { NamedDecl *Decl = DRE->getDecl(); if (ParmVarDecl *Param = dyn_cast(Decl)) { // C++ [dcl.fct.default]p9 // Default arguments are evaluated each time the function is // called. The order of evaluation of function arguments is // unspecified. Consequently, parameters of a function shall not // be used in default argument expressions, even if they are not // evaluated. Parameters of a function declared before a default // argument expression are in scope and can hide namespace and // class member names. return S->Diag(DRE->getSourceRange().getBegin(), diag::err_param_default_argument_references_param, Param->getName(), DefaultArg->getSourceRange()); } else if (VarDecl *VDecl = dyn_cast(Decl)) { // C++ [dcl.fct.default]p7 // Local variables shall not be used in default argument // expressions. if (VDecl->isBlockVarDecl()) return S->Diag(DRE->getSourceRange().getBegin(), diag::err_param_default_argument_references_local, VDecl->getName(), DefaultArg->getSourceRange()); } return false; } /// VisitCXXThisExpr - Visit a C++ "this" expression. bool CheckDefaultArgumentVisitor::VisitCXXThisExpr(CXXThisExpr *ThisE) { // C++ [dcl.fct.default]p8: // The keyword this shall not be used in a default argument of a // member function. return S->Diag(ThisE->getSourceRange().getBegin(), diag::err_param_default_argument_references_this, ThisE->getSourceRange()); } } /// ActOnParamDefaultArgument - Check whether the default argument /// provided for a function parameter is well-formed. If so, attach it /// to the parameter declaration. void Sema::ActOnParamDefaultArgument(DeclTy *param, SourceLocation EqualLoc, ExprTy *defarg) { ParmVarDecl *Param = (ParmVarDecl *)param; llvm::OwningPtr DefaultArg((Expr *)defarg); QualType ParamType = Param->getType(); // Default arguments are only permitted in C++ if (!getLangOptions().CPlusPlus) { Diag(EqualLoc, diag::err_param_default_argument, DefaultArg->getSourceRange()); return; } // C++ [dcl.fct.default]p5 // A default argument expression is implicitly converted (clause // 4) to the parameter type. The default argument expression has // the same semantic constraints as the initializer expression in // a declaration of a variable of the parameter type, using the // copy-initialization semantics (8.5). Expr *DefaultArgPtr = DefaultArg.get(); bool DefaultInitFailed = PerformCopyInitialization(DefaultArgPtr, ParamType, "in default argument"); if (DefaultArgPtr != DefaultArg.get()) { DefaultArg.take(); DefaultArg.reset(DefaultArgPtr); } if (DefaultInitFailed) { return; } // Check that the default argument is well-formed CheckDefaultArgumentVisitor DefaultArgChecker(DefaultArg.get(), this); if (DefaultArgChecker.Visit(DefaultArg.get())) return; // Okay: add the default argument to the parameter Param->setDefaultArg(DefaultArg.take()); } /// CheckExtraCXXDefaultArguments - Check for any extra default /// arguments in the declarator, which is not a function declaration /// or definition and therefore is not permitted to have default /// arguments. This routine should be invoked for every declarator /// that is not a function declaration or definition. void Sema::CheckExtraCXXDefaultArguments(Declarator &D) { // C++ [dcl.fct.default]p3 // A default argument expression shall be specified only in the // parameter-declaration-clause of a function declaration or in a // template-parameter (14.1). It shall not be specified for a // parameter pack. If it is specified in a // parameter-declaration-clause, it shall not occur within a // declarator or abstract-declarator of a parameter-declaration. for (unsigned i = 0; i < D.getNumTypeObjects(); ++i) { DeclaratorChunk &chunk = D.getTypeObject(i); if (chunk.Kind == DeclaratorChunk::Function) { for (unsigned argIdx = 0; argIdx < chunk.Fun.NumArgs; ++argIdx) { ParmVarDecl *Param = (ParmVarDecl *)chunk.Fun.ArgInfo[argIdx].Param; if (Param->getDefaultArg()) { Diag(Param->getLocation(), diag::err_param_default_argument_nonfunc, Param->getDefaultArg()->getSourceRange()); Param->setDefaultArg(0); } } } } } // MergeCXXFunctionDecl - Merge two declarations of the same C++ // function, once we already know that they have the same // type. Subroutine of MergeFunctionDecl. FunctionDecl * Sema::MergeCXXFunctionDecl(FunctionDecl *New, FunctionDecl *Old) { // C++ [dcl.fct.default]p4: // // For non-template functions, default arguments can be added in // later declarations of a function in the same // scope. Declarations in different scopes have completely // distinct sets of default arguments. That is, declarations in // inner scopes do not acquire default arguments from // declarations in outer scopes, and vice versa. In a given // function declaration, all parameters subsequent to a // parameter with a default argument shall have default // arguments supplied in this or previous declarations. A // default argument shall not be redefined by a later // declaration (not even to the same value). for (unsigned p = 0, NumParams = Old->getNumParams(); p < NumParams; ++p) { ParmVarDecl *OldParam = Old->getParamDecl(p); ParmVarDecl *NewParam = New->getParamDecl(p); if(OldParam->getDefaultArg() && NewParam->getDefaultArg()) { Diag(NewParam->getLocation(), diag::err_param_default_argument_redefinition, NewParam->getDefaultArg()->getSourceRange()); Diag(OldParam->getLocation(), diag::err_previous_definition); } else if (OldParam->getDefaultArg()) { // Merge the old default argument into the new parameter NewParam->setDefaultArg(OldParam->getDefaultArg()); } } return New; } /// CheckCXXDefaultArguments - Verify that the default arguments for a /// function declaration are well-formed according to C++ /// [dcl.fct.default]. void Sema::CheckCXXDefaultArguments(FunctionDecl *FD) { unsigned NumParams = FD->getNumParams(); unsigned p; // Find first parameter with a default argument for (p = 0; p < NumParams; ++p) { ParmVarDecl *Param = FD->getParamDecl(p); if (Param->getDefaultArg()) break; } // C++ [dcl.fct.default]p4: // In a given function declaration, all parameters // subsequent to a parameter with a default argument shall // have default arguments supplied in this or previous // declarations. A default argument shall not be redefined // by a later declaration (not even to the same value). unsigned LastMissingDefaultArg = 0; for(; p < NumParams; ++p) { ParmVarDecl *Param = FD->getParamDecl(p); if (!Param->getDefaultArg()) { if (Param->getIdentifier()) Diag(Param->getLocation(), diag::err_param_default_argument_missing_name, Param->getIdentifier()->getName()); else Diag(Param->getLocation(), diag::err_param_default_argument_missing); LastMissingDefaultArg = p; } } if (LastMissingDefaultArg > 0) { // Some default arguments were missing. Clear out all of the // default arguments up to (and including) the last missing // default argument, so that we leave the function parameters // in a semantically valid state. for (p = 0; p <= LastMissingDefaultArg; ++p) { ParmVarDecl *Param = FD->getParamDecl(p); if (Param->getDefaultArg()) { delete Param->getDefaultArg(); Param->setDefaultArg(0); } } } } /// isCurrentClassName - Determine whether the identifier II is the /// name of the class type currently being defined. In the case of /// nested classes, this will only return true if II is the name of /// the innermost class. bool Sema::isCurrentClassName(const IdentifierInfo &II, Scope *, const CXXScopeSpec *SS) { if (CXXRecordDecl *CurDecl = dyn_cast_or_null(CurContext)) return &II == CurDecl->getIdentifier(); else return false; } /// ActOnBaseSpecifier - Parsed a base specifier. A base specifier is /// one entry in the base class list of a class specifier, for /// example: /// class foo : public bar, virtual private baz { /// 'public bar' and 'virtual private baz' are each base-specifiers. Sema::BaseResult Sema::ActOnBaseSpecifier(DeclTy *classdecl, SourceRange SpecifierRange, bool Virtual, AccessSpecifier Access, TypeTy *basetype, SourceLocation BaseLoc) { RecordDecl *Decl = (RecordDecl*)classdecl; QualType BaseType = Context.getTypeDeclType((TypeDecl*)basetype); // Base specifiers must be record types. if (!BaseType->isRecordType()) { Diag(BaseLoc, diag::err_base_must_be_class, SpecifierRange); return true; } // C++ [class.union]p1: // A union shall not be used as a base class. if (BaseType->isUnionType()) { Diag(BaseLoc, diag::err_union_as_base_class, SpecifierRange); return true; } // C++ [class.union]p1: // A union shall not have base classes. if (Decl->isUnion()) { Diag(Decl->getLocation(), diag::err_base_clause_on_union, SpecifierRange); return true; } // C++ [class.derived]p2: // The class-name in a base-specifier shall not be an incompletely // defined class. if (BaseType->isIncompleteType()) { Diag(BaseLoc, diag::err_incomplete_base_class, SpecifierRange); return true; } // If the base class is polymorphic, the new one is, too. RecordDecl *BaseDecl = BaseType->getAsRecordType()->getDecl(); assert(BaseDecl && "Record type has no declaration"); BaseDecl = BaseDecl->getDefinition(Context); assert(BaseDecl && "Base type is not incomplete, but has no definition"); if (cast(BaseDecl)->isPolymorphic()) { cast(Decl)->setPolymorphic(true); } // Create the base specifier. return new CXXBaseSpecifier(SpecifierRange, Virtual, BaseType->isClassType(), Access, BaseType); } /// ActOnBaseSpecifiers - Attach the given base specifiers to the /// class, after checking whether there are any duplicate base /// classes. void Sema::ActOnBaseSpecifiers(DeclTy *ClassDecl, BaseTy **Bases, unsigned NumBases) { if (NumBases == 0) return; // Used to keep track of which base types we have already seen, so // that we can properly diagnose redundant direct base types. Note // that the key is always the unqualified canonical type of the base // class. std::map KnownBaseTypes; // Copy non-redundant base specifiers into permanent storage. CXXBaseSpecifier **BaseSpecs = (CXXBaseSpecifier **)Bases; unsigned NumGoodBases = 0; for (unsigned idx = 0; idx < NumBases; ++idx) { QualType NewBaseType = Context.getCanonicalType(BaseSpecs[idx]->getType()); NewBaseType = NewBaseType.getUnqualifiedType(); if (KnownBaseTypes[NewBaseType]) { // C++ [class.mi]p3: // A class shall not be specified as a direct base class of a // derived class more than once. Diag(BaseSpecs[idx]->getSourceRange().getBegin(), diag::err_duplicate_base_class, KnownBaseTypes[NewBaseType]->getType().getAsString(), BaseSpecs[idx]->getSourceRange()); // Delete the duplicate base class specifier; we're going to // overwrite its pointer later. delete BaseSpecs[idx]; } else { // Okay, add this new base class. KnownBaseTypes[NewBaseType] = BaseSpecs[idx]; BaseSpecs[NumGoodBases++] = BaseSpecs[idx]; } } // Attach the remaining base class specifiers to the derived class. CXXRecordDecl *Decl = (CXXRecordDecl*)ClassDecl; Decl->setBases(BaseSpecs, NumGoodBases); // Delete the remaining (good) base class specifiers, since their // data has been copied into the CXXRecordDecl. for (unsigned idx = 0; idx < NumGoodBases; ++idx) delete BaseSpecs[idx]; } //===----------------------------------------------------------------------===// // C++ class member Handling //===----------------------------------------------------------------------===// /// ActOnStartCXXClassDef - This is called at the start of a class/struct/union /// definition, when on C++. void Sema::ActOnStartCXXClassDef(Scope *S, DeclTy *D, SourceLocation LBrace) { CXXRecordDecl *Dcl = cast(static_cast(D)); PushDeclContext(Dcl); FieldCollector->StartClass(); if (Dcl->getIdentifier()) { // C++ [class]p2: // [...] The class-name is also inserted into the scope of the // class itself; this is known as the injected-class-name. For // purposes of access checking, the injected-class-name is treated // as if it were a public member name. // FIXME: this should probably have its own kind of type node. TypedefDecl *InjectedClassName = TypedefDecl::Create(Context, Dcl, LBrace, Dcl->getIdentifier(), Context.getTypeDeclType(Dcl), /*PrevDecl=*/0); PushOnScopeChains(InjectedClassName, S); } } /// ActOnCXXMemberDeclarator - This is invoked when a C++ class member /// declarator is parsed. 'AS' is the access specifier, 'BW' specifies the /// bitfield width if there is one and 'InitExpr' specifies the initializer if /// any. 'LastInGroup' is non-null for cases where one declspec has multiple /// declarators on it. /// /// NOTE: Because of CXXFieldDecl's inability to be chained like ScopedDecls, if /// an instance field is declared, a new CXXFieldDecl is created but the method /// does *not* return it; it returns LastInGroup instead. The other C++ members /// (which are all ScopedDecls) are returned after appending them to /// LastInGroup. Sema::DeclTy * Sema::ActOnCXXMemberDeclarator(Scope *S, AccessSpecifier AS, Declarator &D, ExprTy *BW, ExprTy *InitExpr, DeclTy *LastInGroup) { const DeclSpec &DS = D.getDeclSpec(); IdentifierInfo *II = D.getIdentifier(); Expr *BitWidth = static_cast(BW); Expr *Init = static_cast(InitExpr); SourceLocation Loc = D.getIdentifierLoc(); // C++ 9.2p6: A member shall not be declared to have automatic storage // duration (auto, register) or with the extern storage-class-specifier. switch (DS.getStorageClassSpec()) { case DeclSpec::SCS_unspecified: case DeclSpec::SCS_typedef: case DeclSpec::SCS_static: // FALL THROUGH. break; default: if (DS.getStorageClassSpecLoc().isValid()) Diag(DS.getStorageClassSpecLoc(), diag::err_storageclass_invalid_for_member); else Diag(DS.getThreadSpecLoc(), diag::err_storageclass_invalid_for_member); D.getMutableDeclSpec().ClearStorageClassSpecs(); } bool isFunc = D.isFunctionDeclarator(); if (!isFunc && D.getDeclSpec().getTypeSpecType() == DeclSpec::TST_typedef && D.getNumTypeObjects() == 0) { // Check also for this case: // // typedef int f(); // f a; // Decl *TD = static_cast(DS.getTypeRep()); isFunc = Context.getTypeDeclType(cast(TD))->isFunctionType(); } bool isInstField = (DS.getStorageClassSpec() == DeclSpec::SCS_unspecified && !isFunc); Decl *Member; bool InvalidDecl = false; if (isInstField) Member = static_cast(ActOnField(S, Loc, D, BitWidth)); else Member = static_cast(ActOnDeclarator(S, D, LastInGroup)); if (!Member) return LastInGroup; assert((II || isInstField) && "No identifier for non-field ?"); // set/getAccess is not part of Decl's interface to avoid bloating it with C++ // specific methods. Use a wrapper class that can be used with all C++ class // member decls. CXXClassMemberWrapper(Member).setAccess(AS); // C++ [dcl.init.aggr]p1: // An aggregate is an array or a class (clause 9) with [...] no // private or protected non-static data members (clause 11). if (isInstField && (AS == AS_private || AS == AS_protected)) cast(CurContext)->setAggregate(false); if (DS.isVirtualSpecified()) { if (!isFunc || DS.getStorageClassSpec() == DeclSpec::SCS_static) { Diag(DS.getVirtualSpecLoc(), diag::err_virtual_non_function); InvalidDecl = true; } else { CXXRecordDecl *CurClass = cast(CurContext); CurClass->setAggregate(false); CurClass->setPolymorphic(true); } } if (BitWidth) { // C++ 9.6p2: Only when declaring an unnamed bit-field may the // constant-expression be a value equal to zero. // FIXME: Check this. if (D.isFunctionDeclarator()) { // FIXME: Emit diagnostic about only constructors taking base initializers // or something similar, when constructor support is in place. Diag(Loc, diag::err_not_bitfield_type, II->getName(), BitWidth->getSourceRange()); InvalidDecl = true; } else if (isInstField) { // C++ 9.6p3: A bit-field shall have integral or enumeration type. if (!cast(Member)->getType()->isIntegralType()) { Diag(Loc, diag::err_not_integral_type_bitfield, II->getName(), BitWidth->getSourceRange()); InvalidDecl = true; } } else if (isa(Member)) { // A function typedef ("typedef int f(); f a;"). // C++ 9.6p3: A bit-field shall have integral or enumeration type. Diag(Loc, diag::err_not_integral_type_bitfield, II->getName(), BitWidth->getSourceRange()); InvalidDecl = true; } else if (isa(Member)) { // "cannot declare 'A' to be a bit-field type" Diag(Loc, diag::err_not_bitfield_type, II->getName(), BitWidth->getSourceRange()); InvalidDecl = true; } else { assert(isa(Member) && "Didn't we cover all member kinds?"); // C++ 9.6p3: A bit-field shall not be a static member. // "static member 'A' cannot be a bit-field" Diag(Loc, diag::err_static_not_bitfield, II->getName(), BitWidth->getSourceRange()); InvalidDecl = true; } } if (Init) { // C++ 9.2p4: A member-declarator can contain a constant-initializer only // if it declares a static member of const integral or const enumeration // type. if (CXXClassVarDecl *CVD = dyn_cast(Member)) { // ...static member of... CVD->setInit(Init); // ...const integral or const enumeration type. if (Context.getCanonicalType(CVD->getType()).isConstQualified() && CVD->getType()->isIntegralType()) { // constant-initializer if (CheckForConstantInitializer(Init, CVD->getType())) InvalidDecl = true; } else { // not const integral. Diag(Loc, diag::err_member_initialization, II->getName(), Init->getSourceRange()); InvalidDecl = true; } } else { // not static member. Diag(Loc, diag::err_member_initialization, II->getName(), Init->getSourceRange()); InvalidDecl = true; } } if (InvalidDecl) Member->setInvalidDecl(); if (isInstField) { FieldCollector->Add(cast(Member)); return LastInGroup; } return Member; } /// ActOnMemInitializer - Handle a C++ member initializer. Sema::MemInitResult Sema::ActOnMemInitializer(DeclTy *ConstructorD, Scope *S, IdentifierInfo *MemberOrBase, SourceLocation IdLoc, SourceLocation LParenLoc, ExprTy **Args, unsigned NumArgs, SourceLocation *CommaLocs, SourceLocation RParenLoc) { CXXConstructorDecl *Constructor = dyn_cast((Decl*)ConstructorD); if (!Constructor) { // The user wrote a constructor initializer on a function that is // not a C++ constructor. Ignore the error for now, because we may // have more member initializers coming; we'll diagnose it just // once in ActOnMemInitializers. return true; } CXXRecordDecl *ClassDecl = Constructor->getParent(); // C++ [class.base.init]p2: // Names in a mem-initializer-id are looked up in the scope of the // constructor’s class and, if not found in that scope, are looked // up in the scope containing the constructor’s // definition. [Note: if the constructor’s class contains a member // with the same name as a direct or virtual base class of the // class, a mem-initializer-id naming the member or base class and // composed of a single identifier refers to the class member. A // mem-initializer-id for the hidden base class may be specified // using a qualified name. ] // Look for a member, first. CXXFieldDecl *Member = ClassDecl->getMember(MemberOrBase); // FIXME: Handle members of an anonymous union. if (Member) { // FIXME: Perform direct initialization of the member. return new CXXBaseOrMemberInitializer(Member, (Expr **)Args, NumArgs); } // It didn't name a member, so see if it names a class. TypeTy *BaseTy = isTypeName(*MemberOrBase, S, 0/*SS*/); if (!BaseTy) return Diag(IdLoc, diag::err_mem_init_not_member_or_class, MemberOrBase->getName(), SourceRange(IdLoc, RParenLoc)); QualType BaseType = Context.getTypeDeclType((TypeDecl *)BaseTy); if (!BaseType->isRecordType()) return Diag(IdLoc, diag::err_base_init_does_not_name_class, BaseType.getAsString(), SourceRange(IdLoc, RParenLoc)); // C++ [class.base.init]p2: // [...] Unless the mem-initializer-id names a nonstatic data // member of the constructor’s class or a direct or virtual base // of that class, the mem-initializer is ill-formed. A // mem-initializer-list can initialize a base class using any // name that denotes that base class type. // First, check for a direct base class. const CXXBaseSpecifier *DirectBaseSpec = 0; for (CXXRecordDecl::base_class_const_iterator Base = ClassDecl->bases_begin(); Base != ClassDecl->bases_end(); ++Base) { if (Context.getCanonicalType(BaseType).getUnqualifiedType() == Context.getCanonicalType(Base->getType()).getUnqualifiedType()) { // We found a direct base of this type. That's what we're // initializing. DirectBaseSpec = &*Base; break; } } // Check for a virtual base class. // FIXME: We might be able to short-circuit this if we know in // advance that there are no virtual bases. const CXXBaseSpecifier *VirtualBaseSpec = 0; if (!DirectBaseSpec || !DirectBaseSpec->isVirtual()) { // We haven't found a base yet; search the class hierarchy for a // virtual base class. BasePaths Paths(/*FindAmbiguities=*/true, /*RecordPaths=*/true, /*DetectVirtual=*/false); if (IsDerivedFrom(Context.getTypeDeclType(ClassDecl), BaseType, Paths)) { for (BasePaths::paths_iterator Path = Paths.begin(); Path != Paths.end(); ++Path) { if (Path->back().Base->isVirtual()) { VirtualBaseSpec = Path->back().Base; break; } } } } // C++ [base.class.init]p2: // If a mem-initializer-id is ambiguous because it designates both // a direct non-virtual base class and an inherited virtual base // class, the mem-initializer is ill-formed. if (DirectBaseSpec && VirtualBaseSpec) return Diag(IdLoc, diag::err_base_init_direct_and_virtual, MemberOrBase->getName(), SourceRange(IdLoc, RParenLoc)); return new CXXBaseOrMemberInitializer(BaseType, (Expr **)Args, NumArgs); } void Sema::ActOnFinishCXXMemberSpecification(Scope* S, SourceLocation RLoc, DeclTy *TagDecl, SourceLocation LBrac, SourceLocation RBrac) { ActOnFields(S, RLoc, TagDecl, (DeclTy**)FieldCollector->getCurFields(), FieldCollector->getCurNumFields(), LBrac, RBrac, 0); } /// AddImplicitlyDeclaredMembersToClass - Adds any implicitly-declared /// special functions, such as the default constructor, copy /// constructor, or destructor, to the given C++ class (C++ /// [special]p1). This routine can only be executed just before the /// definition of the class is complete. void Sema::AddImplicitlyDeclaredMembersToClass(CXXRecordDecl *ClassDecl) { if (!ClassDecl->hasUserDeclaredConstructor()) { // C++ [class.ctor]p5: // A default constructor for a class X is a constructor of class X // that can be called without an argument. If there is no // user-declared constructor for class X, a default constructor is // implicitly declared. An implicitly-declared default constructor // is an inline public member of its class. CXXConstructorDecl *DefaultCon = CXXConstructorDecl::Create(Context, ClassDecl, ClassDecl->getLocation(), ClassDecl->getIdentifier(), Context.getFunctionType(Context.VoidTy, 0, 0, false, 0), /*isExplicit=*/false, /*isInline=*/true, /*isImplicitlyDeclared=*/true); DefaultCon->setAccess(AS_public); ClassDecl->addConstructor(Context, DefaultCon); } if (!ClassDecl->hasUserDeclaredCopyConstructor()) { // C++ [class.copy]p4: // If the class definition does not explicitly declare a copy // constructor, one is declared implicitly. // C++ [class.copy]p5: // The implicitly-declared copy constructor for a class X will // have the form // // X::X(const X&) // // if bool HasConstCopyConstructor = true; // -- each direct or virtual base class B of X has a copy // constructor whose first parameter is of type const B& or // const volatile B&, and for (CXXRecordDecl::base_class_iterator Base = ClassDecl->bases_begin(); HasConstCopyConstructor && Base != ClassDecl->bases_end(); ++Base) { const CXXRecordDecl *BaseClassDecl = cast(Base->getType()->getAsRecordType()->getDecl()); HasConstCopyConstructor = BaseClassDecl->hasConstCopyConstructor(Context); } // -- for all the nonstatic data members of X that are of a // class type M (or array thereof), each such class type // has a copy constructor whose first parameter is of type // const M& or const volatile M&. for (CXXRecordDecl::field_iterator Field = ClassDecl->field_begin(); HasConstCopyConstructor && Field != ClassDecl->field_end(); ++Field) { QualType FieldType = (*Field)->getType(); if (const ArrayType *Array = Context.getAsArrayType(FieldType)) FieldType = Array->getElementType(); if (const RecordType *FieldClassType = FieldType->getAsRecordType()) { const CXXRecordDecl *FieldClassDecl = cast(FieldClassType->getDecl()); HasConstCopyConstructor = FieldClassDecl->hasConstCopyConstructor(Context); } } // Otherwise, the implicitly declared copy constructor will have // the form // // X::X(X&) QualType ArgType = Context.getTypeDeclType(ClassDecl); if (HasConstCopyConstructor) ArgType = ArgType.withConst(); ArgType = Context.getReferenceType(ArgType); // An implicitly-declared copy constructor is an inline public // member of its class. CXXConstructorDecl *CopyConstructor = CXXConstructorDecl::Create(Context, ClassDecl, ClassDecl->getLocation(), ClassDecl->getIdentifier(), Context.getFunctionType(Context.VoidTy, &ArgType, 1, false, 0), /*isExplicit=*/false, /*isInline=*/true, /*isImplicitlyDeclared=*/true); CopyConstructor->setAccess(AS_public); // Add the parameter to the constructor. ParmVarDecl *FromParam = ParmVarDecl::Create(Context, CopyConstructor, ClassDecl->getLocation(), /*IdentifierInfo=*/0, ArgType, VarDecl::None, 0, 0); CopyConstructor->setParams(&FromParam, 1); ClassDecl->addConstructor(Context, CopyConstructor); } if (!ClassDecl->getDestructor()) { // C++ [class.dtor]p2: // If a class has no user-declared destructor, a destructor is // declared implicitly. An implicitly-declared destructor is an // inline public member of its class. std::string DestructorName = "~"; DestructorName += ClassDecl->getName(); CXXDestructorDecl *Destructor = CXXDestructorDecl::Create(Context, ClassDecl, ClassDecl->getLocation(), &PP.getIdentifierTable().get(DestructorName), Context.getFunctionType(Context.VoidTy, 0, 0, false, 0), /*isInline=*/true, /*isImplicitlyDeclared=*/true); Destructor->setAccess(AS_public); ClassDecl->setDestructor(Destructor); } // FIXME: Implicit copy assignment operator } void Sema::ActOnFinishCXXClassDef(DeclTy *D) { CXXRecordDecl *Rec = cast(static_cast(D)); FieldCollector->FinishClass(); AddImplicitlyDeclaredMembersToClass(Rec); PopDeclContext(); // Everything, including inline method definitions, have been parsed. // Let the consumer know of the new TagDecl definition. Consumer.HandleTagDeclDefinition(Rec); } /// CheckConstructorDeclarator - Called by ActOnDeclarator to check /// the well-formednes of the constructor declarator @p D with type @p /// R. If there are any errors in the declarator, this routine will /// emit diagnostics and return true. Otherwise, it will return /// false. Either way, the type @p R will be updated to reflect a /// well-formed type for the constructor. bool Sema::CheckConstructorDeclarator(Declarator &D, QualType &R, FunctionDecl::StorageClass& SC) { bool isVirtual = D.getDeclSpec().isVirtualSpecified(); bool isInvalid = false; // C++ [class.ctor]p3: // A constructor shall not be virtual (10.3) or static (9.4). A // constructor can be invoked for a const, volatile or const // volatile object. A constructor shall not be declared const, // volatile, or const volatile (9.3.2). if (isVirtual) { Diag(D.getIdentifierLoc(), diag::err_constructor_cannot_be, "virtual", SourceRange(D.getDeclSpec().getVirtualSpecLoc()), SourceRange(D.getIdentifierLoc())); isInvalid = true; } if (SC == FunctionDecl::Static) { Diag(D.getIdentifierLoc(), diag::err_constructor_cannot_be, "static", SourceRange(D.getDeclSpec().getStorageClassSpecLoc()), SourceRange(D.getIdentifierLoc())); isInvalid = true; SC = FunctionDecl::None; } if (D.getDeclSpec().hasTypeSpecifier()) { // Constructors don't have return types, but the parser will // happily parse something like: // // class X { // float X(float); // }; // // The return type will be eliminated later. Diag(D.getIdentifierLoc(), diag::err_constructor_return_type, SourceRange(D.getDeclSpec().getTypeSpecTypeLoc()), SourceRange(D.getIdentifierLoc())); } if (R->getAsFunctionTypeProto()->getTypeQuals() != 0) { DeclaratorChunk::FunctionTypeInfo &FTI = D.getTypeObject(0).Fun; if (FTI.TypeQuals & QualType::Const) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_constructor, "const", SourceRange(D.getIdentifierLoc())); if (FTI.TypeQuals & QualType::Volatile) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_constructor, "volatile", SourceRange(D.getIdentifierLoc())); if (FTI.TypeQuals & QualType::Restrict) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_constructor, "restrict", SourceRange(D.getIdentifierLoc())); } // Rebuild the function type "R" without any type qualifiers (in // case any of the errors above fired) and with "void" as the // return type, since constructors don't have return types. We // *always* have to do this, because GetTypeForDeclarator will // put in a result type of "int" when none was specified. const FunctionTypeProto *Proto = R->getAsFunctionTypeProto(); R = Context.getFunctionType(Context.VoidTy, Proto->arg_type_begin(), Proto->getNumArgs(), Proto->isVariadic(), 0); return isInvalid; } /// CheckDestructorDeclarator - Called by ActOnDeclarator to check /// the well-formednes of the destructor declarator @p D with type @p /// R. If there are any errors in the declarator, this routine will /// emit diagnostics and return true. Otherwise, it will return /// false. Either way, the type @p R will be updated to reflect a /// well-formed type for the destructor. bool Sema::CheckDestructorDeclarator(Declarator &D, QualType &R, FunctionDecl::StorageClass& SC) { bool isInvalid = false; // C++ [class.dtor]p1: // [...] A typedef-name that names a class is a class-name // (7.1.3); however, a typedef-name that names a class shall not // be used as the identifier in the declarator for a destructor // declaration. TypeDecl *DeclaratorTypeD = (TypeDecl *)D.getDeclaratorIdType(); if (const TypedefDecl *TypedefD = dyn_cast(DeclaratorTypeD)) { if (TypedefD->getIdentifier() != cast(CurContext)->getIdentifier()) { // FIXME: This would be easier if we could just look at whether // we found the injected-class-name. Diag(D.getIdentifierLoc(), diag::err_destructor_typedef_name, TypedefD->getName()); isInvalid = true; } } // C++ [class.dtor]p2: // A destructor is used to destroy objects of its class type. A // destructor takes no parameters, and no return type can be // specified for it (not even void). The address of a destructor // shall not be taken. A destructor shall not be static. A // destructor can be invoked for a const, volatile or const // volatile object. A destructor shall not be declared const, // volatile or const volatile (9.3.2). if (SC == FunctionDecl::Static) { Diag(D.getIdentifierLoc(), diag::err_destructor_cannot_be, "static", SourceRange(D.getDeclSpec().getStorageClassSpecLoc()), SourceRange(D.getIdentifierLoc())); isInvalid = true; SC = FunctionDecl::None; } if (D.getDeclSpec().hasTypeSpecifier()) { // Destructors don't have return types, but the parser will // happily parse something like: // // class X { // float ~X(); // }; // // The return type will be eliminated later. Diag(D.getIdentifierLoc(), diag::err_destructor_return_type, SourceRange(D.getDeclSpec().getTypeSpecTypeLoc()), SourceRange(D.getIdentifierLoc())); } if (R->getAsFunctionTypeProto()->getTypeQuals() != 0) { DeclaratorChunk::FunctionTypeInfo &FTI = D.getTypeObject(0).Fun; if (FTI.TypeQuals & QualType::Const) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_destructor, "const", SourceRange(D.getIdentifierLoc())); if (FTI.TypeQuals & QualType::Volatile) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_destructor, "volatile", SourceRange(D.getIdentifierLoc())); if (FTI.TypeQuals & QualType::Restrict) Diag(D.getIdentifierLoc(), diag::err_invalid_qualified_destructor, "restrict", SourceRange(D.getIdentifierLoc())); } // Make sure we don't have any parameters. if (R->getAsFunctionTypeProto()->getNumArgs() > 0) { Diag(D.getIdentifierLoc(), diag::err_destructor_with_params); // Delete the parameters. DeclaratorChunk::FunctionTypeInfo &FTI = D.getTypeObject(0).Fun; if (FTI.NumArgs) { delete [] FTI.ArgInfo; FTI.NumArgs = 0; FTI.ArgInfo = 0; } } // Make sure the destructor isn't variadic. if (R->getAsFunctionTypeProto()->isVariadic()) Diag(D.getIdentifierLoc(), diag::err_destructor_variadic); // Rebuild the function type "R" without any type qualifiers or // parameters (in case any of the errors above fired) and with // "void" as the return type, since destructors don't have return // types. We *always* have to do this, because GetTypeForDeclarator // will put in a result type of "int" when none was specified. R = Context.getFunctionType(Context.VoidTy, 0, 0, false, 0); return isInvalid; } /// CheckConversionDeclarator - Called by ActOnDeclarator to check the /// well-formednes of the conversion function declarator @p D with /// type @p R. If there are any errors in the declarator, this routine /// will emit diagnostics and return true. Otherwise, it will return /// false. Either way, the type @p R will be updated to reflect a /// well-formed type for the conversion operator. bool Sema::CheckConversionDeclarator(Declarator &D, QualType &R, FunctionDecl::StorageClass& SC) { bool isInvalid = false; // C++ [class.conv.fct]p1: // Neither parameter types nor return type can be specified. The // type of a conversion function (8.3.5) is “function taking no // parameter returning conversion-type-id.” if (SC == FunctionDecl::Static) { Diag(D.getIdentifierLoc(), diag::err_conv_function_not_member, "static", SourceRange(D.getDeclSpec().getStorageClassSpecLoc()), SourceRange(D.getIdentifierLoc())); isInvalid = true; SC = FunctionDecl::None; } if (D.getDeclSpec().hasTypeSpecifier()) { // Conversion functions don't have return types, but the parser will // happily parse something like: // // class X { // float operator bool(); // }; // // The return type will be changed later anyway. Diag(D.getIdentifierLoc(), diag::err_conv_function_return_type, SourceRange(D.getDeclSpec().getTypeSpecTypeLoc()), SourceRange(D.getIdentifierLoc())); } // Make sure we don't have any parameters. if (R->getAsFunctionTypeProto()->getNumArgs() > 0) { Diag(D.getIdentifierLoc(), diag::err_conv_function_with_params); // Delete the parameters. DeclaratorChunk::FunctionTypeInfo &FTI = D.getTypeObject(0).Fun; if (FTI.NumArgs) { delete [] FTI.ArgInfo; FTI.NumArgs = 0; FTI.ArgInfo = 0; } } // Make sure the conversion function isn't variadic. if (R->getAsFunctionTypeProto()->isVariadic()) Diag(D.getIdentifierLoc(), diag::err_conv_function_variadic); // C++ [class.conv.fct]p4: // The conversion-type-id shall not represent a function type nor // an array type. QualType ConvType = QualType::getFromOpaquePtr(D.getDeclaratorIdType()); if (ConvType->isArrayType()) { Diag(D.getIdentifierLoc(), diag::err_conv_function_to_array); ConvType = Context.getPointerType(ConvType); } else if (ConvType->isFunctionType()) { Diag(D.getIdentifierLoc(), diag::err_conv_function_to_function); ConvType = Context.getPointerType(ConvType); } // Rebuild the function type "R" without any parameters (in case any // of the errors above fired) and with the conversion type as the // return type. R = Context.getFunctionType(ConvType, 0, 0, false, R->getAsFunctionTypeProto()->getTypeQuals()); return isInvalid; } /// ActOnConstructorDeclarator - Called by ActOnDeclarator to complete /// the declaration of the given C++ constructor ConDecl that was /// built from declarator D. This routine is responsible for checking /// that the newly-created constructor declaration is well-formed and /// for recording it in the C++ class. Example: /// /// @code /// class X { /// X(); // X::X() will be the ConDecl. /// }; /// @endcode Sema::DeclTy *Sema::ActOnConstructorDeclarator(CXXConstructorDecl *ConDecl) { assert(ConDecl && "Expected to receive a constructor declaration"); // Check default arguments on the constructor CheckCXXDefaultArguments(ConDecl); CXXRecordDecl *ClassDecl = dyn_cast_or_null(CurContext); if (!ClassDecl) { ConDecl->setInvalidDecl(); return ConDecl; } // Make sure this constructor is an overload of the existing // constructors. OverloadedFunctionDecl::function_iterator MatchedDecl; if (!IsOverload(ConDecl, ClassDecl->getConstructors(), MatchedDecl)) { Diag(ConDecl->getLocation(), diag::err_constructor_redeclared, SourceRange(ConDecl->getLocation())); Diag((*MatchedDecl)->getLocation(), diag::err_previous_declaration, SourceRange((*MatchedDecl)->getLocation())); ConDecl->setInvalidDecl(); return ConDecl; } // C++ [class.copy]p3: // A declaration of a constructor for a class X is ill-formed if // its first parameter is of type (optionally cv-qualified) X and // either there are no other parameters or else all other // parameters have default arguments. if ((ConDecl->getNumParams() == 1) || (ConDecl->getNumParams() > 1 && ConDecl->getParamDecl(1)->getDefaultArg() != 0)) { QualType ParamType = ConDecl->getParamDecl(0)->getType(); QualType ClassTy = Context.getTagDeclType( const_cast(ConDecl->getParent())); if (Context.getCanonicalType(ParamType).getUnqualifiedType() == ClassTy) { Diag(ConDecl->getLocation(), diag::err_constructor_byvalue_arg, SourceRange(ConDecl->getParamDecl(0)->getLocation())); ConDecl->setInvalidDecl(); return ConDecl; } } // Add this constructor to the set of constructors of the current // class. ClassDecl->addConstructor(Context, ConDecl); return (DeclTy *)ConDecl; } /// ActOnDestructorDeclarator - Called by ActOnDeclarator to complete /// the declaration of the given C++ @p Destructor. This routine is /// responsible for recording the destructor in the C++ class, if /// possible. Sema::DeclTy *Sema::ActOnDestructorDeclarator(CXXDestructorDecl *Destructor) { assert(Destructor && "Expected to receive a destructor declaration"); CXXRecordDecl *ClassDecl = cast(CurContext); // Make sure we aren't redeclaring the destructor. if (CXXDestructorDecl *PrevDestructor = ClassDecl->getDestructor()) { Diag(Destructor->getLocation(), diag::err_destructor_redeclared); Diag(PrevDestructor->getLocation(), PrevDestructor->isThisDeclarationADefinition()? diag::err_previous_definition : diag::err_previous_declaration); Destructor->setInvalidDecl(); return Destructor; } ClassDecl->setDestructor(Destructor); return (DeclTy *)Destructor; } /// ActOnConversionDeclarator - Called by ActOnDeclarator to complete /// the declaration of the given C++ conversion function. This routine /// is responsible for recording the conversion function in the C++ /// class, if possible. Sema::DeclTy *Sema::ActOnConversionDeclarator(CXXConversionDecl *Conversion) { assert(Conversion && "Expected to receive a conversion function declaration"); CXXRecordDecl *ClassDecl = cast(CurContext); // Make sure we aren't redeclaring the conversion function. QualType ConvType = Context.getCanonicalType(Conversion->getConversionType()); OverloadedFunctionDecl *Conversions = ClassDecl->getConversionFunctions(); for (OverloadedFunctionDecl::function_iterator Func = Conversions->function_begin(); Func != Conversions->function_end(); ++Func) { CXXConversionDecl *OtherConv = cast(*Func); if (ConvType == Context.getCanonicalType(OtherConv->getConversionType())) { Diag(Conversion->getLocation(), diag::err_conv_function_redeclared); Diag(OtherConv->getLocation(), OtherConv->isThisDeclarationADefinition()? diag::err_previous_definition : diag::err_previous_declaration); Conversion->setInvalidDecl(); return (DeclTy *)Conversion; } } // C++ [class.conv.fct]p1: // [...] A conversion function is never used to convert a // (possibly cv-qualified) object to the (possibly cv-qualified) // same object type (or a reference to it), to a (possibly // cv-qualified) base class of that type (or a reference to it), // or to (possibly cv-qualified) void. // FIXME: Suppress this warning if the conversion function ends up // being a virtual function that overrides a virtual function in a // base class. QualType ClassType = Context.getCanonicalType(Context.getTypeDeclType(ClassDecl)); if (const ReferenceType *ConvTypeRef = ConvType->getAsReferenceType()) ConvType = ConvTypeRef->getPointeeType(); if (ConvType->isRecordType()) { ConvType = Context.getCanonicalType(ConvType).getUnqualifiedType(); if (ConvType == ClassType) Diag(Conversion->getLocation(), diag::warn_conv_to_self_not_used, ClassType.getAsString()); else if (IsDerivedFrom(ClassType, ConvType)) Diag(Conversion->getLocation(), diag::warn_conv_to_base_not_used, ClassType.getAsString(), ConvType.getAsString()); } else if (ConvType->isVoidType()) { Diag(Conversion->getLocation(), diag::warn_conv_to_void_not_used, ClassType.getAsString(), ConvType.getAsString()); } ClassDecl->addConversionFunction(Context, Conversion); return (DeclTy *)Conversion; } //===----------------------------------------------------------------------===// // Namespace Handling //===----------------------------------------------------------------------===// /// ActOnStartNamespaceDef - This is called at the start of a namespace /// definition. Sema::DeclTy *Sema::ActOnStartNamespaceDef(Scope *NamespcScope, SourceLocation IdentLoc, IdentifierInfo *II, SourceLocation LBrace) { NamespaceDecl *Namespc = NamespaceDecl::Create(Context, CurContext, IdentLoc, II); Namespc->setLBracLoc(LBrace); Scope *DeclRegionScope = NamespcScope->getParent(); if (II) { // C++ [namespace.def]p2: // The identifier in an original-namespace-definition shall not have been // previously defined in the declarative region in which the // original-namespace-definition appears. The identifier in an // original-namespace-definition is the name of the namespace. Subsequently // in that declarative region, it is treated as an original-namespace-name. Decl *PrevDecl = LookupDecl(II, Decl::IDNS_Tag | Decl::IDNS_Ordinary, DeclRegionScope, /*enableLazyBuiltinCreation=*/false); if (PrevDecl && isDeclInScope(PrevDecl, CurContext, DeclRegionScope)) { if (NamespaceDecl *OrigNS = dyn_cast(PrevDecl)) { // This is an extended namespace definition. // Attach this namespace decl to the chain of extended namespace // definitions. NamespaceDecl *NextNS = OrigNS; while (NextNS->getNextNamespace()) NextNS = NextNS->getNextNamespace(); NextNS->setNextNamespace(Namespc); Namespc->setOriginalNamespace(OrigNS); // We won't add this decl to the current scope. We want the namespace // name to return the original namespace decl during a name lookup. } else { // This is an invalid name redefinition. Diag(Namespc->getLocation(), diag::err_redefinition_different_kind, Namespc->getName()); Diag(PrevDecl->getLocation(), diag::err_previous_definition); Namespc->setInvalidDecl(); // Continue on to push Namespc as current DeclContext and return it. } } else { // This namespace name is declared for the first time. PushOnScopeChains(Namespc, DeclRegionScope); } } else { // FIXME: Handle anonymous namespaces } // Although we could have an invalid decl (i.e. the namespace name is a // redefinition), push it as current DeclContext and try to continue parsing. PushDeclContext(Namespc->getOriginalNamespace()); return Namespc; } /// ActOnFinishNamespaceDef - This callback is called after a namespace is /// exited. Decl is the DeclTy returned by ActOnStartNamespaceDef. void Sema::ActOnFinishNamespaceDef(DeclTy *D, SourceLocation RBrace) { Decl *Dcl = static_cast(D); NamespaceDecl *Namespc = dyn_cast_or_null(Dcl); assert(Namespc && "Invalid parameter, expected NamespaceDecl"); Namespc->setRBracLoc(RBrace); PopDeclContext(); } /// AddCXXDirectInitializerToDecl - This action is called immediately after /// ActOnDeclarator, when a C++ direct initializer is present. /// e.g: "int x(1);" void Sema::AddCXXDirectInitializerToDecl(DeclTy *Dcl, SourceLocation LParenLoc, ExprTy **ExprTys, unsigned NumExprs, SourceLocation *CommaLocs, SourceLocation RParenLoc) { assert(NumExprs != 0 && ExprTys && "missing expressions"); Decl *RealDecl = static_cast(Dcl); // If there is no declaration, there was an error parsing it. Just ignore // the initializer. if (RealDecl == 0) { for (unsigned i = 0; i != NumExprs; ++i) delete static_cast(ExprTys[i]); return; } VarDecl *VDecl = dyn_cast(RealDecl); if (!VDecl) { Diag(RealDecl->getLocation(), diag::err_illegal_initializer); RealDecl->setInvalidDecl(); return; } // We will treat direct-initialization as a copy-initialization: // int x(1); -as-> int x = 1; // ClassType x(a,b,c); -as-> ClassType x = ClassType(a,b,c); // // Clients that want to distinguish between the two forms, can check for // direct initializer using VarDecl::hasCXXDirectInitializer(). // A major benefit is that clients that don't particularly care about which // exactly form was it (like the CodeGen) can handle both cases without // special case code. // C++ 8.5p11: // The form of initialization (using parentheses or '=') is generally // insignificant, but does matter when the entity being initialized has a // class type. QualType DeclInitType = VDecl->getType(); if (const ArrayType *Array = Context.getAsArrayType(DeclInitType)) DeclInitType = Array->getElementType(); if (VDecl->getType()->isRecordType()) { CXXConstructorDecl *Constructor = PerformInitializationByConstructor(DeclInitType, (Expr **)ExprTys, NumExprs, VDecl->getLocation(), SourceRange(VDecl->getLocation(), RParenLoc), VDecl->getName(), IK_Direct); if (!Constructor) { RealDecl->setInvalidDecl(); } // Let clients know that initialization was done with a direct // initializer. VDecl->setCXXDirectInitializer(true); // FIXME: Add ExprTys and Constructor to the RealDecl as part of // the initializer. return; } if (NumExprs > 1) { Diag(CommaLocs[0], diag::err_builtin_direct_init_more_than_one_arg, SourceRange(VDecl->getLocation(), RParenLoc)); RealDecl->setInvalidDecl(); return; } // Let clients know that initialization was done with a direct initializer. VDecl->setCXXDirectInitializer(true); assert(NumExprs == 1 && "Expected 1 expression"); // Set the init expression, handles conversions. AddInitializerToDecl(Dcl, ExprTys[0]); } /// PerformInitializationByConstructor - Perform initialization by /// constructor (C++ [dcl.init]p14), which may occur as part of /// direct-initialization or copy-initialization. We are initializing /// an object of type @p ClassType with the given arguments @p /// Args. @p Loc is the location in the source code where the /// initializer occurs (e.g., a declaration, member initializer, /// functional cast, etc.) while @p Range covers the whole /// initialization. @p InitEntity is the entity being initialized, /// which may by the name of a declaration or a type. @p Kind is the /// kind of initialization we're performing, which affects whether /// explicit constructors will be considered. When successful, returns /// the constructor that will be used to perform the initialization; /// when the initialization fails, emits a diagnostic and returns /// null. CXXConstructorDecl * Sema::PerformInitializationByConstructor(QualType ClassType, Expr **Args, unsigned NumArgs, SourceLocation Loc, SourceRange Range, std::string InitEntity, InitializationKind Kind) { const RecordType *ClassRec = ClassType->getAsRecordType(); assert(ClassRec && "Can only initialize a class type here"); // C++ [dcl.init]p14: // // If the initialization is direct-initialization, or if it is // copy-initialization where the cv-unqualified version of the // source type is the same class as, or a derived class of, the // class of the destination, constructors are considered. The // applicable constructors are enumerated (13.3.1.3), and the // best one is chosen through overload resolution (13.3). The // constructor so selected is called to initialize the object, // with the initializer expression(s) as its argument(s). If no // constructor applies, or the overload resolution is ambiguous, // the initialization is ill-formed. const CXXRecordDecl *ClassDecl = cast(ClassRec->getDecl()); OverloadCandidateSet CandidateSet; // Add constructors to the overload set. OverloadedFunctionDecl *Constructors = const_cast(ClassDecl->getConstructors()); for (OverloadedFunctionDecl::function_iterator Con = Constructors->function_begin(); Con != Constructors->function_end(); ++Con) { CXXConstructorDecl *Constructor = cast(*Con); if ((Kind == IK_Direct) || (Kind == IK_Copy && Constructor->isConvertingConstructor()) || (Kind == IK_Default && Constructor->isDefaultConstructor())) AddOverloadCandidate(Constructor, Args, NumArgs, CandidateSet); } OverloadCandidateSet::iterator Best; switch (BestViableFunction(CandidateSet, Best)) { case OR_Success: // We found a constructor. Return it. return cast(Best->Function); case OR_No_Viable_Function: if (CandidateSet.empty()) Diag(Loc, diag::err_ovl_no_viable_function_in_init, InitEntity, Range); else { Diag(Loc, diag::err_ovl_no_viable_function_in_init_with_cands, InitEntity, Range); PrintOverloadCandidates(CandidateSet, /*OnlyViable=*/false); } return 0; case OR_Ambiguous: Diag(Loc, diag::err_ovl_ambiguous_init, InitEntity, Range); PrintOverloadCandidates(CandidateSet, /*OnlyViable=*/true); return 0; } return 0; } /// CompareReferenceRelationship - Compare the two types T1 and T2 to /// determine whether they are reference-related, /// reference-compatible, reference-compatible with added /// qualification, or incompatible, for use in C++ initialization by /// reference (C++ [dcl.ref.init]p4). Neither type can be a reference /// type, and the first type (T1) is the pointee type of the reference /// type being initialized. Sema::ReferenceCompareResult Sema::CompareReferenceRelationship(QualType T1, QualType T2, bool& DerivedToBase) { assert(!T1->isReferenceType() && "T1 must be the pointee type of the reference type"); assert(!T2->isReferenceType() && "T2 cannot be a reference type"); T1 = Context.getCanonicalType(T1); T2 = Context.getCanonicalType(T2); QualType UnqualT1 = T1.getUnqualifiedType(); QualType UnqualT2 = T2.getUnqualifiedType(); // C++ [dcl.init.ref]p4: // Given types “cv1 T1” and “cv2 T2,” “cv1 T1” is // reference-related to “cv2 T2” if T1 is the same type as T2, or // T1 is a base class of T2. if (UnqualT1 == UnqualT2) DerivedToBase = false; else if (IsDerivedFrom(UnqualT2, UnqualT1)) DerivedToBase = true; else return Ref_Incompatible; // At this point, we know that T1 and T2 are reference-related (at // least). // C++ [dcl.init.ref]p4: // "cv1 T1” is reference-compatible with “cv2 T2” if T1 is // reference-related to T2 and cv1 is the same cv-qualification // as, or greater cv-qualification than, cv2. For purposes of // overload resolution, cases for which cv1 is greater // cv-qualification than cv2 are identified as // reference-compatible with added qualification (see 13.3.3.2). if (T1.getCVRQualifiers() == T2.getCVRQualifiers()) return Ref_Compatible; else if (T1.isMoreQualifiedThan(T2)) return Ref_Compatible_With_Added_Qualification; else return Ref_Related; } /// CheckReferenceInit - Check the initialization of a reference /// variable with the given initializer (C++ [dcl.init.ref]). Init is /// the initializer (either a simple initializer or an initializer /// list), and DeclType is the type of the declaration. When ICS is /// non-null, this routine will compute the implicit conversion /// sequence according to C++ [over.ics.ref] and will not produce any /// diagnostics; when ICS is null, it will emit diagnostics when any /// errors are found. Either way, a return value of true indicates /// that there was a failure, a return value of false indicates that /// the reference initialization succeeded. /// /// When @p SuppressUserConversions, user-defined conversions are /// suppressed. bool Sema::CheckReferenceInit(Expr *&Init, QualType &DeclType, ImplicitConversionSequence *ICS, bool SuppressUserConversions) { assert(DeclType->isReferenceType() && "Reference init needs a reference"); QualType T1 = DeclType->getAsReferenceType()->getPointeeType(); QualType T2 = Init->getType(); // Compute some basic properties of the types and the initializer. bool DerivedToBase = false; Expr::isLvalueResult InitLvalue = Init->isLvalue(Context); ReferenceCompareResult RefRelationship = CompareReferenceRelationship(T1, T2, DerivedToBase); // Most paths end in a failed conversion. if (ICS) ICS->ConversionKind = ImplicitConversionSequence::BadConversion; // C++ [dcl.init.ref]p5: // A reference to type “cv1 T1” is initialized by an expression // of type “cv2 T2” as follows: // -- If the initializer expression bool BindsDirectly = false; // -- is an lvalue (but is not a bit-field), and “cv1 T1” is // reference-compatible with “cv2 T2,” or // // Note that the bit-field check is skipped if we are just computing // the implicit conversion sequence (C++ [over.best.ics]p2). if (InitLvalue == Expr::LV_Valid && (ICS || !Init->isBitField()) && RefRelationship >= Ref_Compatible_With_Added_Qualification) { BindsDirectly = true; if (ICS) { // C++ [over.ics.ref]p1: // When a parameter of reference type binds directly (8.5.3) // to an argument expression, the implicit conversion sequence // is the identity conversion, unless the argument expression // has a type that is a derived class of the parameter type, // in which case the implicit conversion sequence is a // derived-to-base Conversion (13.3.3.1). ICS->ConversionKind = ImplicitConversionSequence::StandardConversion; ICS->Standard.First = ICK_Identity; ICS->Standard.Second = DerivedToBase? ICK_Derived_To_Base : ICK_Identity; ICS->Standard.Third = ICK_Identity; ICS->Standard.FromTypePtr = T2.getAsOpaquePtr(); ICS->Standard.ToTypePtr = T1.getAsOpaquePtr(); ICS->Standard.ReferenceBinding = true; ICS->Standard.DirectBinding = true; // Nothing more to do: the inaccessibility/ambiguity check for // derived-to-base conversions is suppressed when we're // computing the implicit conversion sequence (C++ // [over.best.ics]p2). return false; } else { // Perform the conversion. // FIXME: Binding to a subobject of the lvalue is going to require // more AST annotation than this. ImpCastExprToType(Init, T1); } } // -- has a class type (i.e., T2 is a class type) and can be // implicitly converted to an lvalue of type “cv3 T3,” // where “cv1 T1” is reference-compatible with “cv3 T3” // 92) (this conversion is selected by enumerating the // applicable conversion functions (13.3.1.6) and choosing // the best one through overload resolution (13.3)), // FIXME: Implement this second bullet, once we have conversion // functions. Also remember C++ [over.ics.ref]p1, second part. if (BindsDirectly) { // C++ [dcl.init.ref]p4: // [...] In all cases where the reference-related or // reference-compatible relationship of two types is used to // establish the validity of a reference binding, and T1 is a // base class of T2, a program that necessitates such a binding // is ill-formed if T1 is an inaccessible (clause 11) or // ambiguous (10.2) base class of T2. // // Note that we only check this condition when we're allowed to // complain about errors, because we should not be checking for // ambiguity (or inaccessibility) unless the reference binding // actually happens. if (DerivedToBase) return CheckDerivedToBaseConversion(T2, T1, Init->getSourceRange().getBegin(), Init->getSourceRange()); else return false; } // -- Otherwise, the reference shall be to a non-volatile const // type (i.e., cv1 shall be const). if (T1.getCVRQualifiers() != QualType::Const) { if (!ICS) Diag(Init->getSourceRange().getBegin(), diag::err_not_reference_to_const_init, T1.getAsString(), InitLvalue != Expr::LV_Valid? "temporary" : "value", T2.getAsString(), Init->getSourceRange()); return true; } // -- If the initializer expression is an rvalue, with T2 a // class type, and “cv1 T1” is reference-compatible with // “cv2 T2,” the reference is bound in one of the // following ways (the choice is implementation-defined): // // -- The reference is bound to the object represented by // the rvalue (see 3.10) or to a sub-object within that // object. // // -- A temporary of type “cv1 T2” [sic] is created, and // a constructor is called to copy the entire rvalue // object into the temporary. The reference is bound to // the temporary or to a sub-object within the // temporary. // // // The constructor that would be used to make the copy // shall be callable whether or not the copy is actually // done. // // Note that C++0x [dcl.ref.init]p5 takes away this implementation // freedom, so we will always take the first option and never build // a temporary in this case. FIXME: We will, however, have to check // for the presence of a copy constructor in C++98/03 mode. if (InitLvalue != Expr::LV_Valid && T2->isRecordType() && RefRelationship >= Ref_Compatible_With_Added_Qualification) { if (ICS) { ICS->ConversionKind = ImplicitConversionSequence::StandardConversion; ICS->Standard.First = ICK_Identity; ICS->Standard.Second = DerivedToBase? ICK_Derived_To_Base : ICK_Identity; ICS->Standard.Third = ICK_Identity; ICS->Standard.FromTypePtr = T2.getAsOpaquePtr(); ICS->Standard.ToTypePtr = T1.getAsOpaquePtr(); ICS->Standard.ReferenceBinding = true; ICS->Standard.DirectBinding = false; } else { // FIXME: Binding to a subobject of the rvalue is going to require // more AST annotation than this. ImpCastExprToType(Init, T1); } return false; } // -- Otherwise, a temporary of type “cv1 T1” is created and // initialized from the initializer expression using the // rules for a non-reference copy initialization (8.5). The // reference is then bound to the temporary. If T1 is // reference-related to T2, cv1 must be the same // cv-qualification as, or greater cv-qualification than, // cv2; otherwise, the program is ill-formed. if (RefRelationship == Ref_Related) { // If cv1 == cv2 or cv1 is a greater cv-qualified than cv2, then // we would be reference-compatible or reference-compatible with // added qualification. But that wasn't the case, so the reference // initialization fails. if (!ICS) Diag(Init->getSourceRange().getBegin(), diag::err_reference_init_drops_quals, T1.getAsString(), InitLvalue != Expr::LV_Valid? "temporary" : "value", T2.getAsString(), Init->getSourceRange()); return true; } // Actually try to convert the initializer to T1. if (ICS) { /// C++ [over.ics.ref]p2: /// /// When a parameter of reference type is not bound directly to /// an argument expression, the conversion sequence is the one /// required to convert the argument expression to the /// underlying type of the reference according to /// 13.3.3.1. Conceptually, this conversion sequence corresponds /// to copy-initializing a temporary of the underlying type with /// the argument expression. Any difference in top-level /// cv-qualification is subsumed by the initialization itself /// and does not constitute a conversion. *ICS = TryImplicitConversion(Init, T1, SuppressUserConversions); return ICS->ConversionKind == ImplicitConversionSequence::BadConversion; } else { return PerformImplicitConversion(Init, T1); } } /// CheckOverloadedOperatorDeclaration - Check whether the declaration /// of this overloaded operator is well-formed. If so, returns false; /// otherwise, emits appropriate diagnostics and returns true. bool Sema::CheckOverloadedOperatorDeclaration(FunctionDecl *FnDecl) { assert(FnDecl && FnDecl->getOverloadedOperator() != OO_None && "Expected an overloaded operator declaration"); bool IsInvalid = false; OverloadedOperatorKind Op = FnDecl->getOverloadedOperator(); // C++ [over.oper]p5: // The allocation and deallocation functions, operator new, // operator new[], operator delete and operator delete[], are // described completely in 3.7.3. The attributes and restrictions // found in the rest of this subclause do not apply to them unless // explicitly stated in 3.7.3. // FIXME: Write a separate routine for checking this. For now, just // allow it. if (Op == OO_New || Op == OO_Array_New || Op == OO_Delete || Op == OO_Array_Delete) return false; // C++ [over.oper]p6: // An operator function shall either be a non-static member // function or be a non-member function and have at least one // parameter whose type is a class, a reference to a class, an // enumeration, or a reference to an enumeration. CXXMethodDecl *MethodDecl = dyn_cast(FnDecl); if (MethodDecl) { if (MethodDecl->isStatic()) { Diag(FnDecl->getLocation(), diag::err_operator_overload_static, FnDecl->getName(), SourceRange(FnDecl->getLocation())); IsInvalid = true; // Pretend this isn't a member function; it'll supress // additional, unnecessary error messages. MethodDecl = 0; } } else { bool ClassOrEnumParam = false; for (FunctionDecl::param_iterator Param = FnDecl->param_begin(); Param != FnDecl->param_end(); ++Param) { QualType ParamType = (*Param)->getType(); if (const ReferenceType *RefType = ParamType->getAsReferenceType()) ParamType = RefType->getPointeeType(); if (ParamType->isRecordType() || ParamType->isEnumeralType()) { ClassOrEnumParam = true; break; } } if (!ClassOrEnumParam) { Diag(FnDecl->getLocation(), diag::err_operator_overload_needs_class_or_enum, FnDecl->getName(), SourceRange(FnDecl->getLocation())); IsInvalid = true; } } // C++ [over.oper]p8: // An operator function cannot have default arguments (8.3.6), // except where explicitly stated below. // // Only the function-call operator allows default arguments // (C++ [over.call]p1). if (Op != OO_Call) { for (FunctionDecl::param_iterator Param = FnDecl->param_begin(); Param != FnDecl->param_end(); ++Param) { if (Expr *DefArg = (*Param)->getDefaultArg()) { Diag((*Param)->getLocation(), diag::err_operator_overload_default_arg, DefArg->getSourceRange()); IsInvalid = true; } } } bool CanBeUnaryOperator = false; bool CanBeBinaryOperator = false; bool MustBeMemberOperator = false; switch (Op) { case OO_New: case OO_Delete: case OO_Array_New: case OO_Array_Delete: assert(false && "Operators new, new[], delete, and delete[] handled above"); return true; // Unary-only operators case OO_Arrow: MustBeMemberOperator = true; // Fall through case OO_Tilde: case OO_Exclaim: CanBeUnaryOperator = true; break; // Binary-only operators case OO_Equal: case OO_Subscript: MustBeMemberOperator = true; // Fall through case OO_Slash: case OO_Percent: case OO_Caret: case OO_Pipe: case OO_Less: case OO_Greater: case OO_PlusEqual: case OO_MinusEqual: case OO_StarEqual: case OO_SlashEqual: case OO_PercentEqual: case OO_CaretEqual: case OO_AmpEqual: case OO_PipeEqual: case OO_LessLess: case OO_GreaterGreater: case OO_LessLessEqual: case OO_GreaterGreaterEqual: case OO_EqualEqual: case OO_ExclaimEqual: case OO_LessEqual: case OO_GreaterEqual: case OO_AmpAmp: case OO_PipePipe: case OO_Comma: CanBeBinaryOperator = true; break; // Unary or binary operators case OO_Amp: case OO_Plus: case OO_Minus: case OO_Star: case OO_PlusPlus: case OO_MinusMinus: case OO_ArrowStar: CanBeUnaryOperator = true; CanBeBinaryOperator = true; break; case OO_Call: MustBeMemberOperator = true; break; case OO_None: case NUM_OVERLOADED_OPERATORS: assert(false && "Not an overloaded operator!"); return true; } // C++ [over.oper]p8: // [...] Operator functions cannot have more or fewer parameters // than the number required for the corresponding operator, as // described in the rest of this subclause. unsigned NumParams = FnDecl->getNumParams() + (MethodDecl? 1 : 0); if (Op != OO_Call && ((NumParams == 1 && !CanBeUnaryOperator) || (NumParams == 2 && !CanBeBinaryOperator) || (NumParams < 1) || (NumParams > 2))) { // We have the wrong number of parameters. std::string NumParamsStr = (llvm::APSInt(32) = NumParams).toString(10); std::string NumParamsPlural; if (NumParams != 1) NumParamsPlural = "s"; diag::kind DK; if (CanBeUnaryOperator && CanBeBinaryOperator) DK = diag::err_operator_overload_must_be_unary_or_binary; else if (CanBeUnaryOperator) DK = diag::err_operator_overload_must_be_unary; else if (CanBeBinaryOperator) DK = diag::err_operator_overload_must_be_binary; else assert(false && "All non-call overloaded operators are unary or binary!"); Diag(FnDecl->getLocation(), DK, FnDecl->getName(), NumParamsStr, NumParamsPlural, SourceRange(FnDecl->getLocation())); IsInvalid = true; } // Overloaded operators cannot be variadic. if (FnDecl->getType()->getAsFunctionTypeProto()->isVariadic()) { Diag(FnDecl->getLocation(), diag::err_operator_overload_variadic, SourceRange(FnDecl->getLocation())); IsInvalid = true; } // Some operators must be non-static member functions. if (MustBeMemberOperator && !MethodDecl) { Diag(FnDecl->getLocation(), diag::err_operator_overload_must_be_member, FnDecl->getName(), SourceRange(FnDecl->getLocation())); IsInvalid = true; } // C++ [over.inc]p1: // The user-defined function called operator++ implements the // prefix and postfix ++ operator. If this function is a member // function with no parameters, or a non-member function with one // parameter of class or enumeration type, it defines the prefix // increment operator ++ for objects of that type. If the function // is a member function with one parameter (which shall be of type // int) or a non-member function with two parameters (the second // of which shall be of type int), it defines the postfix // increment operator ++ for objects of that type. if ((Op == OO_PlusPlus || Op == OO_MinusMinus) && NumParams == 2) { ParmVarDecl *LastParam = FnDecl->getParamDecl(FnDecl->getNumParams() - 1); bool ParamIsInt = false; if (const BuiltinType *BT = LastParam->getType()->getAsBuiltinType()) ParamIsInt = BT->getKind() == BuiltinType::Int; if (!ParamIsInt) { Diag(LastParam->getLocation(), diag::err_operator_overload_post_incdec_must_be_int, MethodDecl? std::string() : std::string("second "), (Op == OO_PlusPlus)? std::string("increment") : std::string("decrement"), Context.getCanonicalType(LastParam->getType()).getAsString(), SourceRange(FnDecl->getLocation())); IsInvalid = true; } } return IsInvalid; }