//===--- Decl.cpp - 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 Decl class and subclasses. // //===----------------------------------------------------------------------===// #include "clang/AST/Decl.h" #include "clang/AST/ASTContext.h" #include "clang/AST/Attr.h" #include "clang/Basic/IdentifierTable.h" #include "llvm/ADT/DenseMap.h" using namespace clang; //===----------------------------------------------------------------------===// // Statistics //===----------------------------------------------------------------------===// // temporary statistics gathering static unsigned nFuncs = 0; static unsigned nBlockVars = 0; static unsigned nFileVars = 0; static unsigned nParmVars = 0; static unsigned nSUC = 0; static unsigned nEnumConst = 0; static unsigned nEnumDecls = 0; static unsigned nTypedef = 0; static unsigned nFieldDecls = 0; static unsigned nInterfaceDecls = 0; static unsigned nClassDecls = 0; static unsigned nMethodDecls = 0; static unsigned nProtocolDecls = 0; static unsigned nForwardProtocolDecls = 0; static unsigned nCategoryDecls = 0; static unsigned nIvarDecls = 0; static unsigned nObjCImplementationDecls = 0; static unsigned nObjCCategoryImpl = 0; static unsigned nObjCCompatibleAlias = 0; static unsigned nObjCPropertyDecl = 0; static unsigned nLinkageSpecDecl = 0; static unsigned nFileScopeAsmDecl = 0; static bool StatSwitch = false; // This keeps track of all decl attributes. Since so few decls have attrs, we // keep them in a hash map instead of wasting space in the Decl class. typedef llvm::DenseMap DeclAttrMapTy; static DeclAttrMapTy *DeclAttrs = 0; const char *Decl::getDeclKindName() const { switch (DeclKind) { default: assert(0 && "Unknown decl kind!"); case Typedef: return "Typedef"; case Function: return "Function"; case BlockVar: return "BlockVar"; case FileVar: return "FileVar"; case ParmVar: return "ParmVar"; case EnumConstant: return "EnumConstant"; case ObjCInterface: return "ObjCInterface"; case ObjCClass: return "ObjCClass"; case ObjCMethod: return "ObjCMethod"; case ObjCProtocol: return "ObjCProtocol"; case ObjCForwardProtocol: return "ObjCForwardProtocol"; case Struct: return "Struct"; case Union: return "Union"; case Class: return "Class"; case Enum: return "Enum"; } } bool Decl::CollectingStats(bool Enable) { if (Enable) StatSwitch = true; return StatSwitch; } void Decl::PrintStats() { fprintf(stderr, "*** Decl Stats:\n"); fprintf(stderr, " %d decls total.\n", int(nFuncs+nBlockVars+nFileVars+nParmVars+nFieldDecls+nSUC+ nEnumDecls+nEnumConst+nTypedef+nInterfaceDecls+nClassDecls+ nMethodDecls+nProtocolDecls+nCategoryDecls+nIvarDecls)); fprintf(stderr, " %d function decls, %d each (%d bytes)\n", nFuncs, (int)sizeof(FunctionDecl), int(nFuncs*sizeof(FunctionDecl))); fprintf(stderr, " %d block variable decls, %d each (%d bytes)\n", nBlockVars, (int)sizeof(BlockVarDecl), int(nBlockVars*sizeof(BlockVarDecl))); fprintf(stderr, " %d file variable decls, %d each (%d bytes)\n", nFileVars, (int)sizeof(FileVarDecl), int(nFileVars*sizeof(FileVarDecl))); fprintf(stderr, " %d parameter variable decls, %d each (%d bytes)\n", nParmVars, (int)sizeof(ParmVarDecl), int(nParmVars*sizeof(ParmVarDecl))); fprintf(stderr, " %d field decls, %d each (%d bytes)\n", nFieldDecls, (int)sizeof(FieldDecl), int(nFieldDecls*sizeof(FieldDecl))); fprintf(stderr, " %d struct/union/class decls, %d each (%d bytes)\n", nSUC, (int)sizeof(RecordDecl), int(nSUC*sizeof(RecordDecl))); fprintf(stderr, " %d enum decls, %d each (%d bytes)\n", nEnumDecls, (int)sizeof(EnumDecl), int(nEnumDecls*sizeof(EnumDecl))); fprintf(stderr, " %d enum constant decls, %d each (%d bytes)\n", nEnumConst, (int)sizeof(EnumConstantDecl), int(nEnumConst*sizeof(EnumConstantDecl))); fprintf(stderr, " %d typedef decls, %d each (%d bytes)\n", nTypedef, (int)sizeof(TypedefDecl),int(nTypedef*sizeof(TypedefDecl))); // Objective-C decls... fprintf(stderr, " %d interface decls, %d each (%d bytes)\n", nInterfaceDecls, (int)sizeof(ObjCInterfaceDecl), int(nInterfaceDecls*sizeof(ObjCInterfaceDecl))); fprintf(stderr, " %d instance variable decls, %d each (%d bytes)\n", nIvarDecls, (int)sizeof(ObjCIvarDecl), int(nIvarDecls*sizeof(ObjCIvarDecl))); fprintf(stderr, " %d class decls, %d each (%d bytes)\n", nClassDecls, (int)sizeof(ObjCClassDecl), int(nClassDecls*sizeof(ObjCClassDecl))); fprintf(stderr, " %d method decls, %d each (%d bytes)\n", nMethodDecls, (int)sizeof(ObjCMethodDecl), int(nMethodDecls*sizeof(ObjCMethodDecl))); fprintf(stderr, " %d protocol decls, %d each (%d bytes)\n", nProtocolDecls, (int)sizeof(ObjCProtocolDecl), int(nProtocolDecls*sizeof(ObjCProtocolDecl))); fprintf(stderr, " %d forward protocol decls, %d each (%d bytes)\n", nForwardProtocolDecls, (int)sizeof(ObjCForwardProtocolDecl), int(nForwardProtocolDecls*sizeof(ObjCForwardProtocolDecl))); fprintf(stderr, " %d category decls, %d each (%d bytes)\n", nCategoryDecls, (int)sizeof(ObjCCategoryDecl), int(nCategoryDecls*sizeof(ObjCCategoryDecl))); fprintf(stderr, " %d class implementation decls, %d each (%d bytes)\n", nObjCImplementationDecls, (int)sizeof(ObjCImplementationDecl), int(nObjCImplementationDecls*sizeof(ObjCImplementationDecl))); fprintf(stderr, " %d class implementation decls, %d each (%d bytes)\n", nObjCCategoryImpl, (int)sizeof(ObjCCategoryImplDecl), int(nObjCCategoryImpl*sizeof(ObjCCategoryImplDecl))); fprintf(stderr, " %d compatibility alias decls, %d each (%d bytes)\n", nObjCCompatibleAlias, (int)sizeof(ObjCCompatibleAliasDecl), int(nObjCCompatibleAlias*sizeof(ObjCCompatibleAliasDecl))); fprintf(stderr, " %d property decls, %d each (%d bytes)\n", nObjCPropertyDecl, (int)sizeof(ObjCPropertyDecl), int(nObjCPropertyDecl*sizeof(ObjCPropertyDecl))); fprintf(stderr, "Total bytes = %d\n", int(nFuncs*sizeof(FunctionDecl)+nBlockVars*sizeof(BlockVarDecl)+ nFileVars*sizeof(FileVarDecl)+nParmVars*sizeof(ParmVarDecl)+ nFieldDecls*sizeof(FieldDecl)+nSUC*sizeof(RecordDecl)+ nEnumDecls*sizeof(EnumDecl)+nEnumConst*sizeof(EnumConstantDecl)+ nTypedef*sizeof(TypedefDecl)+ nInterfaceDecls*sizeof(ObjCInterfaceDecl)+ nIvarDecls*sizeof(ObjCIvarDecl)+ nClassDecls*sizeof(ObjCClassDecl)+ nMethodDecls*sizeof(ObjCMethodDecl)+ nProtocolDecls*sizeof(ObjCProtocolDecl)+ nForwardProtocolDecls*sizeof(ObjCForwardProtocolDecl)+ nCategoryDecls*sizeof(ObjCCategoryDecl)+ nObjCImplementationDecls*sizeof(ObjCImplementationDecl)+ nObjCCategoryImpl*sizeof(ObjCCategoryImplDecl)+ nObjCCompatibleAlias*sizeof(ObjCCompatibleAliasDecl)+ nObjCPropertyDecl*sizeof(ObjCPropertyDecl)+ nLinkageSpecDecl*sizeof(LinkageSpecDecl)+ nFileScopeAsmDecl*sizeof(FileScopeAsmDecl))); } void Decl::addDeclKind(Kind k) { switch (k) { case Typedef: nTypedef++; break; case Function: nFuncs++; break; case BlockVar: nBlockVars++; break; case FileVar: nFileVars++; break; case ParmVar: nParmVars++; break; case EnumConstant: nEnumConst++; break; case Field: nFieldDecls++; break; case Struct: case Union: case Class: nSUC++; break; case Enum: nEnumDecls++; break; case ObjCInterface: nInterfaceDecls++; break; case ObjCClass: nClassDecls++; break; case ObjCMethod: nMethodDecls++; break; case ObjCProtocol: nProtocolDecls++; break; case ObjCForwardProtocol: nForwardProtocolDecls++; break; case ObjCCategory: nCategoryDecls++; break; case ObjCIvar: nIvarDecls++; break; case ObjCImplementation: nObjCImplementationDecls++; break; case ObjCCategoryImpl: nObjCCategoryImpl++; break; case ObjCCompatibleAlias: nObjCCompatibleAlias++; break; case PropertyDecl: nObjCPropertyDecl++; break; case LinkageSpec: nLinkageSpecDecl++; break; case FileScopeAsm: nFileScopeAsmDecl++; break; } } //===----------------------------------------------------------------------===// // Decl Allocation/Deallocation Method Implementations //===----------------------------------------------------------------------===// BlockVarDecl *BlockVarDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, StorageClass S, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) BlockVarDecl(L, Id, T, S, PrevDecl); } FileVarDecl *FileVarDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, StorageClass S, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) FileVarDecl(L, Id, T, S, PrevDecl); } ParmVarDecl *ParmVarDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, StorageClass S, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) ParmVarDecl(L, Id, T, S, PrevDecl); } FunctionDecl *FunctionDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, StorageClass S, bool isInline, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) FunctionDecl(L, Id, T, S, isInline, PrevDecl); } FieldDecl *FieldDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *BW) { void *Mem = C.getAllocator().Allocate(); return new (Mem) FieldDecl(L, Id, T, BW); } EnumConstantDecl *EnumConstantDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V, ScopedDecl *PrevDecl){ void *Mem = C.getAllocator().Allocate(); return new (Mem) EnumConstantDecl(L, Id, T, E, V, PrevDecl); } TypedefDecl *TypedefDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, QualType T, ScopedDecl *PD) { void *Mem = C.getAllocator().Allocate(); return new (Mem) TypedefDecl(L, Id, T, PD); } EnumDecl *EnumDecl::Create(ASTContext &C, SourceLocation L, IdentifierInfo *Id, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) EnumDecl(L, Id, PrevDecl); } RecordDecl *RecordDecl::Create(ASTContext &C, Kind DK, SourceLocation L, IdentifierInfo *Id, ScopedDecl *PrevDecl) { void *Mem = C.getAllocator().Allocate(); return new (Mem) RecordDecl(DK, L, Id, PrevDecl); } FileScopeAsmDecl *FileScopeAsmDecl::Create(ASTContext &C, SourceLocation L, StringLiteral *Str) { void *Mem = C.getAllocator().Allocate(); return new (Mem) FileScopeAsmDecl(L, Str); } LinkageSpecDecl *LinkageSpecDecl::Create(ASTContext &C, SourceLocation L, LanguageIDs Lang, Decl *D) { void *Mem = C.getAllocator().Allocate(); return new (Mem) LinkageSpecDecl(L, Lang, D); } //===----------------------------------------------------------------------===// // Decl Implementation //===----------------------------------------------------------------------===// // Out-of-line virtual method providing a home for Decl. Decl::~Decl() { if (!HasAttrs) return; DeclAttrMapTy::iterator it = DeclAttrs->find(this); assert(it != DeclAttrs->end() && "No attrs found but HasAttrs is true!"); delete it->second; DeclAttrs->erase(it); if (DeclAttrs->empty()) { delete DeclAttrs; DeclAttrs = 0; } } void Decl::addAttr(Attr *NewAttr) { if (!DeclAttrs) DeclAttrs = new DeclAttrMapTy(); Attr *&ExistingAttr = (*DeclAttrs)[this]; NewAttr->setNext(ExistingAttr); ExistingAttr = NewAttr; HasAttrs = true; } const Attr *Decl::getAttrs() const { if (!HasAttrs) return 0; return (*DeclAttrs)[this]; } //===----------------------------------------------------------------------===// // NamedDecl Implementation //===----------------------------------------------------------------------===// const char *NamedDecl::getName() const { if (const IdentifierInfo *II = getIdentifier()) return II->getName(); return ""; } //===----------------------------------------------------------------------===// // ScopedDecl Implementation //===----------------------------------------------------------------------===// // isDefinedOutsideFunctionOrMethod - This predicate returns true if this // scoped decl is defined outside the current function or method. This is // roughly global variables and functions, but also handles enums (which could // be defined inside or outside a function etc). bool ScopedDecl::isDefinedOutsideFunctionOrMethod() const { if (const VarDecl *VD = dyn_cast(this)) return VD->hasGlobalStorage(); if (isa(this)) return true; // FIXME: This needs to check the context the decl was defined in! if (isa(this) || isa(this)) return true; assert(0 && "Unknown ScopedDecl!"); return false; } //===----------------------------------------------------------------------===// // FunctionDecl Implementation //===----------------------------------------------------------------------===// FunctionDecl::~FunctionDecl() { delete[] ParamInfo; } unsigned FunctionDecl::getNumParams() const { if (isa(getCanonicalType())) return 0; return cast(getCanonicalType())->getNumArgs(); } void FunctionDecl::setParams(ParmVarDecl **NewParamInfo, unsigned NumParams) { assert(ParamInfo == 0 && "Already has param info!"); assert(NumParams == getNumParams() && "Parameter count mismatch!"); // Zero params -> null pointer. if (NumParams) { ParamInfo = new ParmVarDecl*[NumParams]; memcpy(ParamInfo, NewParamInfo, sizeof(ParmVarDecl*)*NumParams); } } //===----------------------------------------------------------------------===// // RecordDecl Implementation //===----------------------------------------------------------------------===// /// defineBody - When created, RecordDecl's correspond to a forward declared /// record. This method is used to mark the decl as being defined, with the /// specified contents. void RecordDecl::defineBody(FieldDecl **members, unsigned numMembers) { assert(!isDefinition() && "Cannot redefine record!"); setDefinition(true); NumMembers = numMembers; if (numMembers) { Members = new FieldDecl*[numMembers]; memcpy(Members, members, numMembers*sizeof(Decl*)); } } FieldDecl *RecordDecl::getMember(IdentifierInfo *II) { if (Members == 0 || NumMembers < 0) return 0; // Linear search. When C++ classes come along, will likely need to revisit. for (int i = 0; i != NumMembers; ++i) if (Members[i]->getIdentifier() == II) return Members[i]; return 0; }