blob: 2f167eedd152b34a8c18cb7a21bfd93032ee70ba [file] [log] [blame]
Reid Spencer5f016e22007-07-11 17:01:13 +00001//===--- Decl.cpp - Declaration AST Node Implementation -------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
Chris Lattner0bc735f2007-12-29 19:59:25 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Reid Spencer5f016e22007-07-11 17:01:13 +00007//
8//===----------------------------------------------------------------------===//
9//
Argyrios Kyrtzidise184bae2008-06-04 13:04:04 +000010// This file implements the Decl subclasses.
Reid Spencer5f016e22007-07-11 17:01:13 +000011//
12//===----------------------------------------------------------------------===//
13
14#include "clang/AST/Decl.h"
Douglas Gregor2a3009a2009-02-03 19:21:40 +000015#include "clang/AST/DeclCXX.h"
Steve Naroff0de21fd2009-02-22 19:35:57 +000016#include "clang/AST/DeclObjC.h"
Douglas Gregor7da97d02009-05-10 22:57:19 +000017#include "clang/AST/DeclTemplate.h"
Chris Lattner6c2b6eb2008-03-15 06:12:44 +000018#include "clang/AST/ASTContext.h"
Argyrios Kyrtzidisb17166c2009-08-19 01:27:32 +000019#include "clang/AST/TypeLoc.h"
Daniel Dunbare91593e2008-08-11 04:54:23 +000020#include "clang/AST/Stmt.h"
Nuno Lopes99f06ba2008-12-17 23:39:55 +000021#include "clang/AST/Expr.h"
Anders Carlsson337cba42009-12-15 19:16:31 +000022#include "clang/AST/ExprCXX.h"
Douglas Gregord249e1d1f2009-05-29 20:38:28 +000023#include "clang/AST/PrettyPrinter.h"
Argyrios Kyrtzidis565bf302010-10-24 17:26:50 +000024#include "clang/AST/ASTMutationListener.h"
Chris Lattner1b63e4f2009-06-14 01:54:56 +000025#include "clang/Basic/Builtins.h"
Daniel Dunbare91593e2008-08-11 04:54:23 +000026#include "clang/Basic/IdentifierTable.h"
Douglas Gregor15de72c2011-12-02 23:23:56 +000027#include "clang/Basic/Module.h"
Abramo Bagnara465d41b2010-05-11 21:36:43 +000028#include "clang/Basic/Specifiers.h"
Douglas Gregor4421d2b2011-03-26 12:10:19 +000029#include "clang/Basic/TargetInfo.h"
John McCallf1bbbb42009-09-04 01:14:41 +000030#include "llvm/Support/ErrorHandling.h"
Ted Kremenek27f8a282008-05-20 00:43:19 +000031
David Blaikie4278c652011-09-21 18:16:56 +000032#include <algorithm>
33
Reid Spencer5f016e22007-07-11 17:01:13 +000034using namespace clang;
35
Chris Lattnerd3b90652008-03-15 05:43:15 +000036//===----------------------------------------------------------------------===//
Douglas Gregor4afa39d2009-01-20 01:17:11 +000037// NamedDecl Implementation
Argyrios Kyrtzidis52393042008-11-09 23:41:00 +000038//===----------------------------------------------------------------------===//
39
Douglas Gregor4421d2b2011-03-26 12:10:19 +000040static llvm::Optional<Visibility> getVisibilityOf(const Decl *D) {
41 // If this declaration has an explicit visibility attribute, use it.
42 if (const VisibilityAttr *A = D->getAttr<VisibilityAttr>()) {
43 switch (A->getVisibility()) {
44 case VisibilityAttr::Default:
45 return DefaultVisibility;
46 case VisibilityAttr::Hidden:
47 return HiddenVisibility;
48 case VisibilityAttr::Protected:
49 return ProtectedVisibility;
50 }
John McCall7f1b9872010-12-18 03:30:47 +000051
John McCall1fb0caa2010-10-22 21:05:15 +000052 return DefaultVisibility;
John McCall1fb0caa2010-10-22 21:05:15 +000053 }
Douglas Gregor4421d2b2011-03-26 12:10:19 +000054
55 // If we're on Mac OS X, an 'availability' for Mac OS X attribute
56 // implies visibility(default).
Douglas Gregorbcfd1f52011-09-02 00:18:52 +000057 if (D->getASTContext().getTargetInfo().getTriple().isOSDarwin()) {
Douglas Gregor4421d2b2011-03-26 12:10:19 +000058 for (specific_attr_iterator<AvailabilityAttr>
59 A = D->specific_attr_begin<AvailabilityAttr>(),
60 AEnd = D->specific_attr_end<AvailabilityAttr>();
61 A != AEnd; ++A)
62 if ((*A)->getPlatform()->getName().equals("macosx"))
63 return DefaultVisibility;
64 }
65
66 return llvm::Optional<Visibility>();
John McCall1fb0caa2010-10-22 21:05:15 +000067}
68
John McCallaf146032010-10-30 11:50:40 +000069typedef NamedDecl::LinkageInfo LinkageInfo;
John McCall1fb0caa2010-10-22 21:05:15 +000070typedef std::pair<Linkage,Visibility> LVPair;
John McCallaf146032010-10-30 11:50:40 +000071
John McCall1fb0caa2010-10-22 21:05:15 +000072static LVPair merge(LVPair L, LVPair R) {
73 return LVPair(minLinkage(L.first, R.first),
74 minVisibility(L.second, R.second));
75}
76
John McCallaf146032010-10-30 11:50:40 +000077static LVPair merge(LVPair L, LinkageInfo R) {
78 return LVPair(minLinkage(L.first, R.linkage()),
79 minVisibility(L.second, R.visibility()));
80}
81
Benjamin Kramer752c2e92010-11-05 19:56:37 +000082namespace {
John McCall36987482010-11-02 01:45:15 +000083/// Flags controlling the computation of linkage and visibility.
84struct LVFlags {
85 bool ConsiderGlobalVisibility;
86 bool ConsiderVisibilityAttributes;
John McCall1a0918a2011-03-04 10:39:25 +000087 bool ConsiderTemplateParameterTypes;
John McCall36987482010-11-02 01:45:15 +000088
89 LVFlags() : ConsiderGlobalVisibility(true),
John McCall1a0918a2011-03-04 10:39:25 +000090 ConsiderVisibilityAttributes(true),
91 ConsiderTemplateParameterTypes(true) {
John McCall36987482010-11-02 01:45:15 +000092 }
93
Douglas Gregor381d34e2010-12-06 18:36:25 +000094 /// \brief Returns a set of flags that is only useful for computing the
95 /// linkage, not the visibility, of a declaration.
96 static LVFlags CreateOnlyDeclLinkage() {
97 LVFlags F;
98 F.ConsiderGlobalVisibility = false;
99 F.ConsiderVisibilityAttributes = false;
John McCall1a0918a2011-03-04 10:39:25 +0000100 F.ConsiderTemplateParameterTypes = false;
Douglas Gregor381d34e2010-12-06 18:36:25 +0000101 return F;
102 }
103
John McCall36987482010-11-02 01:45:15 +0000104 /// Returns a set of flags, otherwise based on these, which ignores
105 /// off all sources of visibility except template arguments.
106 LVFlags onlyTemplateVisibility() const {
107 LVFlags F = *this;
108 F.ConsiderGlobalVisibility = false;
109 F.ConsiderVisibilityAttributes = false;
John McCall1a0918a2011-03-04 10:39:25 +0000110 F.ConsiderTemplateParameterTypes = false;
John McCall36987482010-11-02 01:45:15 +0000111 return F;
112 }
Douglas Gregor89d63e52010-12-06 18:50:56 +0000113};
Benjamin Kramer752c2e92010-11-05 19:56:37 +0000114} // end anonymous namespace
John McCall36987482010-11-02 01:45:15 +0000115
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000116/// \brief Get the most restrictive linkage for the types in the given
117/// template parameter list.
John McCall1fb0caa2010-10-22 21:05:15 +0000118static LVPair
119getLVForTemplateParameterList(const TemplateParameterList *Params) {
120 LVPair LV(ExternalLinkage, DefaultVisibility);
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000121 for (TemplateParameterList::const_iterator P = Params->begin(),
122 PEnd = Params->end();
123 P != PEnd; ++P) {
Douglas Gregor6952f1e2011-01-19 20:10:05 +0000124 if (NonTypeTemplateParmDecl *NTTP = dyn_cast<NonTypeTemplateParmDecl>(*P)) {
125 if (NTTP->isExpandedParameterPack()) {
126 for (unsigned I = 0, N = NTTP->getNumExpansionTypes(); I != N; ++I) {
127 QualType T = NTTP->getExpansionType(I);
128 if (!T->isDependentType())
129 LV = merge(LV, T->getLinkageAndVisibility());
130 }
131 continue;
132 }
133
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000134 if (!NTTP->getType()->isDependentType()) {
John McCall1fb0caa2010-10-22 21:05:15 +0000135 LV = merge(LV, NTTP->getType()->getLinkageAndVisibility());
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000136 continue;
137 }
Douglas Gregor6952f1e2011-01-19 20:10:05 +0000138 }
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000139
140 if (TemplateTemplateParmDecl *TTP
141 = dyn_cast<TemplateTemplateParmDecl>(*P)) {
John McCallaf146032010-10-30 11:50:40 +0000142 LV = merge(LV, getLVForTemplateParameterList(TTP->getTemplateParameters()));
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000143 }
144 }
145
John McCall1fb0caa2010-10-22 21:05:15 +0000146 return LV;
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000147}
148
Douglas Gregor381d34e2010-12-06 18:36:25 +0000149/// getLVForDecl - Get the linkage and visibility for the given declaration.
150static LinkageInfo getLVForDecl(const NamedDecl *D, LVFlags F);
151
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000152/// \brief Get the most restrictive linkage for the types and
153/// declarations in the given template argument list.
John McCall1fb0caa2010-10-22 21:05:15 +0000154static LVPair getLVForTemplateArgumentList(const TemplateArgument *Args,
Douglas Gregor381d34e2010-12-06 18:36:25 +0000155 unsigned NumArgs,
156 LVFlags &F) {
John McCall1fb0caa2010-10-22 21:05:15 +0000157 LVPair LV(ExternalLinkage, DefaultVisibility);
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000158
159 for (unsigned I = 0; I != NumArgs; ++I) {
160 switch (Args[I].getKind()) {
161 case TemplateArgument::Null:
162 case TemplateArgument::Integral:
163 case TemplateArgument::Expression:
164 break;
165
166 case TemplateArgument::Type:
John McCall1fb0caa2010-10-22 21:05:15 +0000167 LV = merge(LV, Args[I].getAsType()->getLinkageAndVisibility());
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000168 break;
169
170 case TemplateArgument::Declaration:
John McCall1fb0caa2010-10-22 21:05:15 +0000171 // The decl can validly be null as the representation of nullptr
172 // arguments, valid only in C++0x.
173 if (Decl *D = Args[I].getAsDecl()) {
Douglas Gregor89d63e52010-12-06 18:50:56 +0000174 if (NamedDecl *ND = dyn_cast<NamedDecl>(D))
175 LV = merge(LV, getLVForDecl(ND, F));
John McCall1fb0caa2010-10-22 21:05:15 +0000176 }
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000177 break;
178
179 case TemplateArgument::Template:
Douglas Gregora7fc9012011-01-05 18:58:31 +0000180 case TemplateArgument::TemplateExpansion:
181 if (TemplateDecl *Template
182 = Args[I].getAsTemplateOrTemplatePattern().getAsTemplateDecl())
Douglas Gregor89d63e52010-12-06 18:50:56 +0000183 LV = merge(LV, getLVForDecl(Template, F));
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000184 break;
185
186 case TemplateArgument::Pack:
John McCall1fb0caa2010-10-22 21:05:15 +0000187 LV = merge(LV, getLVForTemplateArgumentList(Args[I].pack_begin(),
Douglas Gregor381d34e2010-12-06 18:36:25 +0000188 Args[I].pack_size(),
189 F));
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000190 break;
191 }
192 }
193
John McCall1fb0caa2010-10-22 21:05:15 +0000194 return LV;
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000195}
196
John McCallaf146032010-10-30 11:50:40 +0000197static LVPair
Douglas Gregor381d34e2010-12-06 18:36:25 +0000198getLVForTemplateArgumentList(const TemplateArgumentList &TArgs,
199 LVFlags &F) {
200 return getLVForTemplateArgumentList(TArgs.data(), TArgs.size(), F);
John McCall3cdfc4d2010-08-13 08:35:10 +0000201}
202
John McCall6ce51ee2011-06-27 23:06:04 +0000203static bool shouldConsiderTemplateLV(const FunctionDecl *fn,
204 const FunctionTemplateSpecializationInfo *spec) {
205 return !(spec->isExplicitSpecialization() &&
206 fn->hasAttr<VisibilityAttr>());
207}
208
209static bool shouldConsiderTemplateLV(const ClassTemplateSpecializationDecl *d) {
210 return !(d->isExplicitSpecialization() && d->hasAttr<VisibilityAttr>());
211}
212
John McCall36987482010-11-02 01:45:15 +0000213static LinkageInfo getLVForNamespaceScopeDecl(const NamedDecl *D, LVFlags F) {
Sebastian Redl7a126a42010-08-31 00:36:30 +0000214 assert(D->getDeclContext()->getRedeclContext()->isFileContext() &&
Douglas Gregord85b5b92009-11-25 22:24:25 +0000215 "Not a name having namespace scope");
216 ASTContext &Context = D->getASTContext();
217
218 // C++ [basic.link]p3:
219 // A name having namespace scope (3.3.6) has internal linkage if it
220 // is the name of
221 // - an object, reference, function or function template that is
222 // explicitly declared static; or,
223 // (This bullet corresponds to C99 6.2.2p3.)
224 if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
225 // Explicitly declared static.
John McCalld931b082010-08-26 03:08:43 +0000226 if (Var->getStorageClass() == SC_Static)
John McCallaf146032010-10-30 11:50:40 +0000227 return LinkageInfo::internal();
Douglas Gregord85b5b92009-11-25 22:24:25 +0000228
229 // - an object or reference that is explicitly declared const
230 // and neither explicitly declared extern nor previously
231 // declared to have external linkage; or
232 // (there is no equivalent in C99)
233 if (Context.getLangOptions().CPlusPlus &&
Eli Friedmane9d65542009-11-26 03:04:01 +0000234 Var->getType().isConstant(Context) &&
John McCalld931b082010-08-26 03:08:43 +0000235 Var->getStorageClass() != SC_Extern &&
236 Var->getStorageClass() != SC_PrivateExtern) {
Douglas Gregord85b5b92009-11-25 22:24:25 +0000237 bool FoundExtern = false;
238 for (const VarDecl *PrevVar = Var->getPreviousDeclaration();
239 PrevVar && !FoundExtern;
240 PrevVar = PrevVar->getPreviousDeclaration())
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000241 if (isExternalLinkage(PrevVar->getLinkage()))
Douglas Gregord85b5b92009-11-25 22:24:25 +0000242 FoundExtern = true;
243
244 if (!FoundExtern)
John McCallaf146032010-10-30 11:50:40 +0000245 return LinkageInfo::internal();
Douglas Gregord85b5b92009-11-25 22:24:25 +0000246 }
Fariborz Jahanianc7c90582011-06-16 20:14:50 +0000247 if (Var->getStorageClass() == SC_None) {
248 const VarDecl *PrevVar = Var->getPreviousDeclaration();
249 for (; PrevVar; PrevVar = PrevVar->getPreviousDeclaration())
250 if (PrevVar->getStorageClass() == SC_PrivateExtern)
251 break;
252 if (PrevVar)
253 return PrevVar->getLinkageAndVisibility();
254 }
Douglas Gregord85b5b92009-11-25 22:24:25 +0000255 } else if (isa<FunctionDecl>(D) || isa<FunctionTemplateDecl>(D)) {
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000256 // C++ [temp]p4:
257 // A non-member function template can have internal linkage; any
258 // other template name shall have external linkage.
Douglas Gregord85b5b92009-11-25 22:24:25 +0000259 const FunctionDecl *Function = 0;
260 if (const FunctionTemplateDecl *FunTmpl
261 = dyn_cast<FunctionTemplateDecl>(D))
262 Function = FunTmpl->getTemplatedDecl();
263 else
264 Function = cast<FunctionDecl>(D);
265
266 // Explicitly declared static.
John McCalld931b082010-08-26 03:08:43 +0000267 if (Function->getStorageClass() == SC_Static)
John McCallaf146032010-10-30 11:50:40 +0000268 return LinkageInfo(InternalLinkage, DefaultVisibility, false);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000269 } else if (const FieldDecl *Field = dyn_cast<FieldDecl>(D)) {
270 // - a data member of an anonymous union.
271 if (cast<RecordDecl>(Field->getDeclContext())->isAnonymousStructOrUnion())
John McCallaf146032010-10-30 11:50:40 +0000272 return LinkageInfo::internal();
Douglas Gregord85b5b92009-11-25 22:24:25 +0000273 }
274
Chandler Carruth094b6432011-02-24 19:03:39 +0000275 if (D->isInAnonymousNamespace()) {
276 const VarDecl *Var = dyn_cast<VarDecl>(D);
277 const FunctionDecl *Func = dyn_cast<FunctionDecl>(D);
278 if ((!Var || !Var->isExternC()) && (!Func || !Func->isExternC()))
279 return LinkageInfo::uniqueExternal();
280 }
John McCalle7bc9722010-10-28 04:18:25 +0000281
John McCall1fb0caa2010-10-22 21:05:15 +0000282 // Set up the defaults.
283
284 // C99 6.2.2p5:
285 // If the declaration of an identifier for an object has file
286 // scope and no storage-class specifier, its linkage is
287 // external.
John McCallaf146032010-10-30 11:50:40 +0000288 LinkageInfo LV;
289
John McCall36987482010-11-02 01:45:15 +0000290 if (F.ConsiderVisibilityAttributes) {
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000291 if (llvm::Optional<Visibility> Vis = D->getExplicitVisibility()) {
292 LV.setVisibility(*Vis, true);
John McCall36987482010-11-02 01:45:15 +0000293 F.ConsiderGlobalVisibility = false;
John McCall90f14502010-12-10 02:59:44 +0000294 } else {
295 // If we're declared in a namespace with a visibility attribute,
296 // use that namespace's visibility, but don't call it explicit.
297 for (const DeclContext *DC = D->getDeclContext();
298 !isa<TranslationUnitDecl>(DC);
299 DC = DC->getParent()) {
300 if (!isa<NamespaceDecl>(DC)) continue;
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000301 if (llvm::Optional<Visibility> Vis
302 = cast<NamespaceDecl>(DC)->getExplicitVisibility()) {
303 LV.setVisibility(*Vis, false);
John McCall90f14502010-12-10 02:59:44 +0000304 F.ConsiderGlobalVisibility = false;
305 break;
306 }
307 }
John McCall36987482010-11-02 01:45:15 +0000308 }
John McCallaf146032010-10-30 11:50:40 +0000309 }
John McCall1fb0caa2010-10-22 21:05:15 +0000310
Douglas Gregord85b5b92009-11-25 22:24:25 +0000311 // C++ [basic.link]p4:
John McCall1fb0caa2010-10-22 21:05:15 +0000312
Douglas Gregord85b5b92009-11-25 22:24:25 +0000313 // A name having namespace scope has external linkage if it is the
314 // name of
315 //
316 // - an object or reference, unless it has internal linkage; or
317 if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
John McCall110e8e52010-10-29 22:22:43 +0000318 // GCC applies the following optimization to variables and static
319 // data members, but not to functions:
320 //
John McCall1fb0caa2010-10-22 21:05:15 +0000321 // Modify the variable's LV by the LV of its type unless this is
322 // C or extern "C". This follows from [basic.link]p9:
323 // A type without linkage shall not be used as the type of a
324 // variable or function with external linkage unless
325 // - the entity has C language linkage, or
326 // - the entity is declared within an unnamed namespace, or
327 // - the entity is not used or is defined in the same
328 // translation unit.
329 // and [basic.link]p10:
330 // ...the types specified by all declarations referring to a
331 // given variable or function shall be identical...
332 // C does not have an equivalent rule.
333 //
John McCallac65c622010-10-26 04:59:26 +0000334 // Ignore this if we've got an explicit attribute; the user
335 // probably knows what they're doing.
336 //
John McCall1fb0caa2010-10-22 21:05:15 +0000337 // Note that we don't want to make the variable non-external
338 // because of this, but unique-external linkage suits us.
John McCallee301022010-10-30 09:18:49 +0000339 if (Context.getLangOptions().CPlusPlus && !Var->isExternC()) {
John McCall1fb0caa2010-10-22 21:05:15 +0000340 LVPair TypeLV = Var->getType()->getLinkageAndVisibility();
341 if (TypeLV.first != ExternalLinkage)
John McCallaf146032010-10-30 11:50:40 +0000342 return LinkageInfo::uniqueExternal();
343 if (!LV.visibilityExplicit())
344 LV.mergeVisibility(TypeLV.second);
John McCall110e8e52010-10-29 22:22:43 +0000345 }
346
John McCall35cebc32010-11-02 18:38:13 +0000347 if (Var->getStorageClass() == SC_PrivateExtern)
348 LV.setVisibility(HiddenVisibility, true);
349
Douglas Gregord85b5b92009-11-25 22:24:25 +0000350 if (!Context.getLangOptions().CPlusPlus &&
John McCalld931b082010-08-26 03:08:43 +0000351 (Var->getStorageClass() == SC_Extern ||
352 Var->getStorageClass() == SC_PrivateExtern)) {
John McCall1fb0caa2010-10-22 21:05:15 +0000353
Douglas Gregord85b5b92009-11-25 22:24:25 +0000354 // C99 6.2.2p4:
355 // For an identifier declared with the storage-class specifier
356 // extern in a scope in which a prior declaration of that
357 // identifier is visible, if the prior declaration specifies
358 // internal or external linkage, the linkage of the identifier
359 // at the later declaration is the same as the linkage
360 // specified at the prior declaration. If no prior declaration
361 // is visible, or if the prior declaration specifies no
362 // linkage, then the identifier has external linkage.
363 if (const VarDecl *PrevVar = Var->getPreviousDeclaration()) {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000364 LinkageInfo PrevLV = getLVForDecl(PrevVar, F);
John McCallaf146032010-10-30 11:50:40 +0000365 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
366 LV.mergeVisibility(PrevLV);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000367 }
368 }
369
Douglas Gregord85b5b92009-11-25 22:24:25 +0000370 // - a function, unless it has internal linkage; or
John McCall1fb0caa2010-10-22 21:05:15 +0000371 } else if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
John McCall67fa6d52010-10-28 07:07:52 +0000372 // In theory, we can modify the function's LV by the LV of its
373 // type unless it has C linkage (see comment above about variables
374 // for justification). In practice, GCC doesn't do this, so it's
375 // just too painful to make work.
John McCall1fb0caa2010-10-22 21:05:15 +0000376
John McCall35cebc32010-11-02 18:38:13 +0000377 if (Function->getStorageClass() == SC_PrivateExtern)
378 LV.setVisibility(HiddenVisibility, true);
379
Douglas Gregord85b5b92009-11-25 22:24:25 +0000380 // C99 6.2.2p5:
381 // If the declaration of an identifier for a function has no
382 // storage-class specifier, its linkage is determined exactly
383 // as if it were declared with the storage-class specifier
384 // extern.
385 if (!Context.getLangOptions().CPlusPlus &&
John McCalld931b082010-08-26 03:08:43 +0000386 (Function->getStorageClass() == SC_Extern ||
387 Function->getStorageClass() == SC_PrivateExtern ||
388 Function->getStorageClass() == SC_None)) {
Douglas Gregord85b5b92009-11-25 22:24:25 +0000389 // C99 6.2.2p4:
390 // For an identifier declared with the storage-class specifier
391 // extern in a scope in which a prior declaration of that
392 // identifier is visible, if the prior declaration specifies
393 // internal or external linkage, the linkage of the identifier
394 // at the later declaration is the same as the linkage
395 // specified at the prior declaration. If no prior declaration
396 // is visible, or if the prior declaration specifies no
397 // linkage, then the identifier has external linkage.
398 if (const FunctionDecl *PrevFunc = Function->getPreviousDeclaration()) {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000399 LinkageInfo PrevLV = getLVForDecl(PrevFunc, F);
John McCallaf146032010-10-30 11:50:40 +0000400 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
401 LV.mergeVisibility(PrevLV);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000402 }
403 }
404
John McCallaf8ca372011-02-10 06:50:24 +0000405 // In C++, then if the type of the function uses a type with
406 // unique-external linkage, it's not legally usable from outside
407 // this translation unit. However, we should use the C linkage
408 // rules instead for extern "C" declarations.
409 if (Context.getLangOptions().CPlusPlus && !Function->isExternC() &&
410 Function->getType()->getLinkage() == UniqueExternalLinkage)
411 return LinkageInfo::uniqueExternal();
412
John McCall6ce51ee2011-06-27 23:06:04 +0000413 // Consider LV from the template and the template arguments unless
414 // this is an explicit specialization with a visibility attribute.
415 if (FunctionTemplateSpecializationInfo *specInfo
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000416 = Function->getTemplateSpecializationInfo()) {
John McCall6ce51ee2011-06-27 23:06:04 +0000417 if (shouldConsiderTemplateLV(Function, specInfo)) {
418 LV.merge(getLVForDecl(specInfo->getTemplate(),
419 F.onlyTemplateVisibility()));
420 const TemplateArgumentList &templateArgs = *specInfo->TemplateArguments;
421 LV.merge(getLVForTemplateArgumentList(templateArgs, F));
422 }
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000423 }
424
Douglas Gregord85b5b92009-11-25 22:24:25 +0000425 // - a named class (Clause 9), or an unnamed class defined in a
426 // typedef declaration in which the class has the typedef name
427 // for linkage purposes (7.1.3); or
428 // - a named enumeration (7.2), or an unnamed enumeration
429 // defined in a typedef declaration in which the enumeration
430 // has the typedef name for linkage purposes (7.1.3); or
John McCall1fb0caa2010-10-22 21:05:15 +0000431 } else if (const TagDecl *Tag = dyn_cast<TagDecl>(D)) {
432 // Unnamed tags have no linkage.
Richard Smith162e1c12011-04-15 14:24:37 +0000433 if (!Tag->getDeclName() && !Tag->getTypedefNameForAnonDecl())
John McCallaf146032010-10-30 11:50:40 +0000434 return LinkageInfo::none();
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000435
John McCall1fb0caa2010-10-22 21:05:15 +0000436 // If this is a class template specialization, consider the
437 // linkage of the template and template arguments.
John McCall6ce51ee2011-06-27 23:06:04 +0000438 if (const ClassTemplateSpecializationDecl *spec
John McCall1fb0caa2010-10-22 21:05:15 +0000439 = dyn_cast<ClassTemplateSpecializationDecl>(Tag)) {
John McCall6ce51ee2011-06-27 23:06:04 +0000440 if (shouldConsiderTemplateLV(spec)) {
441 // From the template.
442 LV.merge(getLVForDecl(spec->getSpecializedTemplate(),
443 F.onlyTemplateVisibility()));
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000444
John McCall6ce51ee2011-06-27 23:06:04 +0000445 // The arguments at which the template was instantiated.
446 const TemplateArgumentList &TemplateArgs = spec->getTemplateArgs();
447 LV.merge(getLVForTemplateArgumentList(TemplateArgs, F));
448 }
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000449 }
Douglas Gregord85b5b92009-11-25 22:24:25 +0000450
John McCallac65c622010-10-26 04:59:26 +0000451 // Consider -fvisibility unless the type has C linkage.
John McCall36987482010-11-02 01:45:15 +0000452 if (F.ConsiderGlobalVisibility)
453 F.ConsiderGlobalVisibility =
John McCallac65c622010-10-26 04:59:26 +0000454 (Context.getLangOptions().CPlusPlus &&
455 !Tag->getDeclContext()->isExternCContext());
John McCall1fb0caa2010-10-22 21:05:15 +0000456
Douglas Gregord85b5b92009-11-25 22:24:25 +0000457 // - an enumerator belonging to an enumeration with external linkage;
John McCall1fb0caa2010-10-22 21:05:15 +0000458 } else if (isa<EnumConstantDecl>(D)) {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000459 LinkageInfo EnumLV = getLVForDecl(cast<NamedDecl>(D->getDeclContext()), F);
John McCallaf146032010-10-30 11:50:40 +0000460 if (!isExternalLinkage(EnumLV.linkage()))
461 return LinkageInfo::none();
462 LV.merge(EnumLV);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000463
464 // - a template, unless it is a function template that has
465 // internal linkage (Clause 14);
John McCall1a0918a2011-03-04 10:39:25 +0000466 } else if (const TemplateDecl *temp = dyn_cast<TemplateDecl>(D)) {
467 if (F.ConsiderTemplateParameterTypes)
468 LV.merge(getLVForTemplateParameterList(temp->getTemplateParameters()));
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000469
Douglas Gregord85b5b92009-11-25 22:24:25 +0000470 // - a namespace (7.3), unless it is declared within an unnamed
471 // namespace.
John McCall1fb0caa2010-10-22 21:05:15 +0000472 } else if (isa<NamespaceDecl>(D) && !D->isInAnonymousNamespace()) {
473 return LV;
Douglas Gregord85b5b92009-11-25 22:24:25 +0000474
John McCall1fb0caa2010-10-22 21:05:15 +0000475 // By extension, we assign external linkage to Objective-C
476 // interfaces.
477 } else if (isa<ObjCInterfaceDecl>(D)) {
478 // fallout
479
480 // Everything not covered here has no linkage.
481 } else {
John McCallaf146032010-10-30 11:50:40 +0000482 return LinkageInfo::none();
John McCall1fb0caa2010-10-22 21:05:15 +0000483 }
484
485 // If we ended up with non-external linkage, visibility should
486 // always be default.
John McCallaf146032010-10-30 11:50:40 +0000487 if (LV.linkage() != ExternalLinkage)
488 return LinkageInfo(LV.linkage(), DefaultVisibility, false);
John McCall1fb0caa2010-10-22 21:05:15 +0000489
490 // If we didn't end up with hidden visibility, consider attributes
491 // and -fvisibility.
John McCall36987482010-11-02 01:45:15 +0000492 if (F.ConsiderGlobalVisibility)
John McCallaf146032010-10-30 11:50:40 +0000493 LV.mergeVisibility(Context.getLangOptions().getVisibilityMode());
John McCall1fb0caa2010-10-22 21:05:15 +0000494
495 return LV;
Douglas Gregord85b5b92009-11-25 22:24:25 +0000496}
497
John McCall36987482010-11-02 01:45:15 +0000498static LinkageInfo getLVForClassMember(const NamedDecl *D, LVFlags F) {
John McCall1fb0caa2010-10-22 21:05:15 +0000499 // Only certain class members have linkage. Note that fields don't
500 // really have linkage, but it's convenient to say they do for the
501 // purposes of calculating linkage of pointer-to-data-member
502 // template arguments.
John McCall3cdfc4d2010-08-13 08:35:10 +0000503 if (!(isa<CXXMethodDecl>(D) ||
504 isa<VarDecl>(D) ||
John McCall1fb0caa2010-10-22 21:05:15 +0000505 isa<FieldDecl>(D) ||
John McCall3cdfc4d2010-08-13 08:35:10 +0000506 (isa<TagDecl>(D) &&
Richard Smith162e1c12011-04-15 14:24:37 +0000507 (D->getDeclName() || cast<TagDecl>(D)->getTypedefNameForAnonDecl()))))
John McCallaf146032010-10-30 11:50:40 +0000508 return LinkageInfo::none();
John McCall3cdfc4d2010-08-13 08:35:10 +0000509
John McCall36987482010-11-02 01:45:15 +0000510 LinkageInfo LV;
511
512 // The flags we're going to use to compute the class's visibility.
513 LVFlags ClassF = F;
514
515 // If we have an explicit visibility attribute, merge that in.
516 if (F.ConsiderVisibilityAttributes) {
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000517 if (llvm::Optional<Visibility> Vis = D->getExplicitVisibility()) {
518 LV.mergeVisibility(*Vis, true);
John McCall36987482010-11-02 01:45:15 +0000519
520 // Ignore global visibility later, but not this attribute.
521 F.ConsiderGlobalVisibility = false;
522
523 // Ignore both global visibility and attributes when computing our
524 // parent's visibility.
525 ClassF = F.onlyTemplateVisibility();
526 }
527 }
John McCallaf146032010-10-30 11:50:40 +0000528
529 // Class members only have linkage if their class has external
John McCall36987482010-11-02 01:45:15 +0000530 // linkage.
531 LV.merge(getLVForDecl(cast<RecordDecl>(D->getDeclContext()), ClassF));
532 if (!isExternalLinkage(LV.linkage()))
John McCallaf146032010-10-30 11:50:40 +0000533 return LinkageInfo::none();
John McCall3cdfc4d2010-08-13 08:35:10 +0000534
535 // If the class already has unique-external linkage, we can't improve.
John McCall36987482010-11-02 01:45:15 +0000536 if (LV.linkage() == UniqueExternalLinkage)
John McCallaf146032010-10-30 11:50:40 +0000537 return LinkageInfo::uniqueExternal();
John McCall3cdfc4d2010-08-13 08:35:10 +0000538
John McCall3cdfc4d2010-08-13 08:35:10 +0000539 if (const CXXMethodDecl *MD = dyn_cast<CXXMethodDecl>(D)) {
John McCallaf8ca372011-02-10 06:50:24 +0000540 // If the type of the function uses a type with unique-external
541 // linkage, it's not legally usable from outside this translation unit.
542 if (MD->getType()->getLinkage() == UniqueExternalLinkage)
543 return LinkageInfo::uniqueExternal();
544
John McCall110e8e52010-10-29 22:22:43 +0000545 TemplateSpecializationKind TSK = TSK_Undeclared;
546
John McCall1fb0caa2010-10-22 21:05:15 +0000547 // If this is a method template specialization, use the linkage for
548 // the template parameters and arguments.
John McCall6ce51ee2011-06-27 23:06:04 +0000549 if (FunctionTemplateSpecializationInfo *spec
John McCall3cdfc4d2010-08-13 08:35:10 +0000550 = MD->getTemplateSpecializationInfo()) {
John McCall6ce51ee2011-06-27 23:06:04 +0000551 if (shouldConsiderTemplateLV(MD, spec)) {
552 LV.merge(getLVForTemplateArgumentList(*spec->TemplateArguments, F));
553 if (F.ConsiderTemplateParameterTypes)
554 LV.merge(getLVForTemplateParameterList(
555 spec->getTemplate()->getTemplateParameters()));
556 }
John McCall110e8e52010-10-29 22:22:43 +0000557
John McCall6ce51ee2011-06-27 23:06:04 +0000558 TSK = spec->getTemplateSpecializationKind();
John McCall110e8e52010-10-29 22:22:43 +0000559 } else if (MemberSpecializationInfo *MSI =
560 MD->getMemberSpecializationInfo()) {
561 TSK = MSI->getTemplateSpecializationKind();
John McCall3cdfc4d2010-08-13 08:35:10 +0000562 }
563
John McCall110e8e52010-10-29 22:22:43 +0000564 // If we're paying attention to global visibility, apply
565 // -finline-visibility-hidden if this is an inline method.
566 //
John McCallaf146032010-10-30 11:50:40 +0000567 // Note that ConsiderGlobalVisibility doesn't yet have information
568 // about whether containing classes have visibility attributes,
569 // and that's intentional.
570 if (TSK != TSK_ExplicitInstantiationDeclaration &&
John McCall36987482010-11-02 01:45:15 +0000571 F.ConsiderGlobalVisibility &&
John McCall66cbcf32010-11-01 01:29:57 +0000572 MD->getASTContext().getLangOptions().InlineVisibilityHidden) {
573 // InlineVisibilityHidden only applies to definitions, and
574 // isInlined() only gives meaningful answers on definitions
575 // anyway.
576 const FunctionDecl *Def = 0;
577 if (MD->hasBody(Def) && Def->isInlined())
578 LV.setVisibility(HiddenVisibility);
579 }
John McCall1fb0caa2010-10-22 21:05:15 +0000580
John McCall110e8e52010-10-29 22:22:43 +0000581 // Note that in contrast to basically every other situation, we
582 // *do* apply -fvisibility to method declarations.
583
584 } else if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(D)) {
John McCall6ce51ee2011-06-27 23:06:04 +0000585 if (const ClassTemplateSpecializationDecl *spec
John McCall110e8e52010-10-29 22:22:43 +0000586 = dyn_cast<ClassTemplateSpecializationDecl>(RD)) {
John McCall6ce51ee2011-06-27 23:06:04 +0000587 if (shouldConsiderTemplateLV(spec)) {
588 // Merge template argument/parameter information for member
589 // class template specializations.
590 LV.merge(getLVForTemplateArgumentList(spec->getTemplateArgs(), F));
John McCall1a0918a2011-03-04 10:39:25 +0000591 if (F.ConsiderTemplateParameterTypes)
592 LV.merge(getLVForTemplateParameterList(
John McCall6ce51ee2011-06-27 23:06:04 +0000593 spec->getSpecializedTemplate()->getTemplateParameters()));
594 }
John McCall110e8e52010-10-29 22:22:43 +0000595 }
596
John McCall110e8e52010-10-29 22:22:43 +0000597 // Static data members.
598 } else if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
John McCallee301022010-10-30 09:18:49 +0000599 // Modify the variable's linkage by its type, but ignore the
600 // type's visibility unless it's a definition.
601 LVPair TypeLV = VD->getType()->getLinkageAndVisibility();
602 if (TypeLV.first != ExternalLinkage)
John McCallaf146032010-10-30 11:50:40 +0000603 LV.mergeLinkage(UniqueExternalLinkage);
604 if (!LV.visibilityExplicit())
605 LV.mergeVisibility(TypeLV.second);
John McCall110e8e52010-10-29 22:22:43 +0000606 }
607
John McCall36987482010-11-02 01:45:15 +0000608 F.ConsiderGlobalVisibility &= !LV.visibilityExplicit();
John McCall110e8e52010-10-29 22:22:43 +0000609
610 // Apply -fvisibility if desired.
John McCall36987482010-11-02 01:45:15 +0000611 if (F.ConsiderGlobalVisibility && LV.visibility() != HiddenVisibility) {
John McCallaf146032010-10-30 11:50:40 +0000612 LV.mergeVisibility(D->getASTContext().getLangOptions().getVisibilityMode());
John McCall3cdfc4d2010-08-13 08:35:10 +0000613 }
614
John McCall1fb0caa2010-10-22 21:05:15 +0000615 return LV;
John McCall3cdfc4d2010-08-13 08:35:10 +0000616}
617
John McCallf76b0922011-02-08 19:01:05 +0000618static void clearLinkageForClass(const CXXRecordDecl *record) {
619 for (CXXRecordDecl::decl_iterator
620 i = record->decls_begin(), e = record->decls_end(); i != e; ++i) {
621 Decl *child = *i;
622 if (isa<NamedDecl>(child))
623 cast<NamedDecl>(child)->ClearLinkageCache();
624 }
625}
626
627void NamedDecl::ClearLinkageCache() {
628 // Note that we can't skip clearing the linkage of children just
629 // because the parent doesn't have cached linkage: we don't cache
630 // when computing linkage for parent contexts.
631
632 HasCachedLinkage = 0;
633
634 // If we're changing the linkage of a class, we need to reset the
635 // linkage of child declarations, too.
636 if (const CXXRecordDecl *record = dyn_cast<CXXRecordDecl>(this))
637 clearLinkageForClass(record);
638
John McCall15e310a2011-02-19 02:53:41 +0000639 if (ClassTemplateDecl *temp =
640 dyn_cast<ClassTemplateDecl>(const_cast<NamedDecl*>(this))) {
John McCallf76b0922011-02-08 19:01:05 +0000641 // Clear linkage for the template pattern.
642 CXXRecordDecl *record = temp->getTemplatedDecl();
643 record->HasCachedLinkage = 0;
644 clearLinkageForClass(record);
645
John McCall15e310a2011-02-19 02:53:41 +0000646 // We need to clear linkage for specializations, too.
647 for (ClassTemplateDecl::spec_iterator
648 i = temp->spec_begin(), e = temp->spec_end(); i != e; ++i)
649 i->ClearLinkageCache();
John McCallf76b0922011-02-08 19:01:05 +0000650 }
John McCall15e310a2011-02-19 02:53:41 +0000651
652 // Clear cached linkage for function template decls, too.
653 if (FunctionTemplateDecl *temp =
John McCall78951942011-03-22 06:58:49 +0000654 dyn_cast<FunctionTemplateDecl>(const_cast<NamedDecl*>(this))) {
655 temp->getTemplatedDecl()->ClearLinkageCache();
John McCall15e310a2011-02-19 02:53:41 +0000656 for (FunctionTemplateDecl::spec_iterator
657 i = temp->spec_begin(), e = temp->spec_end(); i != e; ++i)
658 i->ClearLinkageCache();
John McCall78951942011-03-22 06:58:49 +0000659 }
John McCall15e310a2011-02-19 02:53:41 +0000660
John McCallf76b0922011-02-08 19:01:05 +0000661}
662
Douglas Gregor381d34e2010-12-06 18:36:25 +0000663Linkage NamedDecl::getLinkage() const {
664 if (HasCachedLinkage) {
Benjamin Kramer56ed7922010-12-07 15:51:48 +0000665 assert(Linkage(CachedLinkage) ==
666 getLVForDecl(this, LVFlags::CreateOnlyDeclLinkage()).linkage());
Douglas Gregor381d34e2010-12-06 18:36:25 +0000667 return Linkage(CachedLinkage);
668 }
669
670 CachedLinkage = getLVForDecl(this,
671 LVFlags::CreateOnlyDeclLinkage()).linkage();
672 HasCachedLinkage = 1;
673 return Linkage(CachedLinkage);
674}
675
John McCallaf146032010-10-30 11:50:40 +0000676LinkageInfo NamedDecl::getLinkageAndVisibility() const {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000677 LinkageInfo LI = getLVForDecl(this, LVFlags());
Benjamin Kramer56ed7922010-12-07 15:51:48 +0000678 assert(!HasCachedLinkage || Linkage(CachedLinkage) == LI.linkage());
Douglas Gregor381d34e2010-12-06 18:36:25 +0000679 HasCachedLinkage = 1;
680 CachedLinkage = LI.linkage();
681 return LI;
John McCall0df95872010-10-29 00:29:13 +0000682}
Ted Kremenekbecc3082010-04-20 23:15:35 +0000683
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000684llvm::Optional<Visibility> NamedDecl::getExplicitVisibility() const {
685 // Use the most recent declaration of a variable.
686 if (const VarDecl *var = dyn_cast<VarDecl>(this))
687 return getVisibilityOf(var->getMostRecentDeclaration());
688
689 // Use the most recent declaration of a function, and also handle
690 // function template specializations.
691 if (const FunctionDecl *fn = dyn_cast<FunctionDecl>(this)) {
692 if (llvm::Optional<Visibility> V
693 = getVisibilityOf(fn->getMostRecentDeclaration()))
694 return V;
695
696 // If the function is a specialization of a template with an
697 // explicit visibility attribute, use that.
698 if (FunctionTemplateSpecializationInfo *templateInfo
699 = fn->getTemplateSpecializationInfo())
700 return getVisibilityOf(templateInfo->getTemplate()->getTemplatedDecl());
701
702 return llvm::Optional<Visibility>();
703 }
704
705 // Otherwise, just check the declaration itself first.
706 if (llvm::Optional<Visibility> V = getVisibilityOf(this))
707 return V;
708
709 // If there wasn't explicit visibility there, and this is a
710 // specialization of a class template, check for visibility
711 // on the pattern.
712 if (const ClassTemplateSpecializationDecl *spec
713 = dyn_cast<ClassTemplateSpecializationDecl>(this))
714 return getVisibilityOf(spec->getSpecializedTemplate()->getTemplatedDecl());
715
716 return llvm::Optional<Visibility>();
717}
718
John McCall36987482010-11-02 01:45:15 +0000719static LinkageInfo getLVForDecl(const NamedDecl *D, LVFlags Flags) {
Ted Kremenekbecc3082010-04-20 23:15:35 +0000720 // Objective-C: treat all Objective-C declarations as having external
721 // linkage.
John McCall0df95872010-10-29 00:29:13 +0000722 switch (D->getKind()) {
Ted Kremenekbecc3082010-04-20 23:15:35 +0000723 default:
724 break;
Argyrios Kyrtzidisf8d34ed2011-12-01 01:28:21 +0000725 case Decl::ParmVar:
726 return LinkageInfo::none();
John McCall1fb0caa2010-10-22 21:05:15 +0000727 case Decl::TemplateTemplateParm: // count these as external
728 case Decl::NonTypeTemplateParm:
Ted Kremenekbecc3082010-04-20 23:15:35 +0000729 case Decl::ObjCAtDefsField:
730 case Decl::ObjCCategory:
731 case Decl::ObjCCategoryImpl:
Ted Kremenekbecc3082010-04-20 23:15:35 +0000732 case Decl::ObjCCompatibleAlias:
Ted Kremenekbecc3082010-04-20 23:15:35 +0000733 case Decl::ObjCForwardProtocol:
734 case Decl::ObjCImplementation:
Ted Kremenekbecc3082010-04-20 23:15:35 +0000735 case Decl::ObjCMethod:
736 case Decl::ObjCProperty:
737 case Decl::ObjCPropertyImpl:
738 case Decl::ObjCProtocol:
John McCallaf146032010-10-30 11:50:40 +0000739 return LinkageInfo::external();
Ted Kremenekbecc3082010-04-20 23:15:35 +0000740 }
741
Douglas Gregord85b5b92009-11-25 22:24:25 +0000742 // Handle linkage for namespace-scope names.
John McCall0df95872010-10-29 00:29:13 +0000743 if (D->getDeclContext()->getRedeclContext()->isFileContext())
John McCall36987482010-11-02 01:45:15 +0000744 return getLVForNamespaceScopeDecl(D, Flags);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000745
746 // C++ [basic.link]p5:
747 // In addition, a member function, static data member, a named
748 // class or enumeration of class scope, or an unnamed class or
749 // enumeration defined in a class-scope typedef declaration such
750 // that the class or enumeration has the typedef name for linkage
751 // purposes (7.1.3), has external linkage if the name of the class
752 // has external linkage.
John McCall0df95872010-10-29 00:29:13 +0000753 if (D->getDeclContext()->isRecord())
John McCall36987482010-11-02 01:45:15 +0000754 return getLVForClassMember(D, Flags);
Douglas Gregord85b5b92009-11-25 22:24:25 +0000755
756 // C++ [basic.link]p6:
757 // The name of a function declared in block scope and the name of
758 // an object declared by a block scope extern declaration have
759 // linkage. If there is a visible declaration of an entity with
760 // linkage having the same name and type, ignoring entities
761 // declared outside the innermost enclosing namespace scope, the
762 // block scope declaration declares that same entity and receives
763 // the linkage of the previous declaration. If there is more than
764 // one such matching entity, the program is ill-formed. Otherwise,
765 // if no matching entity is found, the block scope entity receives
766 // external linkage.
John McCall0df95872010-10-29 00:29:13 +0000767 if (D->getLexicalDeclContext()->isFunctionOrMethod()) {
768 if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
Chandler Carruth10aad442011-02-25 00:05:02 +0000769 if (Function->isInAnonymousNamespace() && !Function->isExternC())
John McCallaf146032010-10-30 11:50:40 +0000770 return LinkageInfo::uniqueExternal();
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000771
John McCallaf146032010-10-30 11:50:40 +0000772 LinkageInfo LV;
Douglas Gregor381d34e2010-12-06 18:36:25 +0000773 if (Flags.ConsiderVisibilityAttributes) {
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000774 if (llvm::Optional<Visibility> Vis = Function->getExplicitVisibility())
775 LV.setVisibility(*Vis);
Douglas Gregor381d34e2010-12-06 18:36:25 +0000776 }
777
John McCall1fb0caa2010-10-22 21:05:15 +0000778 if (const FunctionDecl *Prev = Function->getPreviousDeclaration()) {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000779 LinkageInfo PrevLV = getLVForDecl(Prev, Flags);
John McCallaf146032010-10-30 11:50:40 +0000780 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
781 LV.mergeVisibility(PrevLV);
John McCall1fb0caa2010-10-22 21:05:15 +0000782 }
783
784 return LV;
Douglas Gregord85b5b92009-11-25 22:24:25 +0000785 }
786
John McCall0df95872010-10-29 00:29:13 +0000787 if (const VarDecl *Var = dyn_cast<VarDecl>(D))
John McCalld931b082010-08-26 03:08:43 +0000788 if (Var->getStorageClass() == SC_Extern ||
789 Var->getStorageClass() == SC_PrivateExtern) {
Chandler Carruth10aad442011-02-25 00:05:02 +0000790 if (Var->isInAnonymousNamespace() && !Var->isExternC())
John McCallaf146032010-10-30 11:50:40 +0000791 return LinkageInfo::uniqueExternal();
Douglas Gregor0b6bc8b2010-02-03 09:33:45 +0000792
John McCallaf146032010-10-30 11:50:40 +0000793 LinkageInfo LV;
John McCall1fb0caa2010-10-22 21:05:15 +0000794 if (Var->getStorageClass() == SC_PrivateExtern)
John McCallaf146032010-10-30 11:50:40 +0000795 LV.setVisibility(HiddenVisibility);
Douglas Gregor381d34e2010-12-06 18:36:25 +0000796 else if (Flags.ConsiderVisibilityAttributes) {
Douglas Gregor4421d2b2011-03-26 12:10:19 +0000797 if (llvm::Optional<Visibility> Vis = Var->getExplicitVisibility())
798 LV.setVisibility(*Vis);
Douglas Gregor381d34e2010-12-06 18:36:25 +0000799 }
800
John McCall1fb0caa2010-10-22 21:05:15 +0000801 if (const VarDecl *Prev = Var->getPreviousDeclaration()) {
Douglas Gregor381d34e2010-12-06 18:36:25 +0000802 LinkageInfo PrevLV = getLVForDecl(Prev, Flags);
John McCallaf146032010-10-30 11:50:40 +0000803 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
804 LV.mergeVisibility(PrevLV);
John McCall1fb0caa2010-10-22 21:05:15 +0000805 }
806
807 return LV;
Douglas Gregord85b5b92009-11-25 22:24:25 +0000808 }
809 }
810
811 // C++ [basic.link]p6:
812 // Names not covered by these rules have no linkage.
John McCallaf146032010-10-30 11:50:40 +0000813 return LinkageInfo::none();
John McCall1fb0caa2010-10-22 21:05:15 +0000814}
Douglas Gregord85b5b92009-11-25 22:24:25 +0000815
Douglas Gregor47b9a1c2009-02-04 17:27:36 +0000816std::string NamedDecl::getQualifiedNameAsString() const {
Anders Carlsson3a082d82009-09-08 18:24:21 +0000817 return getQualifiedNameAsString(getASTContext().getLangOptions());
818}
819
820std::string NamedDecl::getQualifiedNameAsString(const PrintingPolicy &P) const {
Douglas Gregor47b9a1c2009-02-04 17:27:36 +0000821 const DeclContext *Ctx = getDeclContext();
822
823 if (Ctx->isFunctionOrMethod())
824 return getNameAsString();
825
Chris Lattner5f9e2722011-07-23 10:55:15 +0000826 typedef SmallVector<const DeclContext *, 8> ContextsTy;
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000827 ContextsTy Contexts;
828
829 // Collect contexts.
830 while (Ctx && isa<NamedDecl>(Ctx)) {
831 Contexts.push_back(Ctx);
832 Ctx = Ctx->getParent();
833 };
834
835 std::string QualName;
836 llvm::raw_string_ostream OS(QualName);
837
838 for (ContextsTy::reverse_iterator I = Contexts.rbegin(), E = Contexts.rend();
839 I != E; ++I) {
Mike Stump1eb44332009-09-09 15:08:12 +0000840 if (const ClassTemplateSpecializationDecl *Spec
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000841 = dyn_cast<ClassTemplateSpecializationDecl>(*I)) {
Douglas Gregorf3e7ce42009-05-18 17:01:57 +0000842 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
843 std::string TemplateArgsStr
844 = TemplateSpecializationType::PrintTemplateArgumentList(
Douglas Gregor910f8002010-11-07 23:05:16 +0000845 TemplateArgs.data(),
846 TemplateArgs.size(),
Anders Carlsson3a082d82009-09-08 18:24:21 +0000847 P);
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000848 OS << Spec->getName() << TemplateArgsStr;
849 } else if (const NamespaceDecl *ND = dyn_cast<NamespaceDecl>(*I)) {
Sam Weinig6be11202009-12-24 23:15:03 +0000850 if (ND->isAnonymousNamespace())
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000851 OS << "<anonymous namespace>";
Sam Weinig6be11202009-12-24 23:15:03 +0000852 else
Benjamin Kramerb8989f22011-10-14 18:45:37 +0000853 OS << *ND;
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000854 } else if (const RecordDecl *RD = dyn_cast<RecordDecl>(*I)) {
855 if (!RD->getIdentifier())
856 OS << "<anonymous " << RD->getKindName() << '>';
857 else
Benjamin Kramerb8989f22011-10-14 18:45:37 +0000858 OS << *RD;
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000859 } else if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
Sam Weinig3521d012009-12-28 03:19:38 +0000860 const FunctionProtoType *FT = 0;
861 if (FD->hasWrittenPrototype())
862 FT = dyn_cast<FunctionProtoType>(FD->getType()->getAs<FunctionType>());
863
Benjamin Kramerb8989f22011-10-14 18:45:37 +0000864 OS << *FD << '(';
Sam Weinig3521d012009-12-28 03:19:38 +0000865 if (FT) {
Sam Weinig3521d012009-12-28 03:19:38 +0000866 unsigned NumParams = FD->getNumParams();
867 for (unsigned i = 0; i < NumParams; ++i) {
868 if (i)
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000869 OS << ", ";
Sam Weinig3521d012009-12-28 03:19:38 +0000870 std::string Param;
871 FD->getParamDecl(i)->getType().getAsStringInternal(Param, P);
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000872 OS << Param;
Sam Weinig3521d012009-12-28 03:19:38 +0000873 }
874
875 if (FT->isVariadic()) {
876 if (NumParams > 0)
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000877 OS << ", ";
878 OS << "...";
Sam Weinig3521d012009-12-28 03:19:38 +0000879 }
880 }
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000881 OS << ')';
882 } else {
Benjamin Kramerb8989f22011-10-14 18:45:37 +0000883 OS << *cast<NamedDecl>(*I);
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000884 }
885 OS << "::";
Douglas Gregor47b9a1c2009-02-04 17:27:36 +0000886 }
887
John McCall8472af42010-03-16 21:48:18 +0000888 if (getDeclName())
Benjamin Kramerb8989f22011-10-14 18:45:37 +0000889 OS << *this;
John McCall8472af42010-03-16 21:48:18 +0000890 else
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000891 OS << "<anonymous>";
Douglas Gregor47b9a1c2009-02-04 17:27:36 +0000892
Benjamin Kramer68eebbb2010-04-28 14:33:51 +0000893 return OS.str();
Douglas Gregor47b9a1c2009-02-04 17:27:36 +0000894}
895
Douglas Gregor4afa39d2009-01-20 01:17:11 +0000896bool NamedDecl::declarationReplaces(NamedDecl *OldD) const {
Douglas Gregor6ed40e32008-12-23 21:05:05 +0000897 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
898
Douglas Gregor2a3009a2009-02-03 19:21:40 +0000899 // UsingDirectiveDecl's are not really NamedDecl's, and all have same name.
900 // We want to keep it, unless it nominates same namespace.
901 if (getKind() == Decl::UsingDirective) {
Douglas Gregordb992412011-02-25 16:33:46 +0000902 return cast<UsingDirectiveDecl>(this)->getNominatedNamespace()
903 ->getOriginalNamespace() ==
904 cast<UsingDirectiveDecl>(OldD)->getNominatedNamespace()
905 ->getOriginalNamespace();
Douglas Gregor2a3009a2009-02-03 19:21:40 +0000906 }
Mike Stump1eb44332009-09-09 15:08:12 +0000907
Douglas Gregor6ed40e32008-12-23 21:05:05 +0000908 if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(this))
909 // For function declarations, we keep track of redeclarations.
910 return FD->getPreviousDeclaration() == OldD;
911
Douglas Gregore53060f2009-06-25 22:08:12 +0000912 // For function templates, the underlying function declarations are linked.
913 if (const FunctionTemplateDecl *FunctionTemplate
914 = dyn_cast<FunctionTemplateDecl>(this))
915 if (const FunctionTemplateDecl *OldFunctionTemplate
916 = dyn_cast<FunctionTemplateDecl>(OldD))
917 return FunctionTemplate->getTemplatedDecl()
918 ->declarationReplaces(OldFunctionTemplate->getTemplatedDecl());
Mike Stump1eb44332009-09-09 15:08:12 +0000919
Steve Naroff0de21fd2009-02-22 19:35:57 +0000920 // For method declarations, we keep track of redeclarations.
921 if (isa<ObjCMethodDecl>(this))
922 return false;
Mike Stump1eb44332009-09-09 15:08:12 +0000923
John McCallf36e02d2009-10-09 21:13:30 +0000924 if (isa<ObjCInterfaceDecl>(this) && isa<ObjCCompatibleAliasDecl>(OldD))
925 return true;
926
John McCall9488ea12009-11-17 05:59:44 +0000927 if (isa<UsingShadowDecl>(this) && isa<UsingShadowDecl>(OldD))
928 return cast<UsingShadowDecl>(this)->getTargetDecl() ==
929 cast<UsingShadowDecl>(OldD)->getTargetDecl();
930
Douglas Gregordc355712011-02-25 00:36:19 +0000931 if (isa<UsingDecl>(this) && isa<UsingDecl>(OldD)) {
932 ASTContext &Context = getASTContext();
933 return Context.getCanonicalNestedNameSpecifier(
934 cast<UsingDecl>(this)->getQualifier()) ==
935 Context.getCanonicalNestedNameSpecifier(
936 cast<UsingDecl>(OldD)->getQualifier());
937 }
Argyrios Kyrtzidisc80117e2010-11-04 08:48:52 +0000938
Douglas Gregor6ed40e32008-12-23 21:05:05 +0000939 // For non-function declarations, if the declarations are of the
940 // same kind then this must be a redeclaration, or semantic analysis
941 // would not have given us the new declaration.
942 return this->getKind() == OldD->getKind();
943}
944
Douglas Gregord6f7e9d2009-02-24 20:03:32 +0000945bool NamedDecl::hasLinkage() const {
Douglas Gregord85b5b92009-11-25 22:24:25 +0000946 return getLinkage() != NoLinkage;
Douglas Gregord6f7e9d2009-02-24 20:03:32 +0000947}
Douglas Gregor4afa39d2009-01-20 01:17:11 +0000948
Anders Carlssone136e0e2009-06-26 06:29:23 +0000949NamedDecl *NamedDecl::getUnderlyingDecl() {
950 NamedDecl *ND = this;
951 while (true) {
John McCall9488ea12009-11-17 05:59:44 +0000952 if (UsingShadowDecl *UD = dyn_cast<UsingShadowDecl>(ND))
Anders Carlssone136e0e2009-06-26 06:29:23 +0000953 ND = UD->getTargetDecl();
954 else if (ObjCCompatibleAliasDecl *AD
955 = dyn_cast<ObjCCompatibleAliasDecl>(ND))
956 return AD->getClassInterface();
957 else
958 return ND;
959 }
960}
961
John McCall161755a2010-04-06 21:38:20 +0000962bool NamedDecl::isCXXInstanceMember() const {
963 assert(isCXXClassMember() &&
964 "checking whether non-member is instance member");
965
966 const NamedDecl *D = this;
967 if (isa<UsingShadowDecl>(D))
968 D = cast<UsingShadowDecl>(D)->getTargetDecl();
969
Francois Pichet87c2e122010-11-21 06:08:52 +0000970 if (isa<FieldDecl>(D) || isa<IndirectFieldDecl>(D))
John McCall161755a2010-04-06 21:38:20 +0000971 return true;
972 if (isa<CXXMethodDecl>(D))
973 return cast<CXXMethodDecl>(D)->isInstance();
974 if (isa<FunctionTemplateDecl>(D))
975 return cast<CXXMethodDecl>(cast<FunctionTemplateDecl>(D)
976 ->getTemplatedDecl())->isInstance();
977 return false;
978}
979
Argyrios Kyrtzidis52393042008-11-09 23:41:00 +0000980//===----------------------------------------------------------------------===//
Argyrios Kyrtzidisa5d82002009-08-21 00:31:54 +0000981// DeclaratorDecl Implementation
982//===----------------------------------------------------------------------===//
983
Douglas Gregor1693e152010-07-06 18:42:40 +0000984template <typename DeclT>
985static SourceLocation getTemplateOrInnerLocStart(const DeclT *decl) {
986 if (decl->getNumTemplateParameterLists() > 0)
987 return decl->getTemplateParameterList(0)->getTemplateLoc();
988 else
989 return decl->getInnerLocStart();
990}
991
Argyrios Kyrtzidisa5d82002009-08-21 00:31:54 +0000992SourceLocation DeclaratorDecl::getTypeSpecStartLoc() const {
John McCall4e449832010-05-28 23:32:21 +0000993 TypeSourceInfo *TSI = getTypeSourceInfo();
994 if (TSI) return TSI->getTypeLoc().getBeginLoc();
Argyrios Kyrtzidisa5d82002009-08-21 00:31:54 +0000995 return SourceLocation();
996}
997
Douglas Gregorc22b5ff2011-02-25 02:25:35 +0000998void DeclaratorDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
999 if (QualifierLoc) {
John McCallb6217662010-03-15 10:12:16 +00001000 // Make sure the extended decl info is allocated.
1001 if (!hasExtInfo()) {
1002 // Save (non-extended) type source info pointer.
1003 TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
1004 // Allocate external info struct.
1005 DeclInfo = new (getASTContext()) ExtInfo;
1006 // Restore savedTInfo into (extended) decl info.
1007 getExtInfo()->TInfo = savedTInfo;
1008 }
1009 // Set qualifier info.
Douglas Gregorc22b5ff2011-02-25 02:25:35 +00001010 getExtInfo()->QualifierLoc = QualifierLoc;
Chad Rosier30601782011-08-17 23:08:45 +00001011 } else {
John McCallb6217662010-03-15 10:12:16 +00001012 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
John McCallb6217662010-03-15 10:12:16 +00001013 if (hasExtInfo()) {
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00001014 if (getExtInfo()->NumTemplParamLists == 0) {
1015 // Save type source info pointer.
1016 TypeSourceInfo *savedTInfo = getExtInfo()->TInfo;
1017 // Deallocate the extended decl info.
1018 getASTContext().Deallocate(getExtInfo());
1019 // Restore savedTInfo into (non-extended) decl info.
1020 DeclInfo = savedTInfo;
1021 }
1022 else
1023 getExtInfo()->QualifierLoc = QualifierLoc;
John McCallb6217662010-03-15 10:12:16 +00001024 }
1025 }
1026}
1027
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00001028void
1029DeclaratorDecl::setTemplateParameterListsInfo(ASTContext &Context,
1030 unsigned NumTPLists,
1031 TemplateParameterList **TPLists) {
1032 assert(NumTPLists > 0);
1033 // Make sure the extended decl info is allocated.
1034 if (!hasExtInfo()) {
1035 // Save (non-extended) type source info pointer.
1036 TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
1037 // Allocate external info struct.
1038 DeclInfo = new (getASTContext()) ExtInfo;
1039 // Restore savedTInfo into (extended) decl info.
1040 getExtInfo()->TInfo = savedTInfo;
1041 }
1042 // Set the template parameter lists info.
1043 getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
1044}
1045
Douglas Gregor1693e152010-07-06 18:42:40 +00001046SourceLocation DeclaratorDecl::getOuterLocStart() const {
1047 return getTemplateOrInnerLocStart(this);
1048}
1049
Abramo Bagnaraa2026c92011-03-08 16:41:52 +00001050namespace {
1051
1052// Helper function: returns true if QT is or contains a type
1053// having a postfix component.
1054bool typeIsPostfix(clang::QualType QT) {
1055 while (true) {
1056 const Type* T = QT.getTypePtr();
1057 switch (T->getTypeClass()) {
1058 default:
1059 return false;
1060 case Type::Pointer:
1061 QT = cast<PointerType>(T)->getPointeeType();
1062 break;
1063 case Type::BlockPointer:
1064 QT = cast<BlockPointerType>(T)->getPointeeType();
1065 break;
1066 case Type::MemberPointer:
1067 QT = cast<MemberPointerType>(T)->getPointeeType();
1068 break;
1069 case Type::LValueReference:
1070 case Type::RValueReference:
1071 QT = cast<ReferenceType>(T)->getPointeeType();
1072 break;
1073 case Type::PackExpansion:
1074 QT = cast<PackExpansionType>(T)->getPattern();
1075 break;
1076 case Type::Paren:
1077 case Type::ConstantArray:
1078 case Type::DependentSizedArray:
1079 case Type::IncompleteArray:
1080 case Type::VariableArray:
1081 case Type::FunctionProto:
1082 case Type::FunctionNoProto:
1083 return true;
1084 }
1085 }
1086}
1087
1088} // namespace
1089
1090SourceRange DeclaratorDecl::getSourceRange() const {
1091 SourceLocation RangeEnd = getLocation();
1092 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
1093 if (typeIsPostfix(TInfo->getType()))
1094 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
1095 }
1096 return SourceRange(getOuterLocStart(), RangeEnd);
1097}
1098
Abramo Bagnara9b934882010-06-12 08:15:14 +00001099void
Douglas Gregorc722ea42010-06-15 17:44:38 +00001100QualifierInfo::setTemplateParameterListsInfo(ASTContext &Context,
1101 unsigned NumTPLists,
Abramo Bagnara9b934882010-06-12 08:15:14 +00001102 TemplateParameterList **TPLists) {
1103 assert((NumTPLists == 0 || TPLists != 0) &&
1104 "Empty array of template parameters with positive size!");
Abramo Bagnara9b934882010-06-12 08:15:14 +00001105
1106 // Free previous template parameters (if any).
1107 if (NumTemplParamLists > 0) {
Douglas Gregorc722ea42010-06-15 17:44:38 +00001108 Context.Deallocate(TemplParamLists);
Abramo Bagnara9b934882010-06-12 08:15:14 +00001109 TemplParamLists = 0;
1110 NumTemplParamLists = 0;
1111 }
1112 // Set info on matched template parameter lists (if any).
1113 if (NumTPLists > 0) {
Douglas Gregorc722ea42010-06-15 17:44:38 +00001114 TemplParamLists = new (Context) TemplateParameterList*[NumTPLists];
Abramo Bagnara9b934882010-06-12 08:15:14 +00001115 NumTemplParamLists = NumTPLists;
1116 for (unsigned i = NumTPLists; i-- > 0; )
1117 TemplParamLists[i] = TPLists[i];
1118 }
1119}
1120
Argyrios Kyrtzidisa5d82002009-08-21 00:31:54 +00001121//===----------------------------------------------------------------------===//
Nuno Lopes99f06ba2008-12-17 23:39:55 +00001122// VarDecl Implementation
1123//===----------------------------------------------------------------------===//
1124
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001125const char *VarDecl::getStorageClassSpecifierString(StorageClass SC) {
1126 switch (SC) {
Peter Collingbourne8c25fc52011-09-19 21:14:35 +00001127 case SC_None: break;
Peter Collingbourne8be0c742011-09-20 12:40:26 +00001128 case SC_Auto: return "auto";
1129 case SC_Extern: return "extern";
1130 case SC_OpenCLWorkGroupLocal: return "<<work-group-local>>";
1131 case SC_PrivateExtern: return "__private_extern__";
1132 case SC_Register: return "register";
1133 case SC_Static: return "static";
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001134 }
1135
Peter Collingbourne8be0c742011-09-20 12:40:26 +00001136 llvm_unreachable("Invalid storage class");
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001137 return 0;
1138}
1139
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00001140VarDecl *VarDecl::Create(ASTContext &C, DeclContext *DC,
1141 SourceLocation StartL, SourceLocation IdL,
John McCalla93c9342009-12-07 02:54:59 +00001142 IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
Douglas Gregor16573fa2010-04-19 22:54:31 +00001143 StorageClass S, StorageClass SCAsWritten) {
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00001144 return new (C) VarDecl(Var, DC, StartL, IdL, Id, T, TInfo, S, SCAsWritten);
Nuno Lopes99f06ba2008-12-17 23:39:55 +00001145}
1146
Douglas Gregor381d34e2010-12-06 18:36:25 +00001147void VarDecl::setStorageClass(StorageClass SC) {
1148 assert(isLegalForVariable(SC));
1149 if (getStorageClass() != SC)
1150 ClearLinkageCache();
1151
John McCallf1e4fbf2011-05-01 02:13:58 +00001152 VarDeclBits.SClass = SC;
Douglas Gregor381d34e2010-12-06 18:36:25 +00001153}
1154
Douglas Gregor1693e152010-07-06 18:42:40 +00001155SourceRange VarDecl::getSourceRange() const {
Argyrios Kyrtzidis55d608c2009-06-20 08:09:14 +00001156 if (getInit())
Douglas Gregor1693e152010-07-06 18:42:40 +00001157 return SourceRange(getOuterLocStart(), getInit()->getLocEnd());
Abramo Bagnaraa2026c92011-03-08 16:41:52 +00001158 return DeclaratorDecl::getSourceRange();
Argyrios Kyrtzidis55d608c2009-06-20 08:09:14 +00001159}
1160
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001161bool VarDecl::isExternC() const {
1162 ASTContext &Context = getASTContext();
1163 if (!Context.getLangOptions().CPlusPlus)
1164 return (getDeclContext()->isTranslationUnit() &&
John McCalld931b082010-08-26 03:08:43 +00001165 getStorageClass() != SC_Static) ||
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001166 (getDeclContext()->isFunctionOrMethod() && hasExternalStorage());
1167
Chandler Carruth10aad442011-02-25 00:05:02 +00001168 const DeclContext *DC = getDeclContext();
1169 if (DC->isFunctionOrMethod())
1170 return false;
1171
1172 for (; !DC->isTranslationUnit(); DC = DC->getParent()) {
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001173 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
1174 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
John McCalld931b082010-08-26 03:08:43 +00001175 return getStorageClass() != SC_Static;
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001176
1177 break;
1178 }
1179
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001180 }
1181
1182 return false;
1183}
1184
1185VarDecl *VarDecl::getCanonicalDecl() {
1186 return getFirstDeclaration();
1187}
1188
Sebastian Redle9d12b62010-01-31 22:27:38 +00001189VarDecl::DefinitionKind VarDecl::isThisDeclarationADefinition() const {
1190 // C++ [basic.def]p2:
1191 // A declaration is a definition unless [...] it contains the 'extern'
1192 // specifier or a linkage-specification and neither an initializer [...],
1193 // it declares a static data member in a class declaration [...].
1194 // C++ [temp.expl.spec]p15:
1195 // An explicit specialization of a static data member of a template is a
1196 // definition if the declaration includes an initializer; otherwise, it is
1197 // a declaration.
1198 if (isStaticDataMember()) {
1199 if (isOutOfLine() && (hasInit() ||
1200 getTemplateSpecializationKind() != TSK_ExplicitSpecialization))
1201 return Definition;
1202 else
1203 return DeclarationOnly;
1204 }
1205 // C99 6.7p5:
1206 // A definition of an identifier is a declaration for that identifier that
1207 // [...] causes storage to be reserved for that object.
1208 // Note: that applies for all non-file-scope objects.
1209 // C99 6.9.2p1:
1210 // If the declaration of an identifier for an object has file scope and an
1211 // initializer, the declaration is an external definition for the identifier
1212 if (hasInit())
1213 return Definition;
1214 // AST for 'extern "C" int foo;' is annotated with 'extern'.
1215 if (hasExternalStorage())
1216 return DeclarationOnly;
Fariborz Jahanian2bf6d7b2010-06-21 16:08:37 +00001217
John McCalld931b082010-08-26 03:08:43 +00001218 if (getStorageClassAsWritten() == SC_Extern ||
1219 getStorageClassAsWritten() == SC_PrivateExtern) {
Fariborz Jahanian2bf6d7b2010-06-21 16:08:37 +00001220 for (const VarDecl *PrevVar = getPreviousDeclaration();
1221 PrevVar; PrevVar = PrevVar->getPreviousDeclaration()) {
1222 if (PrevVar->getLinkage() == InternalLinkage && PrevVar->hasInit())
1223 return DeclarationOnly;
1224 }
1225 }
Sebastian Redle9d12b62010-01-31 22:27:38 +00001226 // C99 6.9.2p2:
1227 // A declaration of an object that has file scope without an initializer,
1228 // and without a storage class specifier or the scs 'static', constitutes
1229 // a tentative definition.
1230 // No such thing in C++.
1231 if (!getASTContext().getLangOptions().CPlusPlus && isFileVarDecl())
1232 return TentativeDefinition;
1233
1234 // What's left is (in C, block-scope) declarations without initializers or
1235 // external storage. These are definitions.
1236 return Definition;
1237}
1238
Sebastian Redle9d12b62010-01-31 22:27:38 +00001239VarDecl *VarDecl::getActingDefinition() {
1240 DefinitionKind Kind = isThisDeclarationADefinition();
1241 if (Kind != TentativeDefinition)
1242 return 0;
1243
Chris Lattnerf0ed9ef2010-06-14 18:31:46 +00001244 VarDecl *LastTentative = 0;
Sebastian Redle9d12b62010-01-31 22:27:38 +00001245 VarDecl *First = getFirstDeclaration();
1246 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1247 I != E; ++I) {
1248 Kind = (*I)->isThisDeclarationADefinition();
1249 if (Kind == Definition)
1250 return 0;
1251 else if (Kind == TentativeDefinition)
1252 LastTentative = *I;
1253 }
1254 return LastTentative;
1255}
1256
1257bool VarDecl::isTentativeDefinitionNow() const {
1258 DefinitionKind Kind = isThisDeclarationADefinition();
1259 if (Kind != TentativeDefinition)
1260 return false;
1261
1262 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1263 if ((*I)->isThisDeclarationADefinition() == Definition)
1264 return false;
1265 }
Sebastian Redl31310a22010-02-01 20:16:42 +00001266 return true;
Sebastian Redle9d12b62010-01-31 22:27:38 +00001267}
1268
Sebastian Redl31310a22010-02-01 20:16:42 +00001269VarDecl *VarDecl::getDefinition() {
Sebastian Redle2c52d22010-02-02 17:55:12 +00001270 VarDecl *First = getFirstDeclaration();
1271 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1272 I != E; ++I) {
Sebastian Redl31310a22010-02-01 20:16:42 +00001273 if ((*I)->isThisDeclarationADefinition() == Definition)
1274 return *I;
1275 }
1276 return 0;
1277}
1278
John McCall110e8e52010-10-29 22:22:43 +00001279VarDecl::DefinitionKind VarDecl::hasDefinition() const {
1280 DefinitionKind Kind = DeclarationOnly;
1281
1282 const VarDecl *First = getFirstDeclaration();
1283 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1284 I != E; ++I)
1285 Kind = std::max(Kind, (*I)->isThisDeclarationADefinition());
1286
1287 return Kind;
1288}
1289
Sebastian Redl31310a22010-02-01 20:16:42 +00001290const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001291 redecl_iterator I = redecls_begin(), E = redecls_end();
1292 while (I != E && !I->getInit())
1293 ++I;
1294
1295 if (I != E) {
Sebastian Redl31310a22010-02-01 20:16:42 +00001296 D = *I;
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001297 return I->getInit();
1298 }
1299 return 0;
1300}
1301
Douglas Gregor1028c9f2009-10-14 21:29:40 +00001302bool VarDecl::isOutOfLine() const {
Douglas Gregorda2142f2011-02-19 18:51:44 +00001303 if (Decl::isOutOfLine())
Douglas Gregor1028c9f2009-10-14 21:29:40 +00001304 return true;
Chandler Carruth8761d682010-02-21 07:08:09 +00001305
1306 if (!isStaticDataMember())
1307 return false;
1308
Douglas Gregor1028c9f2009-10-14 21:29:40 +00001309 // If this static data member was instantiated from a static data member of
1310 // a class template, check whether that static data member was defined
1311 // out-of-line.
1312 if (VarDecl *VD = getInstantiatedFromStaticDataMember())
1313 return VD->isOutOfLine();
1314
1315 return false;
1316}
1317
Douglas Gregor0d035142009-10-27 18:42:08 +00001318VarDecl *VarDecl::getOutOfLineDefinition() {
1319 if (!isStaticDataMember())
1320 return 0;
1321
1322 for (VarDecl::redecl_iterator RD = redecls_begin(), RDEnd = redecls_end();
1323 RD != RDEnd; ++RD) {
1324 if (RD->getLexicalDeclContext()->isFileContext())
1325 return *RD;
1326 }
1327
1328 return 0;
1329}
1330
Douglas Gregor838db382010-02-11 01:19:42 +00001331void VarDecl::setInit(Expr *I) {
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001332 if (EvaluatedStmt *Eval = Init.dyn_cast<EvaluatedStmt *>()) {
1333 Eval->~EvaluatedStmt();
Douglas Gregor838db382010-02-11 01:19:42 +00001334 getASTContext().Deallocate(Eval);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001335 }
1336
1337 Init = I;
1338}
1339
Douglas Gregor03e80032011-06-21 17:03:29 +00001340bool VarDecl::extendsLifetimeOfTemporary() const {
Douglas Gregor0b581082011-06-21 18:20:46 +00001341 assert(getType()->isReferenceType() &&"Non-references never extend lifetime");
Douglas Gregor03e80032011-06-21 17:03:29 +00001342
1343 const Expr *E = getInit();
1344 if (!E)
1345 return false;
1346
1347 if (const ExprWithCleanups *Cleanups = dyn_cast<ExprWithCleanups>(E))
1348 E = Cleanups->getSubExpr();
1349
1350 return isa<MaterializeTemporaryExpr>(E);
1351}
1352
Douglas Gregor1028c9f2009-10-14 21:29:40 +00001353VarDecl *VarDecl::getInstantiatedFromStaticDataMember() const {
Douglas Gregorb3ae4fc2009-10-12 20:18:28 +00001354 if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
Douglas Gregor251b4ff2009-10-08 07:24:58 +00001355 return cast<VarDecl>(MSI->getInstantiatedFrom());
1356
1357 return 0;
1358}
1359
Douglas Gregor663b5a02009-10-14 20:14:33 +00001360TemplateSpecializationKind VarDecl::getTemplateSpecializationKind() const {
Sebastian Redle9d12b62010-01-31 22:27:38 +00001361 if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
Douglas Gregor251b4ff2009-10-08 07:24:58 +00001362 return MSI->getTemplateSpecializationKind();
1363
1364 return TSK_Undeclared;
1365}
1366
Douglas Gregor1028c9f2009-10-14 21:29:40 +00001367MemberSpecializationInfo *VarDecl::getMemberSpecializationInfo() const {
Douglas Gregorb3ae4fc2009-10-12 20:18:28 +00001368 return getASTContext().getInstantiatedFromStaticDataMember(this);
1369}
1370
Douglas Gregor0a897e32009-10-15 17:21:20 +00001371void VarDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
1372 SourceLocation PointOfInstantiation) {
Douglas Gregorb3ae4fc2009-10-12 20:18:28 +00001373 MemberSpecializationInfo *MSI = getMemberSpecializationInfo();
Douglas Gregor251b4ff2009-10-08 07:24:58 +00001374 assert(MSI && "Not an instantiated static data member?");
1375 MSI->setTemplateSpecializationKind(TSK);
Douglas Gregor0a897e32009-10-15 17:21:20 +00001376 if (TSK != TSK_ExplicitSpecialization &&
1377 PointOfInstantiation.isValid() &&
1378 MSI->getPointOfInstantiation().isInvalid())
1379 MSI->setPointOfInstantiation(PointOfInstantiation);
Douglas Gregor7caa6822009-07-24 20:34:43 +00001380}
1381
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001382//===----------------------------------------------------------------------===//
1383// ParmVarDecl Implementation
1384//===----------------------------------------------------------------------===//
Douglas Gregor275a3692009-03-10 23:43:53 +00001385
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001386ParmVarDecl *ParmVarDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00001387 SourceLocation StartLoc,
1388 SourceLocation IdLoc, IdentifierInfo *Id,
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001389 QualType T, TypeSourceInfo *TInfo,
Douglas Gregor16573fa2010-04-19 22:54:31 +00001390 StorageClass S, StorageClass SCAsWritten,
1391 Expr *DefArg) {
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00001392 return new (C) ParmVarDecl(ParmVar, DC, StartLoc, IdLoc, Id, T, TInfo,
Douglas Gregor16573fa2010-04-19 22:54:31 +00001393 S, SCAsWritten, DefArg);
Douglas Gregor275a3692009-03-10 23:43:53 +00001394}
1395
Argyrios Kyrtzidis0bfe83b2011-07-30 17:23:26 +00001396SourceRange ParmVarDecl::getSourceRange() const {
1397 if (!hasInheritedDefaultArg()) {
1398 SourceRange ArgRange = getDefaultArgRange();
1399 if (ArgRange.isValid())
1400 return SourceRange(getOuterLocStart(), ArgRange.getEnd());
1401 }
1402
1403 return DeclaratorDecl::getSourceRange();
1404}
1405
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001406Expr *ParmVarDecl::getDefaultArg() {
1407 assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
1408 assert(!hasUninstantiatedDefaultArg() &&
1409 "Default argument is not yet instantiated!");
1410
1411 Expr *Arg = getInit();
John McCall4765fa02010-12-06 08:20:24 +00001412 if (ExprWithCleanups *E = dyn_cast_or_null<ExprWithCleanups>(Arg))
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001413 return E->getSubExpr();
Douglas Gregor275a3692009-03-10 23:43:53 +00001414
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001415 return Arg;
1416}
1417
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001418SourceRange ParmVarDecl::getDefaultArgRange() const {
1419 if (const Expr *E = getInit())
1420 return E->getSourceRange();
1421
1422 if (hasUninstantiatedDefaultArg())
1423 return getUninstantiatedDefaultArg()->getSourceRange();
1424
1425 return SourceRange();
Argyrios Kyrtzidisfc7e2a82009-07-05 22:21:56 +00001426}
1427
Douglas Gregor1fe85ea2011-01-05 21:11:38 +00001428bool ParmVarDecl::isParameterPack() const {
1429 return isa<PackExpansionType>(getType());
1430}
1431
Ted Kremenekd211cb72011-10-06 05:00:56 +00001432void ParmVarDecl::setParameterIndexLarge(unsigned parameterIndex) {
1433 getASTContext().setParameterIndex(this, parameterIndex);
1434 ParmVarDeclBits.ParameterIndex = ParameterIndexSentinel;
1435}
1436
1437unsigned ParmVarDecl::getParameterIndexLarge() const {
1438 return getASTContext().getParameterIndex(this);
1439}
1440
Nuno Lopes99f06ba2008-12-17 23:39:55 +00001441//===----------------------------------------------------------------------===//
Chris Lattner8a934232008-03-31 00:36:02 +00001442// FunctionDecl Implementation
1443//===----------------------------------------------------------------------===//
1444
Douglas Gregorda2142f2011-02-19 18:51:44 +00001445void FunctionDecl::getNameForDiagnostic(std::string &S,
1446 const PrintingPolicy &Policy,
1447 bool Qualified) const {
1448 NamedDecl::getNameForDiagnostic(S, Policy, Qualified);
1449 const TemplateArgumentList *TemplateArgs = getTemplateSpecializationArgs();
1450 if (TemplateArgs)
1451 S += TemplateSpecializationType::PrintTemplateArgumentList(
1452 TemplateArgs->data(),
1453 TemplateArgs->size(),
1454 Policy);
1455
1456}
1457
Ted Kremenek9498d382010-04-29 16:49:01 +00001458bool FunctionDecl::isVariadic() const {
1459 if (const FunctionProtoType *FT = getType()->getAs<FunctionProtoType>())
1460 return FT->isVariadic();
1461 return false;
1462}
1463
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001464bool FunctionDecl::hasBody(const FunctionDecl *&Definition) const {
1465 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
Francois Pichet8387e2a2011-04-22 22:18:13 +00001466 if (I->Body || I->IsLateTemplateParsed) {
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001467 Definition = *I;
1468 return true;
1469 }
1470 }
1471
1472 return false;
1473}
1474
Anders Carlssonffb945f2011-05-14 23:26:09 +00001475bool FunctionDecl::hasTrivialBody() const
1476{
1477 Stmt *S = getBody();
1478 if (!S) {
1479 // Since we don't have a body for this function, we don't know if it's
1480 // trivial or not.
1481 return false;
1482 }
1483
1484 if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
1485 return true;
1486 return false;
1487}
1488
Sean Hunt10620eb2011-05-06 20:44:56 +00001489bool FunctionDecl::isDefined(const FunctionDecl *&Definition) const {
1490 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
Sean Huntcd10dec2011-05-23 23:14:04 +00001491 if (I->IsDeleted || I->IsDefaulted || I->Body || I->IsLateTemplateParsed) {
Sean Hunt10620eb2011-05-06 20:44:56 +00001492 Definition = I->IsDeleted ? I->getCanonicalDecl() : *I;
1493 return true;
1494 }
1495 }
1496
1497 return false;
1498}
1499
Argyrios Kyrtzidis6fb0aee2009-06-30 02:35:26 +00001500Stmt *FunctionDecl::getBody(const FunctionDecl *&Definition) const {
Argyrios Kyrtzidisc37929c2009-07-14 03:20:21 +00001501 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1502 if (I->Body) {
1503 Definition = *I;
1504 return I->Body.get(getASTContext().getExternalSource());
Francois Pichet8387e2a2011-04-22 22:18:13 +00001505 } else if (I->IsLateTemplateParsed) {
1506 Definition = *I;
1507 return 0;
Douglas Gregorf0097952008-04-21 02:02:58 +00001508 }
1509 }
1510
1511 return 0;
Reid Spencer5f016e22007-07-11 17:01:13 +00001512}
1513
Argyrios Kyrtzidis55d608c2009-06-20 08:09:14 +00001514void FunctionDecl::setBody(Stmt *B) {
1515 Body = B;
Douglas Gregorb5f35ba2010-12-06 17:49:01 +00001516 if (B)
Argyrios Kyrtzidis55d608c2009-06-20 08:09:14 +00001517 EndRangeLoc = B->getLocEnd();
1518}
1519
Douglas Gregor21386642010-09-28 21:55:22 +00001520void FunctionDecl::setPure(bool P) {
1521 IsPure = P;
1522 if (P)
1523 if (CXXRecordDecl *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
1524 Parent->markedVirtualFunctionPure();
1525}
1526
Douglas Gregor48a83b52009-09-12 00:17:51 +00001527bool FunctionDecl::isMain() const {
John McCall23c608d2011-05-15 17:49:20 +00001528 const TranslationUnitDecl *tunit =
1529 dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
1530 return tunit &&
Sean Hunt55878032011-05-15 20:59:31 +00001531 !tunit->getASTContext().getLangOptions().Freestanding &&
John McCall23c608d2011-05-15 17:49:20 +00001532 getIdentifier() &&
1533 getIdentifier()->isStr("main");
1534}
1535
1536bool FunctionDecl::isReservedGlobalPlacementOperator() const {
1537 assert(getDeclName().getNameKind() == DeclarationName::CXXOperatorName);
1538 assert(getDeclName().getCXXOverloadedOperator() == OO_New ||
1539 getDeclName().getCXXOverloadedOperator() == OO_Delete ||
1540 getDeclName().getCXXOverloadedOperator() == OO_Array_New ||
1541 getDeclName().getCXXOverloadedOperator() == OO_Array_Delete);
1542
1543 if (isa<CXXRecordDecl>(getDeclContext())) return false;
1544 assert(getDeclContext()->getRedeclContext()->isTranslationUnit());
1545
1546 const FunctionProtoType *proto = getType()->castAs<FunctionProtoType>();
1547 if (proto->getNumArgs() != 2 || proto->isVariadic()) return false;
1548
1549 ASTContext &Context =
1550 cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext())
1551 ->getASTContext();
1552
1553 // The result type and first argument type are constant across all
1554 // these operators. The second argument must be exactly void*.
1555 return (proto->getArgType(1).getCanonicalType() == Context.VoidPtrTy);
Douglas Gregor04495c82009-02-24 01:23:02 +00001556}
1557
Douglas Gregor48a83b52009-09-12 00:17:51 +00001558bool FunctionDecl::isExternC() const {
1559 ASTContext &Context = getASTContext();
Douglas Gregor63935192009-03-02 00:19:53 +00001560 // In C, any non-static, non-overloadable function has external
1561 // linkage.
1562 if (!Context.getLangOptions().CPlusPlus)
John McCalld931b082010-08-26 03:08:43 +00001563 return getStorageClass() != SC_Static && !getAttr<OverloadableAttr>();
Douglas Gregor63935192009-03-02 00:19:53 +00001564
Chandler Carruth10aad442011-02-25 00:05:02 +00001565 const DeclContext *DC = getDeclContext();
1566 if (DC->isRecord())
1567 return false;
1568
1569 for (; !DC->isTranslationUnit(); DC = DC->getParent()) {
Douglas Gregor63935192009-03-02 00:19:53 +00001570 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
1571 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
John McCalld931b082010-08-26 03:08:43 +00001572 return getStorageClass() != SC_Static &&
Argyrios Kyrtzidis40b598e2009-06-30 02:34:44 +00001573 !getAttr<OverloadableAttr>();
Douglas Gregor63935192009-03-02 00:19:53 +00001574
1575 break;
1576 }
1577 }
1578
Douglas Gregor0bab54c2010-10-21 16:57:46 +00001579 return isMain();
Douglas Gregor63935192009-03-02 00:19:53 +00001580}
1581
Douglas Gregor8499f3f2009-03-31 16:35:03 +00001582bool FunctionDecl::isGlobal() const {
1583 if (const CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(this))
1584 return Method->isStatic();
1585
John McCalld931b082010-08-26 03:08:43 +00001586 if (getStorageClass() == SC_Static)
Douglas Gregor8499f3f2009-03-31 16:35:03 +00001587 return false;
1588
Mike Stump1eb44332009-09-09 15:08:12 +00001589 for (const DeclContext *DC = getDeclContext();
Douglas Gregor8499f3f2009-03-31 16:35:03 +00001590 DC->isNamespace();
1591 DC = DC->getParent()) {
1592 if (const NamespaceDecl *Namespace = cast<NamespaceDecl>(DC)) {
1593 if (!Namespace->getDeclName())
1594 return false;
1595 break;
1596 }
1597 }
1598
1599 return true;
1600}
1601
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001602void
1603FunctionDecl::setPreviousDeclaration(FunctionDecl *PrevDecl) {
1604 redeclarable_base::setPreviousDeclaration(PrevDecl);
1605
1606 if (FunctionTemplateDecl *FunTmpl = getDescribedFunctionTemplate()) {
1607 FunctionTemplateDecl *PrevFunTmpl
1608 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : 0;
1609 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
1610 FunTmpl->setPreviousDeclaration(PrevFunTmpl);
1611 }
Douglas Gregor8f150942010-12-09 16:59:22 +00001612
Axel Naumannd9d137e2011-11-08 18:21:06 +00001613 if (PrevDecl && PrevDecl->IsInline)
Douglas Gregor8f150942010-12-09 16:59:22 +00001614 IsInline = true;
Sebastian Redl7783bfc2010-01-26 22:01:41 +00001615}
1616
1617const FunctionDecl *FunctionDecl::getCanonicalDecl() const {
1618 return getFirstDeclaration();
1619}
1620
1621FunctionDecl *FunctionDecl::getCanonicalDecl() {
1622 return getFirstDeclaration();
1623}
1624
Douglas Gregor381d34e2010-12-06 18:36:25 +00001625void FunctionDecl::setStorageClass(StorageClass SC) {
1626 assert(isLegalForFunction(SC));
1627 if (getStorageClass() != SC)
1628 ClearLinkageCache();
1629
1630 SClass = SC;
1631}
1632
Douglas Gregor3e41d602009-02-13 23:20:09 +00001633/// \brief Returns a value indicating whether this function
1634/// corresponds to a builtin function.
1635///
1636/// The function corresponds to a built-in function if it is
1637/// declared at translation scope or within an extern "C" block and
1638/// its name matches with the name of a builtin. The returned value
1639/// will be 0 for functions that do not correspond to a builtin, a
Mike Stump1eb44332009-09-09 15:08:12 +00001640/// value of type \c Builtin::ID if in the target-independent range
Douglas Gregor3e41d602009-02-13 23:20:09 +00001641/// \c [1,Builtin::First), or a target-specific builtin value.
Douglas Gregor7814e6d2009-09-12 00:22:50 +00001642unsigned FunctionDecl::getBuiltinID() const {
1643 ASTContext &Context = getASTContext();
Douglas Gregor3c385e52009-02-14 18:57:46 +00001644 if (!getIdentifier() || !getIdentifier()->getBuiltinID())
1645 return 0;
1646
1647 unsigned BuiltinID = getIdentifier()->getBuiltinID();
1648 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
1649 return BuiltinID;
1650
1651 // This function has the name of a known C library
1652 // function. Determine whether it actually refers to the C library
1653 // function or whether it just has the same name.
1654
Douglas Gregor9add3172009-02-17 03:23:10 +00001655 // If this is a static function, it's not a builtin.
John McCalld931b082010-08-26 03:08:43 +00001656 if (getStorageClass() == SC_Static)
Douglas Gregor9add3172009-02-17 03:23:10 +00001657 return 0;
1658
Douglas Gregor3c385e52009-02-14 18:57:46 +00001659 // If this function is at translation-unit scope and we're not in
1660 // C++, it refers to the C library function.
1661 if (!Context.getLangOptions().CPlusPlus &&
1662 getDeclContext()->isTranslationUnit())
1663 return BuiltinID;
1664
1665 // If the function is in an extern "C" linkage specification and is
1666 // not marked "overloadable", it's the real function.
1667 if (isa<LinkageSpecDecl>(getDeclContext()) &&
Mike Stump1eb44332009-09-09 15:08:12 +00001668 cast<LinkageSpecDecl>(getDeclContext())->getLanguage()
Douglas Gregor3c385e52009-02-14 18:57:46 +00001669 == LinkageSpecDecl::lang_c &&
Argyrios Kyrtzidis40b598e2009-06-30 02:34:44 +00001670 !getAttr<OverloadableAttr>())
Douglas Gregor3c385e52009-02-14 18:57:46 +00001671 return BuiltinID;
1672
1673 // Not a builtin
Douglas Gregor3e41d602009-02-13 23:20:09 +00001674 return 0;
1675}
1676
1677
Chris Lattner1ad9b282009-04-25 06:03:53 +00001678/// getNumParams - Return the number of parameters this function must have
Bob Wilson8dbfbf42011-01-10 18:23:55 +00001679/// based on its FunctionType. This is the length of the ParamInfo array
Chris Lattner1ad9b282009-04-25 06:03:53 +00001680/// after it has been created.
1681unsigned FunctionDecl::getNumParams() const {
John McCall183700f2009-09-21 23:43:11 +00001682 const FunctionType *FT = getType()->getAs<FunctionType>();
Douglas Gregor72564e72009-02-26 23:50:07 +00001683 if (isa<FunctionNoProtoType>(FT))
Chris Lattnerd3b90652008-03-15 05:43:15 +00001684 return 0;
Douglas Gregor72564e72009-02-26 23:50:07 +00001685 return cast<FunctionProtoType>(FT)->getNumArgs();
Mike Stump1eb44332009-09-09 15:08:12 +00001686
Reid Spencer5f016e22007-07-11 17:01:13 +00001687}
1688
Argyrios Kyrtzidis6b541512010-09-08 19:31:22 +00001689void FunctionDecl::setParams(ASTContext &C,
David Blaikie4278c652011-09-21 18:16:56 +00001690 llvm::ArrayRef<ParmVarDecl *> NewParamInfo) {
Reid Spencer5f016e22007-07-11 17:01:13 +00001691 assert(ParamInfo == 0 && "Already has param info!");
David Blaikie4278c652011-09-21 18:16:56 +00001692 assert(NewParamInfo.size() == getNumParams() && "Parameter count mismatch!");
Mike Stump1eb44332009-09-09 15:08:12 +00001693
Reid Spencer5f016e22007-07-11 17:01:13 +00001694 // Zero params -> null pointer.
David Blaikie4278c652011-09-21 18:16:56 +00001695 if (!NewParamInfo.empty()) {
1696 ParamInfo = new (C) ParmVarDecl*[NewParamInfo.size()];
1697 std::copy(NewParamInfo.begin(), NewParamInfo.end(), ParamInfo);
Reid Spencer5f016e22007-07-11 17:01:13 +00001698 }
1699}
1700
Chris Lattner8123a952008-04-10 02:22:51 +00001701/// getMinRequiredArguments - Returns the minimum number of arguments
1702/// needed to call this function. This may be fewer than the number of
1703/// function parameters, if some of the parameters have default
Douglas Gregorf5c65ff2011-01-06 22:09:01 +00001704/// arguments (in C++) or the last parameter is a parameter pack.
Chris Lattner8123a952008-04-10 02:22:51 +00001705unsigned FunctionDecl::getMinRequiredArguments() const {
Douglas Gregor7d5c0c12011-01-11 01:52:23 +00001706 if (!getASTContext().getLangOptions().CPlusPlus)
1707 return getNumParams();
1708
Douglas Gregorf5c65ff2011-01-06 22:09:01 +00001709 unsigned NumRequiredArgs = getNumParams();
1710
1711 // If the last parameter is a parameter pack, we don't need an argument for
1712 // it.
1713 if (NumRequiredArgs > 0 &&
1714 getParamDecl(NumRequiredArgs - 1)->isParameterPack())
1715 --NumRequiredArgs;
1716
1717 // If this parameter has a default argument, we don't need an argument for
1718 // it.
1719 while (NumRequiredArgs > 0 &&
1720 getParamDecl(NumRequiredArgs-1)->hasDefaultArg())
Chris Lattner8123a952008-04-10 02:22:51 +00001721 --NumRequiredArgs;
1722
Douglas Gregor7d5c0c12011-01-11 01:52:23 +00001723 // We might have parameter packs before the end. These can't be deduced,
1724 // but they can still handle multiple arguments.
1725 unsigned ArgIdx = NumRequiredArgs;
1726 while (ArgIdx > 0) {
1727 if (getParamDecl(ArgIdx - 1)->isParameterPack())
1728 NumRequiredArgs = ArgIdx;
1729
1730 --ArgIdx;
1731 }
1732
Chris Lattner8123a952008-04-10 02:22:51 +00001733 return NumRequiredArgs;
1734}
1735
Douglas Gregor7ced9c82009-10-27 21:11:48 +00001736bool FunctionDecl::isInlined() const {
Douglas Gregor8f150942010-12-09 16:59:22 +00001737 if (IsInline)
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001738 return true;
Anders Carlsson48eda2c2009-12-04 22:35:50 +00001739
1740 if (isa<CXXMethodDecl>(this)) {
1741 if (!isOutOfLine() || getCanonicalDecl()->isInlineSpecified())
1742 return true;
1743 }
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001744
1745 switch (getTemplateSpecializationKind()) {
1746 case TSK_Undeclared:
1747 case TSK_ExplicitSpecialization:
1748 return false;
1749
1750 case TSK_ImplicitInstantiation:
1751 case TSK_ExplicitInstantiationDeclaration:
1752 case TSK_ExplicitInstantiationDefinition:
1753 // Handle below.
1754 break;
1755 }
1756
1757 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001758 bool HasPattern = false;
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001759 if (PatternDecl)
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001760 HasPattern = PatternDecl->hasBody(PatternDecl);
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001761
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001762 if (HasPattern && PatternDecl)
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001763 return PatternDecl->isInlined();
1764
1765 return false;
Douglas Gregor7ced9c82009-10-27 21:11:48 +00001766}
1767
Nick Lewyckydce67a72011-07-18 05:26:13 +00001768/// \brief For a function declaration in C or C++, determine whether this
1769/// declaration causes the definition to be externally visible.
1770///
1771/// Determines whether this is the first non-inline redeclaration of an inline
1772/// function in a language where "inline" does not normally require an
1773/// externally visible definition.
1774bool FunctionDecl::doesDeclarationForceExternallyVisibleDefinition() const {
1775 assert(!doesThisDeclarationHaveABody() &&
1776 "Must have a declaration without a body.");
1777
1778 ASTContext &Context = getASTContext();
1779
1780 // In C99 mode, a function may have an inline definition (causing it to
1781 // be deferred) then redeclared later. As a special case, "extern inline"
1782 // is not required to produce an external symbol.
1783 if (Context.getLangOptions().GNUInline || !Context.getLangOptions().C99 ||
1784 Context.getLangOptions().CPlusPlus)
1785 return false;
1786 if (getLinkage() != ExternalLinkage || isInlineSpecified())
1787 return false;
Nick Lewyckyf57ef052011-07-18 07:11:55 +00001788 const FunctionDecl *Definition = 0;
1789 if (hasBody(Definition))
1790 return Definition->isInlined() &&
1791 Definition->isInlineDefinitionExternallyVisible();
Nick Lewyckydce67a72011-07-18 05:26:13 +00001792 return false;
1793}
1794
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001795/// \brief For an inline function definition in C or C++, determine whether the
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001796/// definition will be externally visible.
1797///
1798/// Inline function definitions are always available for inlining optimizations.
1799/// However, depending on the language dialect, declaration specifiers, and
1800/// attributes, the definition of an inline function may or may not be
1801/// "externally" visible to other translation units in the program.
1802///
1803/// In C99, inline definitions are not externally visible by default. However,
Mike Stump1e5fd7f2010-01-06 02:05:39 +00001804/// if even one of the global-scope declarations is marked "extern inline", the
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001805/// inline definition becomes externally visible (C99 6.7.4p6).
1806///
1807/// In GNU89 mode, or if the gnu_inline attribute is attached to the function
1808/// definition, we use the GNU semantics for inline, which are nearly the
1809/// opposite of C99 semantics. In particular, "inline" by itself will create
1810/// an externally visible symbol, but "extern inline" will not create an
1811/// externally visible symbol.
1812bool FunctionDecl::isInlineDefinitionExternallyVisible() const {
Sean Hunt10620eb2011-05-06 20:44:56 +00001813 assert(doesThisDeclarationHaveABody() && "Must have the function definition");
Douglas Gregor7ced9c82009-10-27 21:11:48 +00001814 assert(isInlined() && "Function must be inline");
Douglas Gregor7d9c3c92009-10-27 23:26:40 +00001815 ASTContext &Context = getASTContext();
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001816
Rafael Espindolafb3f4aa2011-06-02 16:13:27 +00001817 if (Context.getLangOptions().GNUInline || hasAttr<GNUInlineAttr>()) {
Douglas Gregor8f150942010-12-09 16:59:22 +00001818 // If it's not the case that both 'inline' and 'extern' are
1819 // specified on the definition, then this inline definition is
1820 // externally visible.
1821 if (!(isInlineSpecified() && getStorageClassAsWritten() == SC_Extern))
1822 return true;
1823
1824 // If any declaration is 'inline' but not 'extern', then this definition
1825 // is externally visible.
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001826 for (redecl_iterator Redecl = redecls_begin(), RedeclEnd = redecls_end();
1827 Redecl != RedeclEnd;
1828 ++Redecl) {
Douglas Gregor8f150942010-12-09 16:59:22 +00001829 if (Redecl->isInlineSpecified() &&
1830 Redecl->getStorageClassAsWritten() != SC_Extern)
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001831 return true;
Douglas Gregor8f150942010-12-09 16:59:22 +00001832 }
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001833
Douglas Gregor9f9bf252009-04-28 06:37:30 +00001834 return false;
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001835 }
1836
1837 // C99 6.7.4p6:
1838 // [...] If all of the file scope declarations for a function in a
1839 // translation unit include the inline function specifier without extern,
1840 // then the definition in that translation unit is an inline definition.
1841 for (redecl_iterator Redecl = redecls_begin(), RedeclEnd = redecls_end();
1842 Redecl != RedeclEnd;
1843 ++Redecl) {
1844 // Only consider file-scope declarations in this test.
1845 if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
1846 continue;
Eli Friedman8a1d6a52011-10-11 22:09:24 +00001847
1848 // Only consider explicit declarations; the presence of a builtin for a
1849 // libcall shouldn't affect whether a definition is externally visible.
1850 if (Redecl->isImplicit())
1851 continue;
1852
John McCalld931b082010-08-26 03:08:43 +00001853 if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
Douglas Gregor1fc09a92009-09-13 07:46:26 +00001854 return true; // Not an inline definition
1855 }
1856
1857 // C99 6.7.4p6:
1858 // An inline definition does not provide an external definition for the
1859 // function, and does not forbid an external definition in another
1860 // translation unit.
Douglas Gregor9f9bf252009-04-28 06:37:30 +00001861 return false;
1862}
1863
Douglas Gregor1cd1b1e2008-11-06 22:13:31 +00001864/// getOverloadedOperator - Which C++ overloaded operator this
1865/// function represents, if any.
1866OverloadedOperatorKind FunctionDecl::getOverloadedOperator() const {
Douglas Gregore94ca9e42008-11-18 14:39:36 +00001867 if (getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
1868 return getDeclName().getCXXOverloadedOperator();
Douglas Gregor1cd1b1e2008-11-06 22:13:31 +00001869 else
1870 return OO_None;
1871}
1872
Sean Hunta6c058d2010-01-13 09:01:02 +00001873/// getLiteralIdentifier - The literal suffix identifier this function
1874/// represents, if any.
1875const IdentifierInfo *FunctionDecl::getLiteralIdentifier() const {
1876 if (getDeclName().getNameKind() == DeclarationName::CXXLiteralOperatorName)
1877 return getDeclName().getCXXLiteralIdentifier();
1878 else
1879 return 0;
1880}
1881
Argyrios Kyrtzidisd0913552010-06-22 09:54:51 +00001882FunctionDecl::TemplatedKind FunctionDecl::getTemplatedKind() const {
1883 if (TemplateOrSpecialization.isNull())
1884 return TK_NonTemplate;
1885 if (TemplateOrSpecialization.is<FunctionTemplateDecl *>())
1886 return TK_FunctionTemplate;
1887 if (TemplateOrSpecialization.is<MemberSpecializationInfo *>())
1888 return TK_MemberSpecialization;
1889 if (TemplateOrSpecialization.is<FunctionTemplateSpecializationInfo *>())
1890 return TK_FunctionTemplateSpecialization;
1891 if (TemplateOrSpecialization.is
1892 <DependentFunctionTemplateSpecializationInfo*>())
1893 return TK_DependentFunctionTemplateSpecialization;
1894
David Blaikieb219cfc2011-09-23 05:06:16 +00001895 llvm_unreachable("Did we miss a TemplateOrSpecialization type?");
Argyrios Kyrtzidisd0913552010-06-22 09:54:51 +00001896}
1897
Douglas Gregor2db32322009-10-07 23:56:10 +00001898FunctionDecl *FunctionDecl::getInstantiatedFromMemberFunction() const {
Douglas Gregorb3ae4fc2009-10-12 20:18:28 +00001899 if (MemberSpecializationInfo *Info = getMemberSpecializationInfo())
Douglas Gregor2db32322009-10-07 23:56:10 +00001900 return cast<FunctionDecl>(Info->getInstantiatedFrom());
1901
1902 return 0;
1903}
1904
Douglas Gregorb3ae4fc2009-10-12 20:18:28 +00001905MemberSpecializationInfo *FunctionDecl::getMemberSpecializationInfo() const {
1906 return TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>();
1907}
1908
Douglas Gregor2db32322009-10-07 23:56:10 +00001909void
Argyrios Kyrtzidis6b541512010-09-08 19:31:22 +00001910FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
1911 FunctionDecl *FD,
Douglas Gregor2db32322009-10-07 23:56:10 +00001912 TemplateSpecializationKind TSK) {
1913 assert(TemplateOrSpecialization.isNull() &&
1914 "Member function is already a specialization");
1915 MemberSpecializationInfo *Info
Argyrios Kyrtzidis6b541512010-09-08 19:31:22 +00001916 = new (C) MemberSpecializationInfo(FD, TSK);
Douglas Gregor2db32322009-10-07 23:56:10 +00001917 TemplateOrSpecialization = Info;
1918}
1919
Douglas Gregor3b846b62009-10-27 20:53:28 +00001920bool FunctionDecl::isImplicitlyInstantiable() const {
Douglas Gregor6cfacfe2010-05-17 17:34:56 +00001921 // If the function is invalid, it can't be implicitly instantiated.
1922 if (isInvalidDecl())
Douglas Gregor3b846b62009-10-27 20:53:28 +00001923 return false;
1924
1925 switch (getTemplateSpecializationKind()) {
1926 case TSK_Undeclared:
Douglas Gregor3b846b62009-10-27 20:53:28 +00001927 case TSK_ExplicitInstantiationDefinition:
1928 return false;
1929
1930 case TSK_ImplicitInstantiation:
1931 return true;
1932
Francois Pichetaf0f4d02011-08-14 03:52:19 +00001933 // It is possible to instantiate TSK_ExplicitSpecialization kind
1934 // if the FunctionDecl has a class scope specialization pattern.
1935 case TSK_ExplicitSpecialization:
1936 return getClassScopeSpecializationPattern() != 0;
1937
Douglas Gregor3b846b62009-10-27 20:53:28 +00001938 case TSK_ExplicitInstantiationDeclaration:
1939 // Handled below.
1940 break;
1941 }
1942
1943 // Find the actual template from which we will instantiate.
1944 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001945 bool HasPattern = false;
Douglas Gregor3b846b62009-10-27 20:53:28 +00001946 if (PatternDecl)
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001947 HasPattern = PatternDecl->hasBody(PatternDecl);
Douglas Gregor3b846b62009-10-27 20:53:28 +00001948
1949 // C++0x [temp.explicit]p9:
1950 // Except for inline functions, other explicit instantiation declarations
1951 // have the effect of suppressing the implicit instantiation of the entity
1952 // to which they refer.
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00001953 if (!HasPattern || !PatternDecl)
Douglas Gregor3b846b62009-10-27 20:53:28 +00001954 return true;
1955
Douglas Gregor7ced9c82009-10-27 21:11:48 +00001956 return PatternDecl->isInlined();
Ted Kremenek75df4ee2011-12-01 00:59:17 +00001957}
1958
1959bool FunctionDecl::isTemplateInstantiation() const {
1960 switch (getTemplateSpecializationKind()) {
1961 case TSK_Undeclared:
1962 case TSK_ExplicitSpecialization:
1963 return false;
1964 case TSK_ImplicitInstantiation:
1965 case TSK_ExplicitInstantiationDeclaration:
1966 case TSK_ExplicitInstantiationDefinition:
1967 return true;
1968 }
1969 llvm_unreachable("All TSK values handled.");
1970}
Douglas Gregor3b846b62009-10-27 20:53:28 +00001971
1972FunctionDecl *FunctionDecl::getTemplateInstantiationPattern() const {
Francois Pichetaf0f4d02011-08-14 03:52:19 +00001973 // Handle class scope explicit specialization special case.
1974 if (getTemplateSpecializationKind() == TSK_ExplicitSpecialization)
1975 return getClassScopeSpecializationPattern();
1976
Douglas Gregor3b846b62009-10-27 20:53:28 +00001977 if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
1978 while (Primary->getInstantiatedFromMemberTemplate()) {
1979 // If we have hit a point where the user provided a specialization of
1980 // this template, we're done looking.
1981 if (Primary->isMemberSpecialization())
1982 break;
1983
1984 Primary = Primary->getInstantiatedFromMemberTemplate();
1985 }
1986
1987 return Primary->getTemplatedDecl();
1988 }
1989
1990 return getInstantiatedFromMemberFunction();
1991}
1992
Douglas Gregor16e8be22009-06-29 17:30:29 +00001993FunctionTemplateDecl *FunctionDecl::getPrimaryTemplate() const {
Mike Stump1eb44332009-09-09 15:08:12 +00001994 if (FunctionTemplateSpecializationInfo *Info
Douglas Gregor16e8be22009-06-29 17:30:29 +00001995 = TemplateOrSpecialization
1996 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
Douglas Gregor1fd2dd12009-06-29 22:39:32 +00001997 return Info->Template.getPointer();
Douglas Gregor16e8be22009-06-29 17:30:29 +00001998 }
1999 return 0;
2000}
2001
Francois Pichetaf0f4d02011-08-14 03:52:19 +00002002FunctionDecl *FunctionDecl::getClassScopeSpecializationPattern() const {
2003 return getASTContext().getClassScopeSpecializationPattern(this);
2004}
2005
Douglas Gregor16e8be22009-06-29 17:30:29 +00002006const TemplateArgumentList *
2007FunctionDecl::getTemplateSpecializationArgs() const {
Mike Stump1eb44332009-09-09 15:08:12 +00002008 if (FunctionTemplateSpecializationInfo *Info
Douglas Gregorfd056bc2009-10-13 16:30:37 +00002009 = TemplateOrSpecialization
2010 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
Douglas Gregor16e8be22009-06-29 17:30:29 +00002011 return Info->TemplateArguments;
2012 }
2013 return 0;
2014}
2015
Argyrios Kyrtzidis71a76052011-09-22 20:07:09 +00002016const ASTTemplateArgumentListInfo *
Abramo Bagnarae03db982010-05-20 15:32:11 +00002017FunctionDecl::getTemplateSpecializationArgsAsWritten() const {
2018 if (FunctionTemplateSpecializationInfo *Info
2019 = TemplateOrSpecialization
2020 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
2021 return Info->TemplateArgumentsAsWritten;
2022 }
2023 return 0;
2024}
2025
Mike Stump1eb44332009-09-09 15:08:12 +00002026void
Argyrios Kyrtzidis6b541512010-09-08 19:31:22 +00002027FunctionDecl::setFunctionTemplateSpecialization(ASTContext &C,
2028 FunctionTemplateDecl *Template,
Douglas Gregor127102b2009-06-29 20:59:39 +00002029 const TemplateArgumentList *TemplateArgs,
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002030 void *InsertPos,
Abramo Bagnarae03db982010-05-20 15:32:11 +00002031 TemplateSpecializationKind TSK,
Argyrios Kyrtzidis7b081c82010-07-05 10:37:55 +00002032 const TemplateArgumentListInfo *TemplateArgsAsWritten,
2033 SourceLocation PointOfInstantiation) {
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002034 assert(TSK != TSK_Undeclared &&
2035 "Must specify the type of function template specialization");
Mike Stump1eb44332009-09-09 15:08:12 +00002036 FunctionTemplateSpecializationInfo *Info
Douglas Gregor16e8be22009-06-29 17:30:29 +00002037 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
Douglas Gregor1637be72009-06-26 00:10:03 +00002038 if (!Info)
Argyrios Kyrtzidisa626a3d2010-09-09 11:28:23 +00002039 Info = FunctionTemplateSpecializationInfo::Create(C, this, Template, TSK,
2040 TemplateArgs,
2041 TemplateArgsAsWritten,
2042 PointOfInstantiation);
Douglas Gregor1637be72009-06-26 00:10:03 +00002043 TemplateOrSpecialization = Info;
Mike Stump1eb44332009-09-09 15:08:12 +00002044
Douglas Gregor127102b2009-06-29 20:59:39 +00002045 // Insert this function template specialization into the set of known
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002046 // function template specializations.
2047 if (InsertPos)
Sebastian Redl5bbcdbf2011-04-14 14:07:59 +00002048 Template->addSpecialization(Info, InsertPos);
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002049 else {
Argyrios Kyrtzidis2c853e42010-07-20 13:59:58 +00002050 // Try to insert the new node. If there is an existing node, leave it, the
2051 // set will contain the canonical decls while
2052 // FunctionTemplateDecl::findSpecialization will return
2053 // the most recent redeclarations.
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002054 FunctionTemplateSpecializationInfo *Existing
2055 = Template->getSpecializations().GetOrInsertNode(Info);
Argyrios Kyrtzidis2c853e42010-07-20 13:59:58 +00002056 (void)Existing;
2057 assert((!Existing || Existing->Function->isCanonicalDecl()) &&
2058 "Set is supposed to only contain canonical decls");
Douglas Gregorb9aa6b22009-09-24 23:14:47 +00002059 }
Douglas Gregor1637be72009-06-26 00:10:03 +00002060}
2061
John McCallaf2094e2010-04-08 09:05:18 +00002062void
2063FunctionDecl::setDependentTemplateSpecialization(ASTContext &Context,
2064 const UnresolvedSetImpl &Templates,
2065 const TemplateArgumentListInfo &TemplateArgs) {
2066 assert(TemplateOrSpecialization.isNull());
2067 size_t Size = sizeof(DependentFunctionTemplateSpecializationInfo);
2068 Size += Templates.size() * sizeof(FunctionTemplateDecl*);
John McCall21c01602010-04-13 22:18:28 +00002069 Size += TemplateArgs.size() * sizeof(TemplateArgumentLoc);
John McCallaf2094e2010-04-08 09:05:18 +00002070 void *Buffer = Context.Allocate(Size);
2071 DependentFunctionTemplateSpecializationInfo *Info =
2072 new (Buffer) DependentFunctionTemplateSpecializationInfo(Templates,
2073 TemplateArgs);
2074 TemplateOrSpecialization = Info;
2075}
2076
2077DependentFunctionTemplateSpecializationInfo::
2078DependentFunctionTemplateSpecializationInfo(const UnresolvedSetImpl &Ts,
2079 const TemplateArgumentListInfo &TArgs)
2080 : AngleLocs(TArgs.getLAngleLoc(), TArgs.getRAngleLoc()) {
2081
2082 d.NumTemplates = Ts.size();
2083 d.NumArgs = TArgs.size();
2084
2085 FunctionTemplateDecl **TsArray =
2086 const_cast<FunctionTemplateDecl**>(getTemplates());
2087 for (unsigned I = 0, E = Ts.size(); I != E; ++I)
2088 TsArray[I] = cast<FunctionTemplateDecl>(Ts[I]->getUnderlyingDecl());
2089
2090 TemplateArgumentLoc *ArgsArray =
2091 const_cast<TemplateArgumentLoc*>(getTemplateArgs());
2092 for (unsigned I = 0, E = TArgs.size(); I != E; ++I)
2093 new (&ArgsArray[I]) TemplateArgumentLoc(TArgs[I]);
2094}
2095
Douglas Gregord0e3daf2009-09-04 22:48:11 +00002096TemplateSpecializationKind FunctionDecl::getTemplateSpecializationKind() const {
Mike Stump1eb44332009-09-09 15:08:12 +00002097 // For a function template specialization, query the specialization
Douglas Gregord0e3daf2009-09-04 22:48:11 +00002098 // information object.
Douglas Gregor2db32322009-10-07 23:56:10 +00002099 FunctionTemplateSpecializationInfo *FTSInfo
Douglas Gregor1fd2dd12009-06-29 22:39:32 +00002100 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
Douglas Gregor2db32322009-10-07 23:56:10 +00002101 if (FTSInfo)
2102 return FTSInfo->getTemplateSpecializationKind();
Mike Stump1eb44332009-09-09 15:08:12 +00002103
Douglas Gregor2db32322009-10-07 23:56:10 +00002104 MemberSpecializationInfo *MSInfo
2105 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>();
2106 if (MSInfo)
2107 return MSInfo->getTemplateSpecializationKind();
2108
2109 return TSK_Undeclared;
Douglas Gregord0e3daf2009-09-04 22:48:11 +00002110}
2111
Mike Stump1eb44332009-09-09 15:08:12 +00002112void
Douglas Gregor0a897e32009-10-15 17:21:20 +00002113FunctionDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
2114 SourceLocation PointOfInstantiation) {
2115 if (FunctionTemplateSpecializationInfo *FTSInfo
2116 = TemplateOrSpecialization.dyn_cast<
2117 FunctionTemplateSpecializationInfo*>()) {
2118 FTSInfo->setTemplateSpecializationKind(TSK);
2119 if (TSK != TSK_ExplicitSpecialization &&
2120 PointOfInstantiation.isValid() &&
2121 FTSInfo->getPointOfInstantiation().isInvalid())
2122 FTSInfo->setPointOfInstantiation(PointOfInstantiation);
2123 } else if (MemberSpecializationInfo *MSInfo
2124 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>()) {
2125 MSInfo->setTemplateSpecializationKind(TSK);
2126 if (TSK != TSK_ExplicitSpecialization &&
2127 PointOfInstantiation.isValid() &&
2128 MSInfo->getPointOfInstantiation().isInvalid())
2129 MSInfo->setPointOfInstantiation(PointOfInstantiation);
2130 } else
David Blaikieb219cfc2011-09-23 05:06:16 +00002131 llvm_unreachable("Function cannot have a template specialization kind");
Douglas Gregor0a897e32009-10-15 17:21:20 +00002132}
2133
2134SourceLocation FunctionDecl::getPointOfInstantiation() const {
Douglas Gregor2db32322009-10-07 23:56:10 +00002135 if (FunctionTemplateSpecializationInfo *FTSInfo
2136 = TemplateOrSpecialization.dyn_cast<
2137 FunctionTemplateSpecializationInfo*>())
Douglas Gregor0a897e32009-10-15 17:21:20 +00002138 return FTSInfo->getPointOfInstantiation();
Douglas Gregor2db32322009-10-07 23:56:10 +00002139 else if (MemberSpecializationInfo *MSInfo
2140 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>())
Douglas Gregor0a897e32009-10-15 17:21:20 +00002141 return MSInfo->getPointOfInstantiation();
2142
2143 return SourceLocation();
Douglas Gregor1fd2dd12009-06-29 22:39:32 +00002144}
2145
Douglas Gregor9f185072009-09-11 20:15:17 +00002146bool FunctionDecl::isOutOfLine() const {
Douglas Gregorda2142f2011-02-19 18:51:44 +00002147 if (Decl::isOutOfLine())
Douglas Gregor9f185072009-09-11 20:15:17 +00002148 return true;
2149
2150 // If this function was instantiated from a member function of a
2151 // class template, check whether that member function was defined out-of-line.
2152 if (FunctionDecl *FD = getInstantiatedFromMemberFunction()) {
2153 const FunctionDecl *Definition;
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00002154 if (FD->hasBody(Definition))
Douglas Gregor9f185072009-09-11 20:15:17 +00002155 return Definition->isOutOfLine();
2156 }
2157
2158 // If this function was instantiated from a function template,
2159 // check whether that function template was defined out-of-line.
2160 if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
2161 const FunctionDecl *Definition;
Argyrios Kyrtzidis06a54a32010-07-07 11:31:19 +00002162 if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
Douglas Gregor9f185072009-09-11 20:15:17 +00002163 return Definition->isOutOfLine();
2164 }
2165
2166 return false;
2167}
2168
Abramo Bagnaraa2026c92011-03-08 16:41:52 +00002169SourceRange FunctionDecl::getSourceRange() const {
2170 return SourceRange(getOuterLocStart(), EndRangeLoc);
2171}
2172
Chris Lattner8a934232008-03-31 00:36:02 +00002173//===----------------------------------------------------------------------===//
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002174// FieldDecl Implementation
2175//===----------------------------------------------------------------------===//
2176
Jay Foad4ba2a172011-01-12 09:06:06 +00002177FieldDecl *FieldDecl::Create(const ASTContext &C, DeclContext *DC,
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002178 SourceLocation StartLoc, SourceLocation IdLoc,
2179 IdentifierInfo *Id, QualType T,
Richard Smith7a614d82011-06-11 17:19:42 +00002180 TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
2181 bool HasInit) {
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002182 return new (C) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
Richard Smith7a614d82011-06-11 17:19:42 +00002183 BW, Mutable, HasInit);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002184}
2185
2186bool FieldDecl::isAnonymousStructOrUnion() const {
2187 if (!isImplicit() || getDeclName())
2188 return false;
2189
2190 if (const RecordType *Record = getType()->getAs<RecordType>())
2191 return Record->getDecl()->isAnonymousStructOrUnion();
2192
2193 return false;
2194}
2195
Richard Smitha6b8b2c2011-10-10 18:28:20 +00002196unsigned FieldDecl::getBitWidthValue(const ASTContext &Ctx) const {
2197 assert(isBitField() && "not a bitfield");
2198 Expr *BitWidth = InitializerOrBitWidth.getPointer();
2199 return BitWidth->EvaluateKnownConstInt(Ctx).getZExtValue();
2200}
2201
John McCallba4f5d52011-01-20 07:57:12 +00002202unsigned FieldDecl::getFieldIndex() const {
2203 if (CachedFieldIndex) return CachedFieldIndex - 1;
2204
Richard Smith180f4792011-11-10 06:34:14 +00002205 unsigned Index = 0;
Fariborz Jahanian07a8a212011-04-28 22:49:46 +00002206 const RecordDecl *RD = getParent();
2207 const FieldDecl *LastFD = 0;
2208 bool IsMsStruct = RD->hasAttr<MsStructAttr>();
Richard Smith180f4792011-11-10 06:34:14 +00002209
2210 for (RecordDecl::field_iterator I = RD->field_begin(), E = RD->field_end();
2211 I != E; ++I, ++Index) {
2212 (*I)->CachedFieldIndex = Index + 1;
John McCallba4f5d52011-01-20 07:57:12 +00002213
Fariborz Jahanian07a8a212011-04-28 22:49:46 +00002214 if (IsMsStruct) {
2215 // Zero-length bitfields following non-bitfield members are ignored.
Richard Smith180f4792011-11-10 06:34:14 +00002216 if (getASTContext().ZeroBitfieldFollowsNonBitfield((*I), LastFD)) {
2217 --Index;
Fariborz Jahanian07a8a212011-04-28 22:49:46 +00002218 continue;
2219 }
Richard Smith180f4792011-11-10 06:34:14 +00002220 LastFD = (*I);
Fariborz Jahanian07a8a212011-04-28 22:49:46 +00002221 }
John McCallba4f5d52011-01-20 07:57:12 +00002222 }
2223
Richard Smith180f4792011-11-10 06:34:14 +00002224 assert(CachedFieldIndex && "failed to find field in parent");
2225 return CachedFieldIndex - 1;
John McCallba4f5d52011-01-20 07:57:12 +00002226}
2227
Abramo Bagnaraf2cf5622011-03-08 11:07:11 +00002228SourceRange FieldDecl::getSourceRange() const {
Abramo Bagnarad330e232011-08-05 08:02:55 +00002229 if (const Expr *E = InitializerOrBitWidth.getPointer())
2230 return SourceRange(getInnerLocStart(), E->getLocEnd());
Abramo Bagnaraa2026c92011-03-08 16:41:52 +00002231 return DeclaratorDecl::getSourceRange();
Abramo Bagnaraf2cf5622011-03-08 11:07:11 +00002232}
2233
Richard Smith7a614d82011-06-11 17:19:42 +00002234void FieldDecl::setInClassInitializer(Expr *Init) {
2235 assert(!InitializerOrBitWidth.getPointer() &&
2236 "bit width or initializer already set");
2237 InitializerOrBitWidth.setPointer(Init);
2238 InitializerOrBitWidth.setInt(0);
2239}
2240
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002241//===----------------------------------------------------------------------===//
Douglas Gregorbcbffc42009-01-07 00:43:41 +00002242// TagDecl Implementation
Ted Kremenek4b7c9832008-09-05 17:16:31 +00002243//===----------------------------------------------------------------------===//
2244
Douglas Gregor1693e152010-07-06 18:42:40 +00002245SourceLocation TagDecl::getOuterLocStart() const {
2246 return getTemplateOrInnerLocStart(this);
2247}
2248
Argyrios Kyrtzidisf602c8b2009-07-14 03:17:17 +00002249SourceRange TagDecl::getSourceRange() const {
2250 SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
Douglas Gregor1693e152010-07-06 18:42:40 +00002251 return SourceRange(getOuterLocStart(), E);
Argyrios Kyrtzidisf602c8b2009-07-14 03:17:17 +00002252}
2253
Argyrios Kyrtzidisb57a4fe2009-07-18 00:34:07 +00002254TagDecl* TagDecl::getCanonicalDecl() {
Douglas Gregor8e9e9ef2009-07-29 23:36:44 +00002255 return getFirstDeclaration();
Argyrios Kyrtzidisb57a4fe2009-07-18 00:34:07 +00002256}
2257
Richard Smith162e1c12011-04-15 14:24:37 +00002258void TagDecl::setTypedefNameForAnonDecl(TypedefNameDecl *TDD) {
2259 TypedefNameDeclOrQualifier = TDD;
Douglas Gregor60e70642010-05-19 18:39:18 +00002260 if (TypeForDecl)
John McCallf4c73712011-01-19 06:33:43 +00002261 const_cast<Type*>(TypeForDecl)->ClearLinkageCache();
Douglas Gregor381d34e2010-12-06 18:36:25 +00002262 ClearLinkageCache();
Douglas Gregor60e70642010-05-19 18:39:18 +00002263}
2264
Douglas Gregor0b7a1582009-01-17 00:42:38 +00002265void TagDecl::startDefinition() {
Sebastian Redled48a8f2010-08-02 18:27:05 +00002266 IsBeingDefined = true;
John McCall86ff3082010-02-04 22:26:26 +00002267
2268 if (isa<CXXRecordDecl>(this)) {
2269 CXXRecordDecl *D = cast<CXXRecordDecl>(this);
2270 struct CXXRecordDecl::DefinitionData *Data =
2271 new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
John McCall22432882010-03-26 21:56:38 +00002272 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I)
2273 cast<CXXRecordDecl>(*I)->DefinitionData = Data;
John McCall86ff3082010-02-04 22:26:26 +00002274 }
Douglas Gregor0b7a1582009-01-17 00:42:38 +00002275}
2276
2277void TagDecl::completeDefinition() {
John McCall5cfa0112010-02-05 01:33:36 +00002278 assert((!isa<CXXRecordDecl>(this) ||
2279 cast<CXXRecordDecl>(this)->hasDefinition()) &&
2280 "definition completed but not started");
2281
John McCall5e1cdac2011-10-07 06:10:15 +00002282 IsCompleteDefinition = true;
Sebastian Redled48a8f2010-08-02 18:27:05 +00002283 IsBeingDefined = false;
Argyrios Kyrtzidis565bf302010-10-24 17:26:50 +00002284
2285 if (ASTMutationListener *L = getASTMutationListener())
2286 L->CompletedTagDefinition(this);
Douglas Gregor0b7a1582009-01-17 00:42:38 +00002287}
2288
John McCall5e1cdac2011-10-07 06:10:15 +00002289TagDecl *TagDecl::getDefinition() const {
2290 if (isCompleteDefinition())
Douglas Gregor8e9e9ef2009-07-29 23:36:44 +00002291 return const_cast<TagDecl *>(this);
Andrew Trick220a9c82010-10-19 21:54:32 +00002292 if (const CXXRecordDecl *CXXRD = dyn_cast<CXXRecordDecl>(this))
2293 return CXXRD->getDefinition();
Mike Stump1eb44332009-09-09 15:08:12 +00002294
2295 for (redecl_iterator R = redecls_begin(), REnd = redecls_end();
Douglas Gregor8e9e9ef2009-07-29 23:36:44 +00002296 R != REnd; ++R)
John McCall5e1cdac2011-10-07 06:10:15 +00002297 if (R->isCompleteDefinition())
Douglas Gregor8e9e9ef2009-07-29 23:36:44 +00002298 return *R;
Mike Stump1eb44332009-09-09 15:08:12 +00002299
Douglas Gregor8e9e9ef2009-07-29 23:36:44 +00002300 return 0;
Ted Kremenek4b7c9832008-09-05 17:16:31 +00002301}
2302
Douglas Gregorc22b5ff2011-02-25 02:25:35 +00002303void TagDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
2304 if (QualifierLoc) {
John McCallb6217662010-03-15 10:12:16 +00002305 // Make sure the extended qualifier info is allocated.
2306 if (!hasExtInfo())
Richard Smith162e1c12011-04-15 14:24:37 +00002307 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
John McCallb6217662010-03-15 10:12:16 +00002308 // Set qualifier info.
Douglas Gregorc22b5ff2011-02-25 02:25:35 +00002309 getExtInfo()->QualifierLoc = QualifierLoc;
Chad Rosier30601782011-08-17 23:08:45 +00002310 } else {
John McCallb6217662010-03-15 10:12:16 +00002311 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
John McCallb6217662010-03-15 10:12:16 +00002312 if (hasExtInfo()) {
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00002313 if (getExtInfo()->NumTemplParamLists == 0) {
2314 getASTContext().Deallocate(getExtInfo());
Richard Smith162e1c12011-04-15 14:24:37 +00002315 TypedefNameDeclOrQualifier = (TypedefNameDecl*) 0;
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00002316 }
2317 else
2318 getExtInfo()->QualifierLoc = QualifierLoc;
John McCallb6217662010-03-15 10:12:16 +00002319 }
2320 }
2321}
2322
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00002323void TagDecl::setTemplateParameterListsInfo(ASTContext &Context,
2324 unsigned NumTPLists,
2325 TemplateParameterList **TPLists) {
2326 assert(NumTPLists > 0);
2327 // Make sure the extended decl info is allocated.
2328 if (!hasExtInfo())
2329 // Allocate external info struct.
Richard Smith162e1c12011-04-15 14:24:37 +00002330 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
Abramo Bagnara7f0a9152011-03-18 15:16:37 +00002331 // Set the template parameter lists info.
2332 getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
2333}
2334
Ted Kremenek4b7c9832008-09-05 17:16:31 +00002335//===----------------------------------------------------------------------===//
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002336// EnumDecl Implementation
2337//===----------------------------------------------------------------------===//
2338
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002339EnumDecl *EnumDecl::Create(ASTContext &C, DeclContext *DC,
2340 SourceLocation StartLoc, SourceLocation IdLoc,
2341 IdentifierInfo *Id,
Abramo Bagnaraa88cefd2010-12-03 18:54:17 +00002342 EnumDecl *PrevDecl, bool IsScoped,
2343 bool IsScopedUsingClassTag, bool IsFixed) {
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002344 EnumDecl *Enum = new (C) EnumDecl(DC, StartLoc, IdLoc, Id, PrevDecl,
Abramo Bagnaraa88cefd2010-12-03 18:54:17 +00002345 IsScoped, IsScopedUsingClassTag, IsFixed);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002346 C.getTypeDeclType(Enum, PrevDecl);
2347 return Enum;
2348}
2349
Argyrios Kyrtzidisb8b03e62010-07-02 11:54:55 +00002350EnumDecl *EnumDecl::Create(ASTContext &C, EmptyShell Empty) {
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002351 return new (C) EnumDecl(0, SourceLocation(), SourceLocation(), 0, 0,
Abramo Bagnaraa88cefd2010-12-03 18:54:17 +00002352 false, false, false);
Argyrios Kyrtzidisb8b03e62010-07-02 11:54:55 +00002353}
2354
Douglas Gregor838db382010-02-11 01:19:42 +00002355void EnumDecl::completeDefinition(QualType NewType,
John McCall1b5a6182010-05-06 08:49:23 +00002356 QualType NewPromotionType,
2357 unsigned NumPositiveBits,
2358 unsigned NumNegativeBits) {
John McCall5e1cdac2011-10-07 06:10:15 +00002359 assert(!isCompleteDefinition() && "Cannot redefine enums!");
Douglas Gregor1274ccd2010-10-08 23:50:27 +00002360 if (!IntegerType)
2361 IntegerType = NewType.getTypePtr();
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002362 PromotionType = NewPromotionType;
John McCall1b5a6182010-05-06 08:49:23 +00002363 setNumPositiveBits(NumPositiveBits);
2364 setNumNegativeBits(NumNegativeBits);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002365 TagDecl::completeDefinition();
2366}
2367
2368//===----------------------------------------------------------------------===//
Chris Lattner8a934232008-03-31 00:36:02 +00002369// RecordDecl Implementation
2370//===----------------------------------------------------------------------===//
Reid Spencer5f016e22007-07-11 17:01:13 +00002371
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002372RecordDecl::RecordDecl(Kind DK, TagKind TK, DeclContext *DC,
2373 SourceLocation StartLoc, SourceLocation IdLoc,
2374 IdentifierInfo *Id, RecordDecl *PrevDecl)
2375 : TagDecl(DK, TK, DC, IdLoc, Id, PrevDecl, StartLoc) {
Ted Kremenek63597922008-09-02 21:12:32 +00002376 HasFlexibleArrayMember = false;
Douglas Gregorbcbffc42009-01-07 00:43:41 +00002377 AnonymousStructOrUnion = false;
Fariborz Jahanian082b02e2009-07-08 01:18:33 +00002378 HasObjectMember = false;
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002379 LoadedFieldsFromExternalStorage = false;
Ted Kremenek63597922008-09-02 21:12:32 +00002380 assert(classof(static_cast<Decl*>(this)) && "Invalid Kind!");
Ted Kremenek63597922008-09-02 21:12:32 +00002381}
2382
Jay Foad4ba2a172011-01-12 09:06:06 +00002383RecordDecl *RecordDecl::Create(const ASTContext &C, TagKind TK, DeclContext *DC,
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002384 SourceLocation StartLoc, SourceLocation IdLoc,
2385 IdentifierInfo *Id, RecordDecl* PrevDecl) {
2386 RecordDecl* R = new (C) RecordDecl(Record, TK, DC, StartLoc, IdLoc, Id,
2387 PrevDecl);
Ted Kremenek4b7c9832008-09-05 17:16:31 +00002388 C.getTypeDeclType(R, PrevDecl);
2389 return R;
Ted Kremenek63597922008-09-02 21:12:32 +00002390}
2391
Jay Foad4ba2a172011-01-12 09:06:06 +00002392RecordDecl *RecordDecl::Create(const ASTContext &C, EmptyShell Empty) {
Abramo Bagnaraba877ad2011-03-09 14:09:51 +00002393 return new (C) RecordDecl(Record, TTK_Struct, 0, SourceLocation(),
2394 SourceLocation(), 0, 0);
Argyrios Kyrtzidisb8b03e62010-07-02 11:54:55 +00002395}
2396
Douglas Gregorc9b5b402009-03-25 15:59:44 +00002397bool RecordDecl::isInjectedClassName() const {
Mike Stump1eb44332009-09-09 15:08:12 +00002398 return isImplicit() && getDeclName() && getDeclContext()->isRecord() &&
Douglas Gregorc9b5b402009-03-25 15:59:44 +00002399 cast<RecordDecl>(getDeclContext())->getDeclName() == getDeclName();
2400}
2401
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002402RecordDecl::field_iterator RecordDecl::field_begin() const {
2403 if (hasExternalLexicalStorage() && !LoadedFieldsFromExternalStorage)
2404 LoadFieldsFromExternalStorage();
2405
2406 return field_iterator(decl_iterator(FirstDecl));
2407}
2408
Douglas Gregorda2142f2011-02-19 18:51:44 +00002409/// completeDefinition - Notes that the definition of this type is now
2410/// complete.
2411void RecordDecl::completeDefinition() {
John McCall5e1cdac2011-10-07 06:10:15 +00002412 assert(!isCompleteDefinition() && "Cannot redefine record!");
Douglas Gregorda2142f2011-02-19 18:51:44 +00002413 TagDecl::completeDefinition();
2414}
2415
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002416void RecordDecl::LoadFieldsFromExternalStorage() const {
2417 ExternalASTSource *Source = getASTContext().getExternalSource();
2418 assert(hasExternalLexicalStorage() && Source && "No external storage?");
2419
2420 // Notify that we have a RecordDecl doing some initialization.
2421 ExternalASTSource::Deserializing TheFields(Source);
2422
Chris Lattner5f9e2722011-07-23 10:55:15 +00002423 SmallVector<Decl*, 64> Decls;
Douglas Gregorba6ffaf2011-07-15 21:46:17 +00002424 LoadedFieldsFromExternalStorage = true;
2425 switch (Source->FindExternalLexicalDeclsBy<FieldDecl>(this, Decls)) {
2426 case ELR_Success:
2427 break;
2428
2429 case ELR_AlreadyLoaded:
2430 case ELR_Failure:
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002431 return;
Douglas Gregorba6ffaf2011-07-15 21:46:17 +00002432 }
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002433
2434#ifndef NDEBUG
2435 // Check that all decls we got were FieldDecls.
2436 for (unsigned i=0, e=Decls.size(); i != e; ++i)
2437 assert(isa<FieldDecl>(Decls[i]));
2438#endif
2439
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002440 if (Decls.empty())
2441 return;
2442
Argyrios Kyrtzidisec2ec1f2011-10-07 21:55:43 +00002443 llvm::tie(FirstDecl, LastDecl) = BuildDeclChain(Decls,
2444 /*FieldsAlreadyLoaded=*/false);
Argyrios Kyrtzidiseb5e9982010-10-14 20:14:34 +00002445}
2446
Steve Naroff56ee6892008-10-08 17:01:13 +00002447//===----------------------------------------------------------------------===//
2448// BlockDecl Implementation
2449//===----------------------------------------------------------------------===//
2450
David Blaikie4278c652011-09-21 18:16:56 +00002451void BlockDecl::setParams(llvm::ArrayRef<ParmVarDecl *> NewParamInfo) {
Steve Naroffe78b8092009-03-13 16:56:44 +00002452 assert(ParamInfo == 0 && "Already has param info!");
Mike Stump1eb44332009-09-09 15:08:12 +00002453
Steve Naroffe78b8092009-03-13 16:56:44 +00002454 // Zero params -> null pointer.
David Blaikie4278c652011-09-21 18:16:56 +00002455 if (!NewParamInfo.empty()) {
2456 NumParams = NewParamInfo.size();
2457 ParamInfo = new (getASTContext()) ParmVarDecl*[NewParamInfo.size()];
2458 std::copy(NewParamInfo.begin(), NewParamInfo.end(), ParamInfo);
Steve Naroffe78b8092009-03-13 16:56:44 +00002459 }
2460}
2461
John McCall6b5a61b2011-02-07 10:33:21 +00002462void BlockDecl::setCaptures(ASTContext &Context,
2463 const Capture *begin,
2464 const Capture *end,
2465 bool capturesCXXThis) {
John McCall469a1eb2011-02-02 13:00:07 +00002466 CapturesCXXThis = capturesCXXThis;
2467
2468 if (begin == end) {
John McCall6b5a61b2011-02-07 10:33:21 +00002469 NumCaptures = 0;
2470 Captures = 0;
John McCall469a1eb2011-02-02 13:00:07 +00002471 return;
2472 }
2473
John McCall6b5a61b2011-02-07 10:33:21 +00002474 NumCaptures = end - begin;
2475
2476 // Avoid new Capture[] because we don't want to provide a default
2477 // constructor.
2478 size_t allocationSize = NumCaptures * sizeof(Capture);
2479 void *buffer = Context.Allocate(allocationSize, /*alignment*/sizeof(void*));
2480 memcpy(buffer, begin, allocationSize);
2481 Captures = static_cast<Capture*>(buffer);
Steve Naroffe78b8092009-03-13 16:56:44 +00002482}
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002483
John McCall204e1332011-06-15 22:51:16 +00002484bool BlockDecl::capturesVariable(const VarDecl *variable) const {
2485 for (capture_const_iterator
2486 i = capture_begin(), e = capture_end(); i != e; ++i)
2487 // Only auto vars can be captured, so no redeclaration worries.
2488 if (i->getVariable() == variable)
2489 return true;
2490
2491 return false;
2492}
2493
Douglas Gregor2fcbcef2010-12-21 16:27:07 +00002494SourceRange BlockDecl::getSourceRange() const {
2495 return SourceRange(getLocation(), Body? Body->getLocEnd() : getLocation());
2496}
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002497
2498//===----------------------------------------------------------------------===//
2499// Other Decl Allocation/Deallocation Method Implementations
2500//===----------------------------------------------------------------------===//
2501
2502TranslationUnitDecl *TranslationUnitDecl::Create(ASTContext &C) {
2503 return new (C) TranslationUnitDecl(C);
2504}
2505
Chris Lattnerad8dcf42011-02-17 07:39:24 +00002506LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnara67843042011-03-05 18:21:20 +00002507 SourceLocation IdentL, IdentifierInfo *II) {
2508 return new (C) LabelDecl(DC, IdentL, II, 0, IdentL);
2509}
2510
2511LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
2512 SourceLocation IdentL, IdentifierInfo *II,
2513 SourceLocation GnuLabelL) {
2514 assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
2515 return new (C) LabelDecl(DC, IdentL, II, 0, GnuLabelL);
Chris Lattnerad8dcf42011-02-17 07:39:24 +00002516}
2517
2518
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002519NamespaceDecl *NamespaceDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnaraacba90f2011-03-08 12:38:20 +00002520 SourceLocation StartLoc,
2521 SourceLocation IdLoc, IdentifierInfo *Id) {
2522 return new (C) NamespaceDecl(DC, StartLoc, IdLoc, Id);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002523}
2524
Douglas Gregor06c91932010-10-27 19:49:05 +00002525NamespaceDecl *NamespaceDecl::getNextNamespace() {
2526 return dyn_cast_or_null<NamespaceDecl>(
2527 NextNamespace.get(getASTContext().getExternalSource()));
2528}
2529
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002530ImplicitParamDecl *ImplicitParamDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002531 SourceLocation IdLoc,
2532 IdentifierInfo *Id,
2533 QualType Type) {
2534 return new (C) ImplicitParamDecl(DC, IdLoc, Id, Type);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002535}
2536
2537FunctionDecl *FunctionDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002538 SourceLocation StartLoc,
Abramo Bagnara25777432010-08-11 22:01:17 +00002539 const DeclarationNameInfo &NameInfo,
2540 QualType T, TypeSourceInfo *TInfo,
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002541 StorageClass SC, StorageClass SCAsWritten,
Douglas Gregor8f150942010-12-09 16:59:22 +00002542 bool isInlineSpecified,
Richard Smithaf1fc7a2011-08-15 21:04:07 +00002543 bool hasWrittenPrototype,
2544 bool isConstexprSpecified) {
Abramo Bagnaraff676cb2011-03-08 08:55:46 +00002545 FunctionDecl *New = new (C) FunctionDecl(Function, DC, StartLoc, NameInfo,
2546 T, TInfo, SC, SCAsWritten,
Richard Smithaf1fc7a2011-08-15 21:04:07 +00002547 isInlineSpecified,
2548 isConstexprSpecified);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002549 New->HasWrittenPrototype = hasWrittenPrototype;
2550 return New;
2551}
2552
2553BlockDecl *BlockDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L) {
2554 return new (C) BlockDecl(DC, L);
2555}
2556
2557EnumConstantDecl *EnumConstantDecl::Create(ASTContext &C, EnumDecl *CD,
2558 SourceLocation L,
2559 IdentifierInfo *Id, QualType T,
2560 Expr *E, const llvm::APSInt &V) {
2561 return new (C) EnumConstantDecl(CD, L, Id, T, E, V);
2562}
2563
Benjamin Kramerd9811462010-11-21 14:11:41 +00002564IndirectFieldDecl *
2565IndirectFieldDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
2566 IdentifierInfo *Id, QualType T, NamedDecl **CH,
2567 unsigned CHS) {
Francois Pichet87c2e122010-11-21 06:08:52 +00002568 return new (C) IndirectFieldDecl(DC, L, Id, T, CH, CHS);
2569}
2570
Douglas Gregor8e7139c2010-09-01 20:41:53 +00002571SourceRange EnumConstantDecl::getSourceRange() const {
2572 SourceLocation End = getLocation();
2573 if (Init)
2574 End = Init->getLocEnd();
2575 return SourceRange(getLocation(), End);
2576}
2577
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002578TypedefDecl *TypedefDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnara344577e2011-03-06 15:48:19 +00002579 SourceLocation StartLoc, SourceLocation IdLoc,
2580 IdentifierInfo *Id, TypeSourceInfo *TInfo) {
2581 return new (C) TypedefDecl(DC, StartLoc, IdLoc, Id, TInfo);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002582}
2583
Richard Smith162e1c12011-04-15 14:24:37 +00002584TypeAliasDecl *TypeAliasDecl::Create(ASTContext &C, DeclContext *DC,
2585 SourceLocation StartLoc,
2586 SourceLocation IdLoc, IdentifierInfo *Id,
2587 TypeSourceInfo *TInfo) {
2588 return new (C) TypeAliasDecl(DC, StartLoc, IdLoc, Id, TInfo);
2589}
2590
Abramo Bagnaraa2026c92011-03-08 16:41:52 +00002591SourceRange TypedefDecl::getSourceRange() const {
2592 SourceLocation RangeEnd = getLocation();
2593 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
2594 if (typeIsPostfix(TInfo->getType()))
2595 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2596 }
2597 return SourceRange(getLocStart(), RangeEnd);
2598}
2599
Richard Smith162e1c12011-04-15 14:24:37 +00002600SourceRange TypeAliasDecl::getSourceRange() const {
2601 SourceLocation RangeEnd = getLocStart();
2602 if (TypeSourceInfo *TInfo = getTypeSourceInfo())
2603 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2604 return SourceRange(getLocStart(), RangeEnd);
2605}
2606
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002607FileScopeAsmDecl *FileScopeAsmDecl::Create(ASTContext &C, DeclContext *DC,
Abramo Bagnara21e006e2011-03-03 14:20:18 +00002608 StringLiteral *Str,
2609 SourceLocation AsmLoc,
2610 SourceLocation RParenLoc) {
2611 return new (C) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);
Sebastian Redl7783bfc2010-01-26 22:01:41 +00002612}
Douglas Gregor15de72c2011-12-02 23:23:56 +00002613
2614//===----------------------------------------------------------------------===//
2615// ImportDecl Implementation
2616//===----------------------------------------------------------------------===//
2617
2618/// \brief Retrieve the number of module identifiers needed to name the given
2619/// module.
2620static unsigned getNumModuleIdentifiers(Module *Mod) {
2621 unsigned Result = 1;
2622 while (Mod->Parent) {
2623 Mod = Mod->Parent;
2624 ++Result;
2625 }
2626 return Result;
2627}
2628
2629ImportDecl::ImportDecl(DeclContext *DC, SourceLocation ImportLoc,
2630 Module *Imported,
2631 ArrayRef<SourceLocation> IdentifierLocs)
2632 : Decl(Import, DC, ImportLoc), ImportedAndComplete(Imported, true)
2633{
2634 assert(getNumModuleIdentifiers(Imported) == IdentifierLocs.size());
2635 SourceLocation *StoredLocs = reinterpret_cast<SourceLocation *>(this + 1);
2636 memcpy(StoredLocs, IdentifierLocs.data(),
2637 IdentifierLocs.size() * sizeof(SourceLocation));
2638}
2639
2640ImportDecl::ImportDecl(DeclContext *DC, SourceLocation ImportLoc,
2641 Module *Imported, SourceLocation EndLoc)
2642 : Decl(Import, DC, ImportLoc), ImportedAndComplete(Imported, false)
2643{
2644 *reinterpret_cast<SourceLocation *>(this + 1) = EndLoc;
2645}
2646
2647ImportDecl *ImportDecl::Create(ASTContext &C, DeclContext *DC,
2648 SourceLocation ImportLoc, Module *Imported,
2649 ArrayRef<SourceLocation> IdentifierLocs) {
2650 void *Mem = C.Allocate(sizeof(ImportDecl) +
2651 IdentifierLocs.size() * sizeof(SourceLocation));
2652 return new (Mem) ImportDecl(DC, ImportLoc, Imported, IdentifierLocs);
2653}
2654
2655ImportDecl *ImportDecl::CreateImplicit(ASTContext &C, DeclContext *DC,
2656 SourceLocation ImportLoc,
2657 Module *Imported,
2658 SourceLocation EndLoc) {
2659 void *Mem = C.Allocate(sizeof(ImportDecl) + sizeof(SourceLocation));
2660 ImportDecl *Import
2661 = new (Mem) ImportDecl(DC, ImportLoc, Imported,
2662 ArrayRef<SourceLocation>(&EndLoc, 1));
2663 Import->setImplicit();
2664 return Import;
2665}
2666
2667ImportDecl *ImportDecl::CreateEmpty(ASTContext &C, unsigned NumLocations) {
2668 void *Mem = C.Allocate(sizeof(ImportDecl) +
2669 NumLocations * sizeof(SourceLocation));
2670 return new (Mem) ImportDecl(EmptyShell());
2671}
2672
2673ArrayRef<SourceLocation> ImportDecl::getIdentifierLocs() const {
2674 if (!ImportedAndComplete.getInt())
2675 return ArrayRef<SourceLocation>();
2676
2677 const SourceLocation *StoredLocs
2678 = reinterpret_cast<const SourceLocation *>(this + 1);
2679 return ArrayRef<SourceLocation>(StoredLocs,
2680 getNumModuleIdentifiers(getImportedModule()));
2681}
2682
2683SourceRange ImportDecl::getSourceRange() const {
2684 if (!ImportedAndComplete.getInt())
2685 return SourceRange(getLocation(),
2686 *reinterpret_cast<const SourceLocation *>(this + 1));
2687
2688 return SourceRange(getLocation(), getIdentifierLocs().back());
2689}
2690