blob: bcbf091a195addd8000387165cba70b016d54e94 [file] [log] [blame]
Chris Lattner4b009652007-07-25 00:24:17 +00001//===--- Decl.cpp - Declaration AST Node Implementation -------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
Chris Lattner959e5be2007-12-29 19:59:25 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Chris Lattner4b009652007-07-25 00:24:17 +00007//
8//===----------------------------------------------------------------------===//
9//
Argiris Kirtzidise7dfca12008-06-04 13:04:04 +000010// This file implements the Decl subclasses.
Chris Lattner4b009652007-07-25 00:24:17 +000011//
12//===----------------------------------------------------------------------===//
13
14#include "clang/AST/Decl.h"
Douglas Gregor7a7be652009-02-03 19:21:40 +000015#include "clang/AST/DeclCXX.h"
Steve Naroffd85ba922009-02-22 19:35:57 +000016#include "clang/AST/DeclObjC.h"
Douglas Gregor9054f982009-05-10 22:57:19 +000017#include "clang/AST/DeclTemplate.h"
Chris Lattnere4650482008-03-15 06:12:44 +000018#include "clang/AST/ASTContext.h"
Daniel Dunbarde300732008-08-11 04:54:23 +000019#include "clang/AST/Stmt.h"
Nuno Lopesc98406e2008-12-17 23:39:55 +000020#include "clang/AST/Expr.h"
Douglas Gregor3bf3bbc2009-05-29 20:38:28 +000021#include "clang/AST/PrettyPrinter.h"
Chris Lattnerc46fcdd2009-06-14 01:54:56 +000022#include "clang/Basic/Builtins.h"
Daniel Dunbarde300732008-08-11 04:54:23 +000023#include "clang/Basic/IdentifierTable.h"
Douglas Gregor09be81b2009-02-04 17:27:36 +000024#include <vector>
Ted Kremenekafdf8112008-05-20 00:43:19 +000025
Chris Lattner4b009652007-07-25 00:24:17 +000026using namespace clang;
27
Chris Lattner16ded572009-03-04 06:34:08 +000028void Attr::Destroy(ASTContext &C) {
29 if (Next) {
30 Next->Destroy(C);
31 Next = 0;
32 }
33 this->~Attr();
34 C.Deallocate((void*)this);
35}
36
37
Chris Lattnera8344c32008-03-15 05:43:15 +000038//===----------------------------------------------------------------------===//
Chris Lattnere4650482008-03-15 06:12:44 +000039// Decl Allocation/Deallocation Method Implementations
40//===----------------------------------------------------------------------===//
Argiris Kirtzidis03e6aaf2008-04-27 13:50:30 +000041
Chris Lattner16ded572009-03-04 06:34:08 +000042
Argiris Kirtzidisd3586002008-04-17 14:40:12 +000043TranslationUnitDecl *TranslationUnitDecl::Create(ASTContext &C) {
Argiris Kirtzidis2a6dca12009-06-29 17:38:40 +000044 return new (C) TranslationUnitDecl(C);
Argiris Kirtzidisd3586002008-04-17 14:40:12 +000045}
46
Argiris Kirtzidis03e6aaf2008-04-27 13:50:30 +000047NamespaceDecl *NamespaceDecl::Create(ASTContext &C, DeclContext *DC,
48 SourceLocation L, IdentifierInfo *Id) {
Steve Naroff5abb0282009-01-27 21:25:57 +000049 return new (C) NamespaceDecl(DC, L, Id);
Argiris Kirtzidis03e6aaf2008-04-27 13:50:30 +000050}
51
Ted Kremenek5be49242008-05-20 04:49:55 +000052void NamespaceDecl::Destroy(ASTContext& C) {
53 // NamespaceDecl uses "NextDeclarator" to chain namespace declarations
54 // together. They are all top-level Decls.
55
Ted Kremenek0f433842008-05-24 15:09:56 +000056 this->~NamespaceDecl();
Steve Naroff5abb0282009-01-27 21:25:57 +000057 C.Deallocate((void *)this);
Ted Kremenek5be49242008-05-20 04:49:55 +000058}
59
60
Chris Lattner8c7c6a12008-06-17 18:05:57 +000061ImplicitParamDecl *ImplicitParamDecl::Create(ASTContext &C, DeclContext *DC,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +000062 SourceLocation L, IdentifierInfo *Id, QualType T) {
Steve Naroff5abb0282009-01-27 21:25:57 +000063 return new (C) ImplicitParamDecl(ImplicitParam, DC, L, Id, T);
Chris Lattner8c7c6a12008-06-17 18:05:57 +000064}
65
Daniel Dunbarcaf78fb2009-04-14 02:08:49 +000066const char *VarDecl::getStorageClassSpecifierString(StorageClass SC) {
67 switch (SC) {
68 case VarDecl::None: break;
69 case VarDecl::Auto: return "auto"; break;
70 case VarDecl::Extern: return "extern"; break;
71 case VarDecl::PrivateExtern: return "__private_extern__"; break;
72 case VarDecl::Register: return "register"; break;
73 case VarDecl::Static: return "static"; break;
74 }
75
76 assert(0 && "Invalid storage class");
77 return 0;
78}
79
Chris Lattneref87a202008-04-22 18:39:57 +000080ParmVarDecl *ParmVarDecl::Create(ASTContext &C, DeclContext *DC,
Chris Lattnereee57c02008-04-04 06:12:32 +000081 SourceLocation L, IdentifierInfo *Id,
82 QualType T, StorageClass S,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +000083 Expr *DefArg) {
Steve Naroff5abb0282009-01-27 21:25:57 +000084 return new (C) ParmVarDecl(ParmVar, DC, L, Id, T, S, DefArg);
Fariborz Jahaniane26cb432008-12-20 23:29:59 +000085}
86
87QualType ParmVarDecl::getOriginalType() const {
Douglas Gregor469fc9a2009-02-02 23:39:07 +000088 if (const OriginalParmVarDecl *PVD =
89 dyn_cast<OriginalParmVarDecl>(this))
Fariborz Jahaniane26cb432008-12-20 23:29:59 +000090 return PVD->OriginalType;
91 return getType();
Chris Lattner48d225c2008-03-15 21:10:16 +000092}
93
Douglas Gregor4833ff02009-05-26 18:54:04 +000094void VarDecl::setInit(ASTContext &C, Expr *I) {
95 if (EvaluatedStmt *Eval = Init.dyn_cast<EvaluatedStmt *>()) {
96 Eval->~EvaluatedStmt();
97 C.Deallocate(Eval);
98 }
99
100 Init = I;
101 }
102
Douglas Gregore6b5d1d2009-03-02 00:19:53 +0000103bool VarDecl::isExternC(ASTContext &Context) const {
104 if (!Context.getLangOptions().CPlusPlus)
105 return (getDeclContext()->isTranslationUnit() &&
106 getStorageClass() != Static) ||
107 (getDeclContext()->isFunctionOrMethod() && hasExternalStorage());
108
109 for (const DeclContext *DC = getDeclContext(); !DC->isTranslationUnit();
110 DC = DC->getParent()) {
111 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
112 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
113 return getStorageClass() != Static;
114
115 break;
116 }
117
118 if (DC->isFunctionOrMethod())
119 return false;
120 }
121
122 return false;
123}
124
Douglas Gregor469fc9a2009-02-02 23:39:07 +0000125OriginalParmVarDecl *OriginalParmVarDecl::Create(
Fariborz Jahanian160e8812008-12-20 20:56:12 +0000126 ASTContext &C, DeclContext *DC,
127 SourceLocation L, IdentifierInfo *Id,
128 QualType T, QualType OT, StorageClass S,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000129 Expr *DefArg) {
Douglas Gregor469fc9a2009-02-02 23:39:07 +0000130 return new (C) OriginalParmVarDecl(DC, L, Id, T, OT, S, DefArg);
Fariborz Jahanian160e8812008-12-20 20:56:12 +0000131}
132
Chris Lattneref87a202008-04-22 18:39:57 +0000133FunctionDecl *FunctionDecl::Create(ASTContext &C, DeclContext *DC,
Chris Lattnereee57c02008-04-04 06:12:32 +0000134 SourceLocation L,
Douglas Gregor6704b312008-11-17 22:58:34 +0000135 DeclarationName N, QualType T,
Chris Lattner4c7802b2008-03-15 21:24:04 +0000136 StorageClass S, bool isInline,
Anders Carlssond9d6d502009-05-14 21:46:00 +0000137 bool hasWrittenPrototype,
Steve Naroff71cd7762008-10-03 00:02:03 +0000138 SourceLocation TypeSpecStartLoc) {
Douglas Gregor1f88aa72009-02-25 16:33:18 +0000139 FunctionDecl *New
140 = new (C) FunctionDecl(Function, DC, L, N, T, S, isInline,
141 TypeSpecStartLoc);
Anders Carlssond9d6d502009-05-14 21:46:00 +0000142 New->HasWrittenPrototype = hasWrittenPrototype;
Douglas Gregor1f88aa72009-02-25 16:33:18 +0000143 return New;
Chris Lattner4c7802b2008-03-15 21:24:04 +0000144}
145
Steve Naroff52059382008-10-10 01:28:17 +0000146BlockDecl *BlockDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000147 return new (C) BlockDecl(DC, L);
Steve Naroff9ac456d2008-10-08 17:01:13 +0000148}
149
Douglas Gregor8acb7272008-12-11 16:49:14 +0000150FieldDecl *FieldDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
151 IdentifierInfo *Id, QualType T, Expr *BW,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000152 bool Mutable) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000153 return new (C) FieldDecl(Decl::Field, DC, L, Id, T, BW, Mutable);
Chris Lattner81db64a2008-03-16 00:16:02 +0000154}
155
Douglas Gregorc7f01612009-01-07 19:46:03 +0000156bool FieldDecl::isAnonymousStructOrUnion() const {
157 if (!isImplicit() || getDeclName())
158 return false;
159
160 if (const RecordType *Record = getType()->getAsRecordType())
161 return Record->getDecl()->isAnonymousStructOrUnion();
162
163 return false;
164}
Chris Lattner4c7802b2008-03-15 21:24:04 +0000165
Chris Lattnereee57c02008-04-04 06:12:32 +0000166EnumConstantDecl *EnumConstantDecl::Create(ASTContext &C, EnumDecl *CD,
167 SourceLocation L,
Chris Lattner58114f02008-03-15 21:32:50 +0000168 IdentifierInfo *Id, QualType T,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000169 Expr *E, const llvm::APSInt &V) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000170 return new (C) EnumConstantDecl(CD, L, Id, T, E, V);
Chris Lattnere4650482008-03-15 06:12:44 +0000171}
172
Ted Kremenek5be49242008-05-20 04:49:55 +0000173void EnumConstantDecl::Destroy(ASTContext& C) {
174 if (Init) Init->Destroy(C);
175 Decl::Destroy(C);
176}
177
Chris Lattneref87a202008-04-22 18:39:57 +0000178TypedefDecl *TypedefDecl::Create(ASTContext &C, DeclContext *DC,
Chris Lattnereee57c02008-04-04 06:12:32 +0000179 SourceLocation L,
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000180 IdentifierInfo *Id, QualType T) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000181 return new (C) TypedefDecl(DC, L, Id, T);
Chris Lattnere4650482008-03-15 06:12:44 +0000182}
183
Chris Lattneref87a202008-04-22 18:39:57 +0000184EnumDecl *EnumDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
Chris Lattnereee57c02008-04-04 06:12:32 +0000185 IdentifierInfo *Id,
Douglas Gregorae644892008-12-15 16:32:14 +0000186 EnumDecl *PrevDecl) {
Steve Naroff207b9ec2009-01-27 23:20:32 +0000187 EnumDecl *Enum = new (C) EnumDecl(DC, L, Id);
Douglas Gregorae644892008-12-15 16:32:14 +0000188 C.getTypeDeclType(Enum, PrevDecl);
189 return Enum;
Chris Lattnere4650482008-03-15 06:12:44 +0000190}
191
Ted Kremenek25d8be12008-09-02 20:13:32 +0000192void EnumDecl::Destroy(ASTContext& C) {
Ted Kremenek25d8be12008-09-02 20:13:32 +0000193 Decl::Destroy(C);
194}
195
Douglas Gregor8acb7272008-12-11 16:49:14 +0000196void EnumDecl::completeDefinition(ASTContext &C, QualType NewType) {
197 assert(!isDefinition() && "Cannot redefine enums!");
Douglas Gregor8acb7272008-12-11 16:49:14 +0000198 IntegerType = NewType;
Douglas Gregor98b27542009-01-17 00:42:38 +0000199 TagDecl::completeDefinition();
Douglas Gregor8acb7272008-12-11 16:49:14 +0000200}
201
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000202FileScopeAsmDecl *FileScopeAsmDecl::Create(ASTContext &C, DeclContext *DC,
Chris Lattnereee57c02008-04-04 06:12:32 +0000203 SourceLocation L,
Chris Lattner81db64a2008-03-16 00:16:02 +0000204 StringLiteral *Str) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000205 return new (C) FileScopeAsmDecl(DC, L, Str);
Chris Lattner81db64a2008-03-16 00:16:02 +0000206}
207
Chris Lattnere4650482008-03-15 06:12:44 +0000208//===----------------------------------------------------------------------===//
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000209// NamedDecl Implementation
Argiris Kirtzidis881964b2008-11-09 23:41:00 +0000210//===----------------------------------------------------------------------===//
211
Douglas Gregor09be81b2009-02-04 17:27:36 +0000212std::string NamedDecl::getQualifiedNameAsString() const {
213 std::vector<std::string> Names;
214 std::string QualName;
215 const DeclContext *Ctx = getDeclContext();
216
217 if (Ctx->isFunctionOrMethod())
218 return getNameAsString();
219
220 while (Ctx) {
221 if (Ctx->isFunctionOrMethod())
222 // FIXME: That probably will happen, when D was member of local
223 // scope class/struct/union. How do we handle this case?
224 break;
225
Douglas Gregorb12249d2009-05-18 17:01:57 +0000226 if (const ClassTemplateSpecializationDecl *Spec
227 = dyn_cast<ClassTemplateSpecializationDecl>(Ctx)) {
228 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
Chris Lattner7099c782009-06-30 01:26:17 +0000229 PrintingPolicy Policy(getASTContext().getLangOptions());
Douglas Gregorb12249d2009-05-18 17:01:57 +0000230 std::string TemplateArgsStr
231 = TemplateSpecializationType::PrintTemplateArgumentList(
232 TemplateArgs.getFlatArgumentList(),
Douglas Gregor3bf3bbc2009-05-29 20:38:28 +0000233 TemplateArgs.flat_size(),
234 Policy);
Douglas Gregorb12249d2009-05-18 17:01:57 +0000235 Names.push_back(Spec->getIdentifier()->getName() + TemplateArgsStr);
236 } else if (const NamedDecl *ND = dyn_cast<NamedDecl>(Ctx))
Douglas Gregor09be81b2009-02-04 17:27:36 +0000237 Names.push_back(ND->getNameAsString());
238 else
239 break;
240
241 Ctx = Ctx->getParent();
242 }
243
244 std::vector<std::string>::reverse_iterator
245 I = Names.rbegin(),
246 End = Names.rend();
247
248 for (; I!=End; ++I)
249 QualName += *I + "::";
250
251 QualName += getNameAsString();
252
253 return QualName;
254}
255
256
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000257bool NamedDecl::declarationReplaces(NamedDecl *OldD) const {
Douglas Gregor6e71edc2008-12-23 21:05:05 +0000258 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
259
Douglas Gregor7a7be652009-02-03 19:21:40 +0000260 // UsingDirectiveDecl's are not really NamedDecl's, and all have same name.
261 // We want to keep it, unless it nominates same namespace.
262 if (getKind() == Decl::UsingDirective) {
263 return cast<UsingDirectiveDecl>(this)->getNominatedNamespace() ==
264 cast<UsingDirectiveDecl>(OldD)->getNominatedNamespace();
265 }
266
Douglas Gregor6e71edc2008-12-23 21:05:05 +0000267 if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(this))
268 // For function declarations, we keep track of redeclarations.
269 return FD->getPreviousDeclaration() == OldD;
270
Douglas Gregorb60eb752009-06-25 22:08:12 +0000271 // For function templates, the underlying function declarations are linked.
272 if (const FunctionTemplateDecl *FunctionTemplate
273 = dyn_cast<FunctionTemplateDecl>(this))
274 if (const FunctionTemplateDecl *OldFunctionTemplate
275 = dyn_cast<FunctionTemplateDecl>(OldD))
276 return FunctionTemplate->getTemplatedDecl()
277 ->declarationReplaces(OldFunctionTemplate->getTemplatedDecl());
278
Steve Naroffd85ba922009-02-22 19:35:57 +0000279 // For method declarations, we keep track of redeclarations.
280 if (isa<ObjCMethodDecl>(this))
281 return false;
282
Douglas Gregor6e71edc2008-12-23 21:05:05 +0000283 // For non-function declarations, if the declarations are of the
284 // same kind then this must be a redeclaration, or semantic analysis
285 // would not have given us the new declaration.
286 return this->getKind() == OldD->getKind();
287}
288
Douglas Gregor1c52c632009-02-24 20:03:32 +0000289bool NamedDecl::hasLinkage() const {
290 if (const VarDecl *VD = dyn_cast<VarDecl>(this))
291 return VD->hasExternalStorage() || VD->isFileVarDecl();
292
293 if (isa<FunctionDecl>(this) && !isa<CXXMethodDecl>(this))
294 return true;
295
296 return false;
297}
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000298
Anders Carlssondf5ab842009-06-26 06:29:23 +0000299NamedDecl *NamedDecl::getUnderlyingDecl() {
300 NamedDecl *ND = this;
301 while (true) {
302 if (UsingDecl *UD = dyn_cast<UsingDecl>(ND))
303 ND = UD->getTargetDecl();
304 else if (ObjCCompatibleAliasDecl *AD
305 = dyn_cast<ObjCCompatibleAliasDecl>(ND))
306 return AD->getClassInterface();
307 else
308 return ND;
309 }
310}
311
Argiris Kirtzidis881964b2008-11-09 23:41:00 +0000312//===----------------------------------------------------------------------===//
Nuno Lopesc98406e2008-12-17 23:39:55 +0000313// VarDecl Implementation
314//===----------------------------------------------------------------------===//
315
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000316VarDecl *VarDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
317 IdentifierInfo *Id, QualType T, StorageClass S,
Nuno Lopesc98406e2008-12-17 23:39:55 +0000318 SourceLocation TypeSpecStartLoc) {
Steve Naroff5abb0282009-01-27 21:25:57 +0000319 return new (C) VarDecl(Var, DC, L, Id, T, S, TypeSpecStartLoc);
Nuno Lopesc98406e2008-12-17 23:39:55 +0000320}
321
322void VarDecl::Destroy(ASTContext& C) {
Sebastian Redl2ee55612009-02-05 15:12:41 +0000323 Expr *Init = getInit();
Douglas Gregor4833ff02009-05-26 18:54:04 +0000324 if (Init) {
Sebastian Redl2ee55612009-02-05 15:12:41 +0000325 Init->Destroy(C);
Douglas Gregor4833ff02009-05-26 18:54:04 +0000326 if (EvaluatedStmt *Eval = this->Init.dyn_cast<EvaluatedStmt *>()) {
327 Eval->~EvaluatedStmt();
328 C.Deallocate(Eval);
329 }
330 }
Nuno Lopesc98406e2008-12-17 23:39:55 +0000331 this->~VarDecl();
Steve Naroff5abb0282009-01-27 21:25:57 +0000332 C.Deallocate((void *)this);
Nuno Lopesc98406e2008-12-17 23:39:55 +0000333}
334
335VarDecl::~VarDecl() {
Nuno Lopesc98406e2008-12-17 23:39:55 +0000336}
337
Argiris Kirtzidis545473e2009-06-20 08:09:14 +0000338SourceRange VarDecl::getSourceRange() const {
339 if (getInit())
340 return SourceRange(getLocation(), getInit()->getLocEnd());
341 return SourceRange(getLocation(), getLocation());
342}
343
Douglas Gregor2f728b22009-03-10 23:43:53 +0000344bool VarDecl::isTentativeDefinition(ASTContext &Context) const {
345 if (!isFileVarDecl() || Context.getLangOptions().CPlusPlus)
346 return false;
347
Douglas Gregor9cdb4a12009-04-21 17:11:58 +0000348 const VarDecl *Def = 0;
349 return (!getDefinition(Def) &&
Douglas Gregor2f728b22009-03-10 23:43:53 +0000350 (getStorageClass() == None || getStorageClass() == Static));
351}
352
Ted Kremenek51787c72009-03-20 21:35:28 +0000353const Expr *VarDecl::getDefinition(const VarDecl *&Def) const {
Douglas Gregor2f728b22009-03-10 23:43:53 +0000354 Def = this;
355 while (Def && !Def->getInit())
356 Def = Def->getPreviousDeclaration();
357
358 return Def? Def->getInit() : 0;
359}
360
Argiris Kirtzidis5ea54f62009-07-05 22:21:56 +0000361Decl *VarDecl::getPrimaryDecl() const {
362 const VarDecl *Prim = this;
363 while (Prim->getPreviousDeclaration())
364 Prim = Prim->getPreviousDeclaration();
365
366 return const_cast<VarDecl *>(Prim);
367}
368
Nuno Lopesc98406e2008-12-17 23:39:55 +0000369//===----------------------------------------------------------------------===//
Chris Lattnerc72d22d2008-03-31 00:36:02 +0000370// FunctionDecl Implementation
371//===----------------------------------------------------------------------===//
372
Ted Kremenekafdf8112008-05-20 00:43:19 +0000373void FunctionDecl::Destroy(ASTContext& C) {
Douglas Gregor3b9a7c82009-04-18 00:07:54 +0000374 if (Body && Body.isOffset())
375 Body.get(C.getExternalSource())->Destroy(C);
Ted Kremenek345b93d2008-05-20 03:56:00 +0000376
377 for (param_iterator I=param_begin(), E=param_end(); I!=E; ++I)
378 (*I)->Destroy(C);
Nuno Lopescb8cc5b2009-01-18 19:57:27 +0000379
Steve Naroff5abb0282009-01-27 21:25:57 +0000380 C.Deallocate(ParamInfo);
Nuno Lopescb8cc5b2009-01-18 19:57:27 +0000381
Ted Kremenekafdf8112008-05-20 00:43:19 +0000382 Decl::Destroy(C);
383}
384
385
Argiris Kirtzidisccb9efe2009-06-30 02:35:26 +0000386Stmt *FunctionDecl::getBody(const FunctionDecl *&Definition) const {
Douglas Gregor42214c52008-04-21 02:02:58 +0000387 for (const FunctionDecl *FD = this; FD != 0; FD = FD->PreviousDeclaration) {
388 if (FD->Body) {
389 Definition = FD;
Argiris Kirtzidisccb9efe2009-06-30 02:35:26 +0000390 return FD->Body.get(getASTContext().getExternalSource());
Douglas Gregor42214c52008-04-21 02:02:58 +0000391 }
392 }
393
394 return 0;
Chris Lattner4b009652007-07-25 00:24:17 +0000395}
396
Sebastian Redlbc9ef252009-04-26 20:35:05 +0000397Stmt *FunctionDecl::getBodyIfAvailable() const {
Douglas Gregore3241e92009-04-18 00:02:19 +0000398 for (const FunctionDecl *FD = this; FD != 0; FD = FD->PreviousDeclaration) {
Douglas Gregor3b9a7c82009-04-18 00:07:54 +0000399 if (FD->Body && !FD->Body.isOffset()) {
Sebastian Redlbc9ef252009-04-26 20:35:05 +0000400 return FD->Body.get(0);
Douglas Gregor3b9a7c82009-04-18 00:07:54 +0000401 }
Douglas Gregore3241e92009-04-18 00:02:19 +0000402 }
403
404 return 0;
405}
406
Argiris Kirtzidis545473e2009-06-20 08:09:14 +0000407void FunctionDecl::setBody(Stmt *B) {
408 Body = B;
Argiris Kirtzidis25822a02009-06-22 17:13:31 +0000409 if (B)
Argiris Kirtzidis545473e2009-06-20 08:09:14 +0000410 EndRangeLoc = B->getLocEnd();
411}
412
Douglas Gregoraf682022009-02-24 01:23:02 +0000413bool FunctionDecl::isMain() const {
414 return getDeclContext()->getLookupContext()->isTranslationUnit() &&
415 getIdentifier() && getIdentifier()->isStr("main");
416}
417
Douglas Gregore6b5d1d2009-03-02 00:19:53 +0000418bool FunctionDecl::isExternC(ASTContext &Context) const {
419 // In C, any non-static, non-overloadable function has external
420 // linkage.
421 if (!Context.getLangOptions().CPlusPlus)
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000422 return getStorageClass() != Static && !getAttr<OverloadableAttr>();
Douglas Gregore6b5d1d2009-03-02 00:19:53 +0000423
424 for (const DeclContext *DC = getDeclContext(); !DC->isTranslationUnit();
425 DC = DC->getParent()) {
426 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
427 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
Douglas Gregor98da6ae2009-06-18 16:11:24 +0000428 return getStorageClass() != Static &&
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000429 !getAttr<OverloadableAttr>();
Douglas Gregore6b5d1d2009-03-02 00:19:53 +0000430
431 break;
432 }
433 }
434
435 return false;
436}
437
Douglas Gregorcd7ac6f2009-03-31 16:35:03 +0000438bool FunctionDecl::isGlobal() const {
439 if (const CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(this))
440 return Method->isStatic();
441
442 if (getStorageClass() == Static)
443 return false;
444
445 for (const DeclContext *DC = getDeclContext();
446 DC->isNamespace();
447 DC = DC->getParent()) {
448 if (const NamespaceDecl *Namespace = cast<NamespaceDecl>(DC)) {
449 if (!Namespace->getDeclName())
450 return false;
451 break;
452 }
453 }
454
455 return true;
456}
457
Douglas Gregor411889e2009-02-13 23:20:09 +0000458/// \brief Returns a value indicating whether this function
459/// corresponds to a builtin function.
460///
461/// The function corresponds to a built-in function if it is
462/// declared at translation scope or within an extern "C" block and
463/// its name matches with the name of a builtin. The returned value
464/// will be 0 for functions that do not correspond to a builtin, a
465/// value of type \c Builtin::ID if in the target-independent range
466/// \c [1,Builtin::First), or a target-specific builtin value.
Douglas Gregorb5af7382009-02-14 18:57:46 +0000467unsigned FunctionDecl::getBuiltinID(ASTContext &Context) const {
468 if (!getIdentifier() || !getIdentifier()->getBuiltinID())
469 return 0;
470
471 unsigned BuiltinID = getIdentifier()->getBuiltinID();
472 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
473 return BuiltinID;
474
475 // This function has the name of a known C library
476 // function. Determine whether it actually refers to the C library
477 // function or whether it just has the same name.
478
Douglas Gregor4d6b1022009-02-17 03:23:10 +0000479 // If this is a static function, it's not a builtin.
480 if (getStorageClass() == Static)
481 return 0;
482
Douglas Gregorb5af7382009-02-14 18:57:46 +0000483 // If this function is at translation-unit scope and we're not in
484 // C++, it refers to the C library function.
485 if (!Context.getLangOptions().CPlusPlus &&
486 getDeclContext()->isTranslationUnit())
487 return BuiltinID;
488
489 // If the function is in an extern "C" linkage specification and is
490 // not marked "overloadable", it's the real function.
491 if (isa<LinkageSpecDecl>(getDeclContext()) &&
492 cast<LinkageSpecDecl>(getDeclContext())->getLanguage()
493 == LinkageSpecDecl::lang_c &&
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000494 !getAttr<OverloadableAttr>())
Douglas Gregorb5af7382009-02-14 18:57:46 +0000495 return BuiltinID;
496
497 // Not a builtin
Douglas Gregor411889e2009-02-13 23:20:09 +0000498 return 0;
499}
500
501
Chris Lattnerd2112022009-04-25 06:03:53 +0000502/// getNumParams - Return the number of parameters this function must have
Chris Lattnerc13d4732009-04-25 06:12:16 +0000503/// based on its FunctionType. This is the length of the PararmInfo array
Chris Lattnerd2112022009-04-25 06:03:53 +0000504/// after it has been created.
505unsigned FunctionDecl::getNumParams() const {
Chris Lattner9d957cb2009-04-25 05:56:45 +0000506 const FunctionType *FT = getType()->getAsFunctionType();
Douglas Gregor4fa58902009-02-26 23:50:07 +0000507 if (isa<FunctionNoProtoType>(FT))
Chris Lattnera8344c32008-03-15 05:43:15 +0000508 return 0;
Douglas Gregor4fa58902009-02-26 23:50:07 +0000509 return cast<FunctionProtoType>(FT)->getNumArgs();
Chris Lattner9d957cb2009-04-25 05:56:45 +0000510
Chris Lattner4b009652007-07-25 00:24:17 +0000511}
512
Ted Kremenek8494c962009-01-14 00:42:25 +0000513void FunctionDecl::setParams(ASTContext& C, ParmVarDecl **NewParamInfo,
514 unsigned NumParams) {
Chris Lattner4b009652007-07-25 00:24:17 +0000515 assert(ParamInfo == 0 && "Already has param info!");
Chris Lattnerc13d4732009-04-25 06:12:16 +0000516 assert(NumParams == getNumParams() && "Parameter count mismatch!");
Chris Lattner4b009652007-07-25 00:24:17 +0000517
518 // Zero params -> null pointer.
519 if (NumParams) {
Steve Naroff207b9ec2009-01-27 23:20:32 +0000520 void *Mem = C.Allocate(sizeof(ParmVarDecl*)*NumParams);
Ted Kremenek8494c962009-01-14 00:42:25 +0000521 ParamInfo = new (Mem) ParmVarDecl*[NumParams];
Chris Lattner4b009652007-07-25 00:24:17 +0000522 memcpy(ParamInfo, NewParamInfo, sizeof(ParmVarDecl*)*NumParams);
Argiris Kirtzidis545473e2009-06-20 08:09:14 +0000523
Argiris Kirtzidisae78f1f2009-06-23 00:42:00 +0000524 // Update source range. The check below allows us to set EndRangeLoc before
525 // setting the parameters.
Argiris Kirtzidis0dba8f22009-06-23 00:42:15 +0000526 if (EndRangeLoc.isInvalid() || EndRangeLoc == getLocation())
Argiris Kirtzidis545473e2009-06-20 08:09:14 +0000527 EndRangeLoc = NewParamInfo[NumParams-1]->getLocEnd();
Chris Lattner4b009652007-07-25 00:24:17 +0000528 }
529}
530
Chris Lattner97316c02008-04-10 02:22:51 +0000531/// getMinRequiredArguments - Returns the minimum number of arguments
532/// needed to call this function. This may be fewer than the number of
533/// function parameters, if some of the parameters have default
Chris Lattnerb1856db2008-04-12 23:52:44 +0000534/// arguments (in C++).
Chris Lattner97316c02008-04-10 02:22:51 +0000535unsigned FunctionDecl::getMinRequiredArguments() const {
536 unsigned NumRequiredArgs = getNumParams();
537 while (NumRequiredArgs > 0
Anders Carlssond2e57d92009-06-06 04:14:07 +0000538 && getParamDecl(NumRequiredArgs-1)->hasDefaultArg())
Chris Lattner97316c02008-04-10 02:22:51 +0000539 --NumRequiredArgs;
540
541 return NumRequiredArgs;
542}
543
Douglas Gregor98da6ae2009-06-18 16:11:24 +0000544bool FunctionDecl::hasActiveGNUInlineAttribute(ASTContext &Context) const {
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000545 if (!isInline() || !hasAttr<GNUInlineAttr>())
Douglas Gregor67e11442009-04-28 06:37:30 +0000546 return false;
547
548 for (const FunctionDecl *FD = getPreviousDeclaration(); FD;
549 FD = FD->getPreviousDeclaration()) {
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000550 if (FD->isInline() && !FD->hasAttr<GNUInlineAttr>())
Douglas Gregor67e11442009-04-28 06:37:30 +0000551 return false;
552 }
553
554 return true;
555}
556
Douglas Gregor98da6ae2009-06-18 16:11:24 +0000557bool FunctionDecl::isExternGNUInline(ASTContext &Context) const {
558 if (!hasActiveGNUInlineAttribute(Context))
Douglas Gregor67e11442009-04-28 06:37:30 +0000559 return false;
560
561 for (const FunctionDecl *FD = this; FD; FD = FD->getPreviousDeclaration())
Argiris Kirtzidisfe5f9732009-06-30 02:34:44 +0000562 if (FD->getStorageClass() == Extern && FD->hasAttr<GNUInlineAttr>())
Douglas Gregor67e11442009-04-28 06:37:30 +0000563 return true;
564
565 return false;
566}
567
Douglas Gregor27b6d2b2009-06-29 20:59:39 +0000568void
569FunctionDecl::setPreviousDeclaration(FunctionDecl *PrevDecl) {
570 PreviousDeclaration = PrevDecl;
571
572 if (FunctionTemplateDecl *FunTmpl = getDescribedFunctionTemplate()) {
573 FunctionTemplateDecl *PrevFunTmpl
574 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : 0;
575 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
576 FunTmpl->setPreviousDeclaration(PrevFunTmpl);
577 }
578}
579
Argiris Kirtzidis5ea54f62009-07-05 22:21:56 +0000580Decl *FunctionDecl::getPrimaryDecl() const {
581 const FunctionDecl *Prim = this;
582 while (Prim->getPreviousDeclaration())
583 Prim = Prim->getPreviousDeclaration();
584
585 return const_cast<FunctionDecl *>(Prim);
586}
587
Douglas Gregore60e5d32008-11-06 22:13:31 +0000588/// getOverloadedOperator - Which C++ overloaded operator this
589/// function represents, if any.
590OverloadedOperatorKind FunctionDecl::getOverloadedOperator() const {
Douglas Gregor96a32dd2008-11-18 14:39:36 +0000591 if (getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
592 return getDeclName().getCXXOverloadedOperator();
Douglas Gregore60e5d32008-11-06 22:13:31 +0000593 else
594 return OO_None;
595}
596
Douglas Gregor2ed1a542009-06-29 17:30:29 +0000597FunctionTemplateDecl *FunctionDecl::getPrimaryTemplate() const {
598 if (FunctionTemplateSpecializationInfo *Info
599 = TemplateOrSpecialization
600 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
Douglas Gregor69678062009-06-29 22:39:32 +0000601 return Info->Template.getPointer();
Douglas Gregor2ed1a542009-06-29 17:30:29 +0000602 }
603 return 0;
604}
605
606const TemplateArgumentList *
607FunctionDecl::getTemplateSpecializationArgs() const {
608 if (FunctionTemplateSpecializationInfo *Info
609 = TemplateOrSpecialization
610 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
611 return Info->TemplateArguments;
612 }
613 return 0;
614}
615
Douglas Gregor6f5e0542009-06-26 00:10:03 +0000616void
617FunctionDecl::setFunctionTemplateSpecialization(ASTContext &Context,
618 FunctionTemplateDecl *Template,
Douglas Gregor27b6d2b2009-06-29 20:59:39 +0000619 const TemplateArgumentList *TemplateArgs,
620 void *InsertPos) {
Douglas Gregor2ed1a542009-06-29 17:30:29 +0000621 FunctionTemplateSpecializationInfo *Info
622 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
Douglas Gregor6f5e0542009-06-26 00:10:03 +0000623 if (!Info)
Douglas Gregor2ed1a542009-06-29 17:30:29 +0000624 Info = new (Context) FunctionTemplateSpecializationInfo;
Douglas Gregor6f5e0542009-06-26 00:10:03 +0000625
Douglas Gregor27b6d2b2009-06-29 20:59:39 +0000626 Info->Function = this;
Douglas Gregor69678062009-06-29 22:39:32 +0000627 Info->Template.setPointer(Template);
628 Info->Template.setInt(0); // Implicit instantiation, unless told otherwise
Douglas Gregor6f5e0542009-06-26 00:10:03 +0000629 Info->TemplateArguments = TemplateArgs;
630 TemplateOrSpecialization = Info;
Douglas Gregor27b6d2b2009-06-29 20:59:39 +0000631
632 // Insert this function template specialization into the set of known
633 // function template specialiations.
634 Template->getSpecializations().InsertNode(Info, InsertPos);
Douglas Gregor6f5e0542009-06-26 00:10:03 +0000635}
636
Douglas Gregor69678062009-06-29 22:39:32 +0000637bool FunctionDecl::isExplicitSpecialization() const {
638 // FIXME: check this property for explicit specializations of member
639 // functions of class templates.
640 FunctionTemplateSpecializationInfo *Info
641 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
642 if (!Info)
643 return false;
644
645 return Info->isExplicitSpecialization();
646}
647
648void FunctionDecl::setExplicitSpecialization(bool ES) {
649 // FIXME: set this property for explicit specializations of member functions
650 // of class templates.
651 FunctionTemplateSpecializationInfo *Info
652 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
653 if (Info)
654 Info->setExplicitSpecialization(ES);
655}
656
Chris Lattnerc72d22d2008-03-31 00:36:02 +0000657//===----------------------------------------------------------------------===//
Douglas Gregor723d3332009-01-07 00:43:41 +0000658// TagDecl Implementation
Ted Kremenek46a837c2008-09-05 17:16:31 +0000659//===----------------------------------------------------------------------===//
660
Douglas Gregor98b27542009-01-17 00:42:38 +0000661void TagDecl::startDefinition() {
Douglas Gregor9c7825b2009-02-26 22:19:44 +0000662 TagType *TagT = const_cast<TagType *>(TypeForDecl->getAsTagType());
663 TagT->decl.setPointer(this);
664 TagT->getAsTagType()->decl.setInt(1);
Douglas Gregor98b27542009-01-17 00:42:38 +0000665}
666
667void TagDecl::completeDefinition() {
668 assert((!TypeForDecl ||
Douglas Gregor9c7825b2009-02-26 22:19:44 +0000669 TypeForDecl->getAsTagType()->decl.getPointer() == this) &&
Douglas Gregor98b27542009-01-17 00:42:38 +0000670 "Attempt to redefine a tag definition?");
671 IsDefinition = true;
Douglas Gregor9c7825b2009-02-26 22:19:44 +0000672 TagType *TagT = const_cast<TagType *>(TypeForDecl->getAsTagType());
673 TagT->decl.setPointer(this);
674 TagT->decl.setInt(0);
Douglas Gregor98b27542009-01-17 00:42:38 +0000675}
676
Ted Kremenek46a837c2008-09-05 17:16:31 +0000677TagDecl* TagDecl::getDefinition(ASTContext& C) const {
678 QualType T = C.getTypeDeclType(const_cast<TagDecl*>(this));
Douglas Gregor9c7825b2009-02-26 22:19:44 +0000679 TagDecl* D = cast<TagDecl>(T->getAsTagType()->getDecl());
Ted Kremenek46a837c2008-09-05 17:16:31 +0000680 return D->isDefinition() ? D : 0;
681}
682
683//===----------------------------------------------------------------------===//
Chris Lattnerc72d22d2008-03-31 00:36:02 +0000684// RecordDecl Implementation
685//===----------------------------------------------------------------------===//
Chris Lattner4b009652007-07-25 00:24:17 +0000686
Argiris Kirtzidis2538a8c2008-10-15 00:42:39 +0000687RecordDecl::RecordDecl(Kind DK, TagKind TK, DeclContext *DC, SourceLocation L,
Ted Kremenek2c984042008-09-05 01:34:33 +0000688 IdentifierInfo *Id)
Douglas Gregoraf8ad2b2009-01-20 01:17:11 +0000689 : TagDecl(DK, TK, DC, L, Id) {
Ted Kremenek6f0a2412008-09-02 21:12:32 +0000690 HasFlexibleArrayMember = false;
Douglas Gregor723d3332009-01-07 00:43:41 +0000691 AnonymousStructOrUnion = false;
Ted Kremenek6f0a2412008-09-02 21:12:32 +0000692 assert(classof(static_cast<Decl*>(this)) && "Invalid Kind!");
Ted Kremenek6f0a2412008-09-02 21:12:32 +0000693}
694
695RecordDecl *RecordDecl::Create(ASTContext &C, TagKind TK, DeclContext *DC,
Ted Kremenek46a837c2008-09-05 17:16:31 +0000696 SourceLocation L, IdentifierInfo *Id,
697 RecordDecl* PrevDecl) {
Ted Kremenek2c984042008-09-05 01:34:33 +0000698
Steve Naroff5abb0282009-01-27 21:25:57 +0000699 RecordDecl* R = new (C) RecordDecl(Record, TK, DC, L, Id);
Ted Kremenek46a837c2008-09-05 17:16:31 +0000700 C.getTypeDeclType(R, PrevDecl);
701 return R;
Ted Kremenek6f0a2412008-09-02 21:12:32 +0000702}
703
Argiris Kirtzidisd64c1112008-08-08 14:08:55 +0000704RecordDecl::~RecordDecl() {
Argiris Kirtzidisd64c1112008-08-08 14:08:55 +0000705}
706
707void RecordDecl::Destroy(ASTContext& C) {
Argiris Kirtzidisd64c1112008-08-08 14:08:55 +0000708 TagDecl::Destroy(C);
709}
710
Douglas Gregor43bfaaf2009-03-25 15:59:44 +0000711bool RecordDecl::isInjectedClassName() const {
712 return isImplicit() && getDeclName() && getDeclContext()->isRecord() &&
713 cast<RecordDecl>(getDeclContext())->getDeclName() == getDeclName();
714}
715
Douglas Gregor8acb7272008-12-11 16:49:14 +0000716/// completeDefinition - Notes that the definition of this type is now
717/// complete.
718void RecordDecl::completeDefinition(ASTContext& C) {
Chris Lattner4b009652007-07-25 00:24:17 +0000719 assert(!isDefinition() && "Cannot redefine record!");
Douglas Gregor98b27542009-01-17 00:42:38 +0000720 TagDecl::completeDefinition();
Chris Lattner4b009652007-07-25 00:24:17 +0000721}
722
Steve Naroff9ac456d2008-10-08 17:01:13 +0000723//===----------------------------------------------------------------------===//
724// BlockDecl Implementation
725//===----------------------------------------------------------------------===//
726
727BlockDecl::~BlockDecl() {
728}
729
730void BlockDecl::Destroy(ASTContext& C) {
731 if (Body)
732 Body->Destroy(C);
733
734 for (param_iterator I=param_begin(), E=param_end(); I!=E; ++I)
735 (*I)->Destroy(C);
Ted Kremenek4a71fb12009-03-13 23:17:24 +0000736
737 C.Deallocate(ParamInfo);
Steve Naroff9ac456d2008-10-08 17:01:13 +0000738 Decl::Destroy(C);
739}
Steve Naroff494cb0f2009-03-13 16:56:44 +0000740
741void BlockDecl::setParams(ASTContext& C, ParmVarDecl **NewParamInfo,
742 unsigned NParms) {
743 assert(ParamInfo == 0 && "Already has param info!");
744
745 // Zero params -> null pointer.
746 if (NParms) {
747 NumParams = NParms;
748 void *Mem = C.Allocate(sizeof(ParmVarDecl*)*NumParams);
749 ParamInfo = new (Mem) ParmVarDecl*[NumParams];
750 memcpy(ParamInfo, NewParamInfo, sizeof(ParmVarDecl*)*NumParams);
751 }
752}
753
754unsigned BlockDecl::getNumParams() const {
755 return NumParams;
756}