| //===--- DeclTemplate.cpp - Template Declaration AST Node Implementation --===// |
| // |
| // The LLVM Compiler Infrastructure |
| // |
| // This file is distributed under the University of Illinois Open Source |
| // License. See LICENSE.TXT for details. |
| // |
| //===----------------------------------------------------------------------===// |
| // |
| // This file implements the C++ related Decl classes for templates. |
| // |
| //===----------------------------------------------------------------------===// |
| |
| #include "clang/AST/DeclCXX.h" |
| #include "clang/AST/DeclTemplate.h" |
| #include "clang/AST/Expr.h" |
| #include "clang/AST/ASTContext.h" |
| #include "clang/AST/TypeLoc.h" |
| #include "clang/AST/ASTMutationListener.h" |
| #include "clang/Basic/IdentifierTable.h" |
| #include "llvm/ADT/STLExtras.h" |
| #include <memory> |
| using namespace clang; |
| |
| //===----------------------------------------------------------------------===// |
| // TemplateParameterList Implementation |
| //===----------------------------------------------------------------------===// |
| |
| TemplateParameterList::TemplateParameterList(SourceLocation TemplateLoc, |
| SourceLocation LAngleLoc, |
| NamedDecl **Params, unsigned NumParams, |
| SourceLocation RAngleLoc) |
| : TemplateLoc(TemplateLoc), LAngleLoc(LAngleLoc), RAngleLoc(RAngleLoc), |
| NumParams(NumParams) { |
| for (unsigned Idx = 0; Idx < NumParams; ++Idx) |
| begin()[Idx] = Params[Idx]; |
| } |
| |
| TemplateParameterList * |
| TemplateParameterList::Create(ASTContext &C, SourceLocation TemplateLoc, |
| SourceLocation LAngleLoc, NamedDecl **Params, |
| unsigned NumParams, SourceLocation RAngleLoc) { |
| unsigned Size = sizeof(TemplateParameterList) |
| + sizeof(NamedDecl *) * NumParams; |
| unsigned Align = llvm::AlignOf<TemplateParameterList>::Alignment; |
| void *Mem = C.Allocate(Size, Align); |
| return new (Mem) TemplateParameterList(TemplateLoc, LAngleLoc, Params, |
| NumParams, RAngleLoc); |
| } |
| |
| unsigned TemplateParameterList::getMinRequiredArguments() const { |
| unsigned NumRequiredArgs = size(); |
| iterator Param = const_cast<TemplateParameterList *>(this)->end(), |
| ParamBegin = const_cast<TemplateParameterList *>(this)->begin(); |
| while (Param != ParamBegin) { |
| --Param; |
| |
| if (!(*Param)->isTemplateParameterPack() && |
| !(isa<TemplateTypeParmDecl>(*Param) && |
| cast<TemplateTypeParmDecl>(*Param)->hasDefaultArgument()) && |
| !(isa<NonTypeTemplateParmDecl>(*Param) && |
| cast<NonTypeTemplateParmDecl>(*Param)->hasDefaultArgument()) && |
| !(isa<TemplateTemplateParmDecl>(*Param) && |
| cast<TemplateTemplateParmDecl>(*Param)->hasDefaultArgument())) |
| break; |
| |
| --NumRequiredArgs; |
| } |
| |
| return NumRequiredArgs; |
| } |
| |
| unsigned TemplateParameterList::getDepth() const { |
| if (size() == 0) |
| return 0; |
| |
| const NamedDecl *FirstParm = getParam(0); |
| if (const TemplateTypeParmDecl *TTP |
| = dyn_cast<TemplateTypeParmDecl>(FirstParm)) |
| return TTP->getDepth(); |
| else if (const NonTypeTemplateParmDecl *NTTP |
| = dyn_cast<NonTypeTemplateParmDecl>(FirstParm)) |
| return NTTP->getDepth(); |
| else |
| return cast<TemplateTemplateParmDecl>(FirstParm)->getDepth(); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // RedeclarableTemplateDecl Implementation |
| //===----------------------------------------------------------------------===// |
| |
| RedeclarableTemplateDecl::CommonBase *RedeclarableTemplateDecl::getCommonPtr() { |
| // Find the first declaration of this function template. |
| RedeclarableTemplateDecl *First = getCanonicalDecl(); |
| |
| if (First->CommonOrPrev.isNull()) { |
| CommonBase *CommonPtr = First->newCommon(getASTContext()); |
| First->CommonOrPrev = CommonPtr; |
| CommonPtr->Latest = First; |
| } |
| return First->CommonOrPrev.get<CommonBase*>(); |
| } |
| |
| |
| RedeclarableTemplateDecl *RedeclarableTemplateDecl::getCanonicalDeclImpl() { |
| RedeclarableTemplateDecl *Tmpl = this; |
| while (Tmpl->getPreviousDeclaration()) |
| Tmpl = Tmpl->getPreviousDeclaration(); |
| return Tmpl; |
| } |
| |
| void RedeclarableTemplateDecl::setPreviousDeclarationImpl( |
| RedeclarableTemplateDecl *Prev) { |
| if (Prev) { |
| CommonBase *Common = Prev->getCommonPtr(); |
| Prev = Common->Latest; |
| Common->Latest = this; |
| CommonOrPrev = Prev; |
| } else { |
| assert(CommonOrPrev.is<CommonBase*>() && "Cannot reset TemplateDecl Prev"); |
| } |
| } |
| |
| RedeclarableTemplateDecl *RedeclarableTemplateDecl::getNextRedeclaration() { |
| if (CommonOrPrev.is<RedeclarableTemplateDecl*>()) |
| return CommonOrPrev.get<RedeclarableTemplateDecl*>(); |
| CommonBase *Common = CommonOrPrev.get<CommonBase*>(); |
| return Common ? Common->Latest : this; |
| } |
| |
| template <class EntryType> |
| typename RedeclarableTemplateDecl::SpecEntryTraits<EntryType>::DeclType* |
| RedeclarableTemplateDecl::findSpecializationImpl( |
| llvm::FoldingSet<EntryType> &Specs, |
| const TemplateArgument *Args, unsigned NumArgs, |
| void *&InsertPos) { |
| typedef SpecEntryTraits<EntryType> SETraits; |
| llvm::FoldingSetNodeID ID; |
| EntryType::Profile(ID,Args,NumArgs, getASTContext()); |
| EntryType *Entry = Specs.FindNodeOrInsertPos(ID, InsertPos); |
| return Entry ? SETraits::getMostRecentDeclaration(Entry) : 0; |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // FunctionTemplateDecl Implementation |
| //===----------------------------------------------------------------------===// |
| |
| void FunctionTemplateDecl::DeallocateCommon(void *Ptr) { |
| static_cast<Common *>(Ptr)->~Common(); |
| } |
| |
| FunctionTemplateDecl *FunctionTemplateDecl::Create(ASTContext &C, |
| DeclContext *DC, |
| SourceLocation L, |
| DeclarationName Name, |
| TemplateParameterList *Params, |
| NamedDecl *Decl) { |
| return new (C) FunctionTemplateDecl(DC, L, Name, Params, Decl); |
| } |
| |
| RedeclarableTemplateDecl::CommonBase * |
| FunctionTemplateDecl::newCommon(ASTContext &C) { |
| Common *CommonPtr = new (C) Common; |
| C.AddDeallocation(DeallocateCommon, CommonPtr); |
| return CommonPtr; |
| } |
| |
| FunctionDecl * |
| FunctionTemplateDecl::findSpecialization(const TemplateArgument *Args, |
| unsigned NumArgs, void *&InsertPos) { |
| return findSpecializationImpl(getSpecializations(), Args, NumArgs, InsertPos); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // ClassTemplateDecl Implementation |
| //===----------------------------------------------------------------------===// |
| |
| void ClassTemplateDecl::DeallocateCommon(void *Ptr) { |
| static_cast<Common *>(Ptr)->~Common(); |
| } |
| |
| ClassTemplateDecl *ClassTemplateDecl::Create(ASTContext &C, |
| DeclContext *DC, |
| SourceLocation L, |
| DeclarationName Name, |
| TemplateParameterList *Params, |
| NamedDecl *Decl, |
| ClassTemplateDecl *PrevDecl) { |
| ClassTemplateDecl *New = new (C) ClassTemplateDecl(DC, L, Name, Params, Decl); |
| New->setPreviousDeclaration(PrevDecl); |
| return New; |
| } |
| |
| void ClassTemplateDecl::LoadLazySpecializations() { |
| Common *CommonPtr = getCommonPtr(); |
| if (CommonPtr->LazySpecializations) { |
| ASTContext &Context = getASTContext(); |
| uint32_t *Specs = CommonPtr->LazySpecializations; |
| CommonPtr->LazySpecializations = 0; |
| for (uint32_t I = 0, N = *Specs++; I != N; ++I) |
| (void)Context.getExternalSource()->GetExternalDecl(Specs[I]); |
| } |
| } |
| |
| llvm::FoldingSet<ClassTemplateSpecializationDecl> & |
| ClassTemplateDecl::getSpecializations() { |
| LoadLazySpecializations(); |
| return getCommonPtr()->Specializations; |
| } |
| |
| llvm::FoldingSet<ClassTemplatePartialSpecializationDecl> & |
| ClassTemplateDecl::getPartialSpecializations() { |
| LoadLazySpecializations(); |
| return getCommonPtr()->PartialSpecializations; |
| } |
| |
| RedeclarableTemplateDecl::CommonBase * |
| ClassTemplateDecl::newCommon(ASTContext &C) { |
| Common *CommonPtr = new (C) Common; |
| C.AddDeallocation(DeallocateCommon, CommonPtr); |
| return CommonPtr; |
| } |
| |
| ClassTemplateSpecializationDecl * |
| ClassTemplateDecl::findSpecialization(const TemplateArgument *Args, |
| unsigned NumArgs, void *&InsertPos) { |
| return findSpecializationImpl(getSpecializations(), Args, NumArgs, InsertPos); |
| } |
| |
| void ClassTemplateDecl::AddSpecialization(ClassTemplateSpecializationDecl *D, |
| void *InsertPos) { |
| getSpecializations().InsertNode(D, InsertPos); |
| if (ASTMutationListener *L = getASTMutationListener()) |
| L->AddedCXXTemplateSpecialization(this, D); |
| } |
| |
| ClassTemplatePartialSpecializationDecl * |
| ClassTemplateDecl::findPartialSpecialization(const TemplateArgument *Args, |
| unsigned NumArgs, |
| void *&InsertPos) { |
| return findSpecializationImpl(getPartialSpecializations(), Args, NumArgs, |
| InsertPos); |
| } |
| |
| void ClassTemplateDecl::AddPartialSpecialization( |
| ClassTemplatePartialSpecializationDecl *D, |
| void *InsertPos) { |
| getPartialSpecializations().InsertNode(D, InsertPos); |
| if (ASTMutationListener *L = getASTMutationListener()) |
| L->AddedCXXTemplateSpecialization(this, D); |
| } |
| |
| void ClassTemplateDecl::getPartialSpecializations( |
| llvm::SmallVectorImpl<ClassTemplatePartialSpecializationDecl *> &PS) { |
| llvm::FoldingSet<ClassTemplatePartialSpecializationDecl> &PartialSpecs |
| = getPartialSpecializations(); |
| PS.clear(); |
| PS.resize(PartialSpecs.size()); |
| for (llvm::FoldingSet<ClassTemplatePartialSpecializationDecl>::iterator |
| P = PartialSpecs.begin(), PEnd = PartialSpecs.end(); |
| P != PEnd; ++P) { |
| assert(!PS[P->getSequenceNumber()]); |
| PS[P->getSequenceNumber()] = P->getMostRecentDeclaration(); |
| } |
| } |
| |
| ClassTemplatePartialSpecializationDecl * |
| ClassTemplateDecl::findPartialSpecialization(QualType T) { |
| ASTContext &Context = getASTContext(); |
| typedef llvm::FoldingSet<ClassTemplatePartialSpecializationDecl>::iterator |
| partial_spec_iterator; |
| for (partial_spec_iterator P = getPartialSpecializations().begin(), |
| PEnd = getPartialSpecializations().end(); |
| P != PEnd; ++P) { |
| if (Context.hasSameType(P->getInjectedSpecializationType(), T)) |
| return P->getMostRecentDeclaration(); |
| } |
| |
| return 0; |
| } |
| |
| ClassTemplatePartialSpecializationDecl * |
| ClassTemplateDecl::findPartialSpecInstantiatedFromMember( |
| ClassTemplatePartialSpecializationDecl *D) { |
| Decl *DCanon = D->getCanonicalDecl(); |
| for (llvm::FoldingSet<ClassTemplatePartialSpecializationDecl>::iterator |
| P = getPartialSpecializations().begin(), |
| PEnd = getPartialSpecializations().end(); |
| P != PEnd; ++P) { |
| if (P->getInstantiatedFromMember()->getCanonicalDecl() == DCanon) |
| return P->getMostRecentDeclaration(); |
| } |
| |
| return 0; |
| } |
| |
| QualType |
| ClassTemplateDecl::getInjectedClassNameSpecialization() { |
| Common *CommonPtr = getCommonPtr(); |
| if (!CommonPtr->InjectedClassNameType.isNull()) |
| return CommonPtr->InjectedClassNameType; |
| |
| // FIXME: n2800 14.6.1p1 should say how the template arguments |
| // corresponding to template parameter packs should be pack |
| // expansions. We already say that in 14.6.2.1p2, so it would be |
| // better to fix that redundancy. |
| ASTContext &Context = getASTContext(); |
| TemplateParameterList *Params = getTemplateParameters(); |
| llvm::SmallVector<TemplateArgument, 16> TemplateArgs; |
| TemplateArgs.reserve(Params->size()); |
| for (TemplateParameterList::iterator Param = Params->begin(), |
| ParamEnd = Params->end(); |
| Param != ParamEnd; ++Param) { |
| if (isa<TemplateTypeParmDecl>(*Param)) { |
| QualType ParamType = Context.getTypeDeclType(cast<TypeDecl>(*Param)); |
| TemplateArgs.push_back(TemplateArgument(ParamType)); |
| } else if (NonTypeTemplateParmDecl *NTTP = |
| dyn_cast<NonTypeTemplateParmDecl>(*Param)) { |
| Expr *E = new (Context) DeclRefExpr(NTTP, |
| NTTP->getType().getNonLValueExprType(Context), |
| NTTP->getLocation()); |
| TemplateArgs.push_back(TemplateArgument(E)); |
| } else { |
| TemplateTemplateParmDecl *TTP = cast<TemplateTemplateParmDecl>(*Param); |
| TemplateArgs.push_back(TemplateArgument(TemplateName(TTP))); |
| } |
| } |
| |
| CommonPtr->InjectedClassNameType |
| = Context.getTemplateSpecializationType(TemplateName(this), |
| &TemplateArgs[0], |
| TemplateArgs.size()); |
| return CommonPtr->InjectedClassNameType; |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // TemplateTypeParm Allocation/Deallocation Method Implementations |
| //===----------------------------------------------------------------------===// |
| |
| TemplateTypeParmDecl * |
| TemplateTypeParmDecl::Create(ASTContext &C, DeclContext *DC, |
| SourceLocation L, unsigned D, unsigned P, |
| IdentifierInfo *Id, bool Typename, |
| bool ParameterPack) { |
| QualType Type = C.getTemplateTypeParmType(D, P, ParameterPack, Id); |
| return new (C) TemplateTypeParmDecl(DC, L, Id, Typename, Type, ParameterPack); |
| } |
| |
| TemplateTypeParmDecl * |
| TemplateTypeParmDecl::Create(ASTContext &C, EmptyShell Empty) { |
| return new (C) TemplateTypeParmDecl(0, SourceLocation(), 0, false, |
| QualType(), false); |
| } |
| |
| SourceLocation TemplateTypeParmDecl::getDefaultArgumentLoc() const { |
| return DefaultArgument->getTypeLoc().getSourceRange().getBegin(); |
| } |
| |
| unsigned TemplateTypeParmDecl::getDepth() const { |
| return TypeForDecl->getAs<TemplateTypeParmType>()->getDepth(); |
| } |
| |
| unsigned TemplateTypeParmDecl::getIndex() const { |
| return TypeForDecl->getAs<TemplateTypeParmType>()->getIndex(); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // NonTypeTemplateParmDecl Method Implementations |
| //===----------------------------------------------------------------------===// |
| |
| NonTypeTemplateParmDecl * |
| NonTypeTemplateParmDecl::Create(ASTContext &C, DeclContext *DC, |
| SourceLocation L, unsigned D, unsigned P, |
| IdentifierInfo *Id, QualType T, |
| TypeSourceInfo *TInfo) { |
| return new (C) NonTypeTemplateParmDecl(DC, L, D, P, Id, T, TInfo); |
| } |
| |
| SourceLocation NonTypeTemplateParmDecl::getDefaultArgumentLoc() const { |
| return hasDefaultArgument() |
| ? getDefaultArgument()->getSourceRange().getBegin() |
| : SourceLocation(); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // TemplateTemplateParmDecl Method Implementations |
| //===----------------------------------------------------------------------===// |
| |
| TemplateTemplateParmDecl * |
| TemplateTemplateParmDecl::Create(ASTContext &C, DeclContext *DC, |
| SourceLocation L, unsigned D, unsigned P, |
| IdentifierInfo *Id, |
| TemplateParameterList *Params) { |
| return new (C) TemplateTemplateParmDecl(DC, L, D, P, Id, Params); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // TemplateArgumentList Implementation |
| //===----------------------------------------------------------------------===// |
| TemplateArgumentList * |
| TemplateArgumentList::CreateCopy(ASTContext &Context, |
| const TemplateArgument *Args, |
| unsigned NumArgs) { |
| std::size_t Size = sizeof(TemplateArgumentList) |
| + NumArgs * sizeof(TemplateArgument); |
| void *Mem = Context.Allocate(Size); |
| TemplateArgument *StoredArgs |
| = reinterpret_cast<TemplateArgument *>( |
| static_cast<TemplateArgumentList *>(Mem) + 1); |
| std::uninitialized_copy(Args, Args + NumArgs, StoredArgs); |
| return new (Mem) TemplateArgumentList(StoredArgs, NumArgs, true); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // ClassTemplateSpecializationDecl Implementation |
| //===----------------------------------------------------------------------===// |
| ClassTemplateSpecializationDecl:: |
| ClassTemplateSpecializationDecl(ASTContext &Context, Kind DK, TagKind TK, |
| DeclContext *DC, SourceLocation L, |
| ClassTemplateDecl *SpecializedTemplate, |
| const TemplateArgument *Args, |
| unsigned NumArgs, |
| ClassTemplateSpecializationDecl *PrevDecl) |
| : CXXRecordDecl(DK, TK, DC, L, |
| SpecializedTemplate->getIdentifier(), |
| PrevDecl), |
| SpecializedTemplate(SpecializedTemplate), |
| ExplicitInfo(0), |
| TemplateArgs(TemplateArgumentList::CreateCopy(Context, Args, NumArgs)), |
| SpecializationKind(TSK_Undeclared) { |
| } |
| |
| ClassTemplateSpecializationDecl::ClassTemplateSpecializationDecl(Kind DK) |
| : CXXRecordDecl(DK, TTK_Struct, 0, SourceLocation(), 0, 0), |
| ExplicitInfo(0), |
| SpecializationKind(TSK_Undeclared) { |
| } |
| |
| ClassTemplateSpecializationDecl * |
| ClassTemplateSpecializationDecl::Create(ASTContext &Context, TagKind TK, |
| DeclContext *DC, SourceLocation L, |
| ClassTemplateDecl *SpecializedTemplate, |
| const TemplateArgument *Args, |
| unsigned NumArgs, |
| ClassTemplateSpecializationDecl *PrevDecl) { |
| ClassTemplateSpecializationDecl *Result |
| = new (Context)ClassTemplateSpecializationDecl(Context, |
| ClassTemplateSpecialization, |
| TK, DC, L, |
| SpecializedTemplate, |
| Args, NumArgs, |
| PrevDecl); |
| Context.getTypeDeclType(Result, PrevDecl); |
| return Result; |
| } |
| |
| ClassTemplateSpecializationDecl * |
| ClassTemplateSpecializationDecl::Create(ASTContext &Context, EmptyShell Empty) { |
| return |
| new (Context)ClassTemplateSpecializationDecl(ClassTemplateSpecialization); |
| } |
| |
| void |
| ClassTemplateSpecializationDecl::getNameForDiagnostic(std::string &S, |
| const PrintingPolicy &Policy, |
| bool Qualified) const { |
| NamedDecl::getNameForDiagnostic(S, Policy, Qualified); |
| |
| const TemplateArgumentList &TemplateArgs = getTemplateArgs(); |
| S += TemplateSpecializationType::PrintTemplateArgumentList( |
| TemplateArgs.data(), |
| TemplateArgs.size(), |
| Policy); |
| } |
| |
| ClassTemplateDecl * |
| ClassTemplateSpecializationDecl::getSpecializedTemplate() const { |
| if (SpecializedPartialSpecialization *PartialSpec |
| = SpecializedTemplate.dyn_cast<SpecializedPartialSpecialization*>()) |
| return PartialSpec->PartialSpecialization->getSpecializedTemplate(); |
| return SpecializedTemplate.get<ClassTemplateDecl*>(); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // ClassTemplatePartialSpecializationDecl Implementation |
| //===----------------------------------------------------------------------===// |
| ClassTemplatePartialSpecializationDecl * |
| ClassTemplatePartialSpecializationDecl:: |
| Create(ASTContext &Context, TagKind TK,DeclContext *DC, SourceLocation L, |
| TemplateParameterList *Params, |
| ClassTemplateDecl *SpecializedTemplate, |
| const TemplateArgument *Args, |
| unsigned NumArgs, |
| const TemplateArgumentListInfo &ArgInfos, |
| QualType CanonInjectedType, |
| ClassTemplatePartialSpecializationDecl *PrevDecl, |
| unsigned SequenceNumber) { |
| unsigned N = ArgInfos.size(); |
| TemplateArgumentLoc *ClonedArgs = new (Context) TemplateArgumentLoc[N]; |
| for (unsigned I = 0; I != N; ++I) |
| ClonedArgs[I] = ArgInfos[I]; |
| |
| ClassTemplatePartialSpecializationDecl *Result |
| = new (Context)ClassTemplatePartialSpecializationDecl(Context, TK, |
| DC, L, Params, |
| SpecializedTemplate, |
| Args, NumArgs, |
| ClonedArgs, N, |
| PrevDecl, |
| SequenceNumber); |
| Result->setSpecializationKind(TSK_ExplicitSpecialization); |
| |
| Context.getInjectedClassNameType(Result, CanonInjectedType); |
| return Result; |
| } |
| |
| ClassTemplatePartialSpecializationDecl * |
| ClassTemplatePartialSpecializationDecl::Create(ASTContext &Context, |
| EmptyShell Empty) { |
| return new (Context)ClassTemplatePartialSpecializationDecl(); |
| } |
| |
| //===----------------------------------------------------------------------===// |
| // FriendTemplateDecl Implementation |
| //===----------------------------------------------------------------------===// |
| |
| FriendTemplateDecl *FriendTemplateDecl::Create(ASTContext &Context, |
| DeclContext *DC, |
| SourceLocation L, |
| unsigned NParams, |
| TemplateParameterList **Params, |
| FriendUnion Friend, |
| SourceLocation FLoc) { |
| FriendTemplateDecl *Result |
| = new (Context) FriendTemplateDecl(DC, L, NParams, Params, Friend, FLoc); |
| return Result; |
| } |
| |
| FriendTemplateDecl *FriendTemplateDecl::Create(ASTContext &Context, |
| EmptyShell Empty) { |
| return new (Context) FriendTemplateDecl(Empty); |
| } |