ParseDeclCXX.cpp revision f1bbbb49f06a7462476cd88166fccda5feb15cab 
1//===--- ParseDeclCXX.cpp - C++ Declaration Parsing -----------------------===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10//  This file implements the C++ Declaration portions of the Parser interfaces.
11//
12//===----------------------------------------------------------------------===//
13
14#include "clang/Basic/OperatorKinds.h"
15#include "clang/Parse/Parser.h"
16#include "clang/Parse/ParseDiagnostic.h"
17#include "clang/Parse/DeclSpec.h"
18#include "clang/Parse/Scope.h"
19#include "ExtensionRAIIObject.h"
20using namespace clang;
21
22/// ParseNamespace - We know that the current token is a namespace keyword. This
23/// may either be a top level namespace or a block-level namespace alias.
24///
25///       namespace-definition: [C++ 7.3: basic.namespace]
26///         named-namespace-definition
27///         unnamed-namespace-definition
28///
29///       unnamed-namespace-definition:
30///         'namespace' attributes[opt] '{' namespace-body '}'
31///
32///       named-namespace-definition:
33///         original-namespace-definition
34///         extension-namespace-definition
35///
36///       original-namespace-definition:
37///         'namespace' identifier attributes[opt] '{' namespace-body '}'
38///
39///       extension-namespace-definition:
40///         'namespace' original-namespace-name '{' namespace-body '}'
41///
42///       namespace-alias-definition:  [C++ 7.3.2: namespace.alias]
43///         'namespace' identifier '=' qualified-namespace-specifier ';'
44///
45Parser::DeclPtrTy Parser::ParseNamespace(unsigned Context,
46                                         SourceLocation &DeclEnd) {
47  assert(Tok.is(tok::kw_namespace) && "Not a namespace!");
48  SourceLocation NamespaceLoc = ConsumeToken();  // eat the 'namespace'.
49
50  SourceLocation IdentLoc;
51  IdentifierInfo *Ident = 0;
52
53  Token attrTok;
54
55  if (Tok.is(tok::identifier)) {
56    Ident = Tok.getIdentifierInfo();
57    IdentLoc = ConsumeToken();  // eat the identifier.
58  }
59
60  // Read label attributes, if present.
61  Action::AttrTy *AttrList = 0;
62  if (Tok.is(tok::kw___attribute)) {
63    attrTok = Tok;
64
65    // FIXME: save these somewhere.
66    AttrList = ParseAttributes();
67  }
68
69  if (Tok.is(tok::equal)) {
70    if (AttrList)
71      Diag(attrTok, diag::err_unexpected_namespace_attributes_alias);
72
73    return ParseNamespaceAlias(NamespaceLoc, IdentLoc, Ident, DeclEnd);
74  }
75
76  if (Tok.isNot(tok::l_brace)) {
77    Diag(Tok, Ident ? diag::err_expected_lbrace :
78         diag::err_expected_ident_lbrace);
79    return DeclPtrTy();
80  }
81
82  SourceLocation LBrace = ConsumeBrace();
83
84  // Enter a scope for the namespace.
85  ParseScope NamespaceScope(this, Scope::DeclScope);
86
87  DeclPtrTy NamespcDecl =
88    Actions.ActOnStartNamespaceDef(CurScope, IdentLoc, Ident, LBrace);
89
90  PrettyStackTraceActionsDecl CrashInfo(NamespcDecl, NamespaceLoc, Actions,
91                                        PP.getSourceManager(),
92                                        "parsing namespace");
93
94  while (Tok.isNot(tok::r_brace) && Tok.isNot(tok::eof))
95    ParseExternalDeclaration();
96
97  // Leave the namespace scope.
98  NamespaceScope.Exit();
99
100  SourceLocation RBraceLoc = MatchRHSPunctuation(tok::r_brace, LBrace);
101  Actions.ActOnFinishNamespaceDef(NamespcDecl, RBraceLoc);
102
103  DeclEnd = RBraceLoc;
104  return NamespcDecl;
105}
106
107/// ParseNamespaceAlias - Parse the part after the '=' in a namespace
108/// alias definition.
109///
110Parser::DeclPtrTy Parser::ParseNamespaceAlias(SourceLocation NamespaceLoc,
111                                              SourceLocation AliasLoc,
112                                              IdentifierInfo *Alias,
113                                              SourceLocation &DeclEnd) {
114  assert(Tok.is(tok::equal) && "Not equal token");
115
116  ConsumeToken(); // eat the '='.
117
118  CXXScopeSpec SS;
119  // Parse (optional) nested-name-specifier.
120  ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, false);
121
122  if (SS.isInvalid() || Tok.isNot(tok::identifier)) {
123    Diag(Tok, diag::err_expected_namespace_name);
124    // Skip to end of the definition and eat the ';'.
125    SkipUntil(tok::semi);
126    return DeclPtrTy();
127  }
128
129  // Parse identifier.
130  IdentifierInfo *Ident = Tok.getIdentifierInfo();
131  SourceLocation IdentLoc = ConsumeToken();
132
133  // Eat the ';'.
134  DeclEnd = Tok.getLocation();
135  ExpectAndConsume(tok::semi, diag::err_expected_semi_after_namespace_name,
136                   "", tok::semi);
137
138  return Actions.ActOnNamespaceAliasDef(CurScope, NamespaceLoc, AliasLoc, Alias,
139                                        SS, IdentLoc, Ident);
140}
141
142/// ParseLinkage - We know that the current token is a string_literal
143/// and just before that, that extern was seen.
144///
145///       linkage-specification: [C++ 7.5p2: dcl.link]
146///         'extern' string-literal '{' declaration-seq[opt] '}'
147///         'extern' string-literal declaration
148///
149Parser::DeclPtrTy Parser::ParseLinkage(unsigned Context) {
150  assert(Tok.is(tok::string_literal) && "Not a string literal!");
151  llvm::SmallVector<char, 8> LangBuffer;
152  // LangBuffer is guaranteed to be big enough.
153  LangBuffer.resize(Tok.getLength());
154  const char *LangBufPtr = &LangBuffer[0];
155  unsigned StrSize = PP.getSpelling(Tok, LangBufPtr);
156
157  SourceLocation Loc = ConsumeStringToken();
158
159  ParseScope LinkageScope(this, Scope::DeclScope);
160  DeclPtrTy LinkageSpec
161    = Actions.ActOnStartLinkageSpecification(CurScope,
162                                             /*FIXME: */SourceLocation(),
163                                             Loc, LangBufPtr, StrSize,
164                                       Tok.is(tok::l_brace)? Tok.getLocation()
165                                                           : SourceLocation());
166
167  if (Tok.isNot(tok::l_brace)) {
168    ParseDeclarationOrFunctionDefinition();
169    return Actions.ActOnFinishLinkageSpecification(CurScope, LinkageSpec,
170                                                   SourceLocation());
171  }
172
173  SourceLocation LBrace = ConsumeBrace();
174  while (Tok.isNot(tok::r_brace) && Tok.isNot(tok::eof)) {
175    ParseExternalDeclaration();
176  }
177
178  SourceLocation RBrace = MatchRHSPunctuation(tok::r_brace, LBrace);
179  return Actions.ActOnFinishLinkageSpecification(CurScope, LinkageSpec, RBrace);
180}
181
182/// ParseUsingDirectiveOrDeclaration - Parse C++ using using-declaration or
183/// using-directive. Assumes that current token is 'using'.
184Parser::DeclPtrTy Parser::ParseUsingDirectiveOrDeclaration(unsigned Context,
185                                                     SourceLocation &DeclEnd) {
186  assert(Tok.is(tok::kw_using) && "Not using token");
187
188  // Eat 'using'.
189  SourceLocation UsingLoc = ConsumeToken();
190
191  if (Tok.is(tok::kw_namespace))
192    // Next token after 'using' is 'namespace' so it must be using-directive
193    return ParseUsingDirective(Context, UsingLoc, DeclEnd);
194
195  // Otherwise, it must be using-declaration.
196  return ParseUsingDeclaration(Context, UsingLoc, DeclEnd);
197}
198
199/// ParseUsingDirective - Parse C++ using-directive, assumes
200/// that current token is 'namespace' and 'using' was already parsed.
201///
202///       using-directive: [C++ 7.3.p4: namespace.udir]
203///        'using' 'namespace' ::[opt] nested-name-specifier[opt]
204///                 namespace-name ;
205/// [GNU] using-directive:
206///        'using' 'namespace' ::[opt] nested-name-specifier[opt]
207///                 namespace-name attributes[opt] ;
208///
209Parser::DeclPtrTy Parser::ParseUsingDirective(unsigned Context,
210                                              SourceLocation UsingLoc,
211                                              SourceLocation &DeclEnd) {
212  assert(Tok.is(tok::kw_namespace) && "Not 'namespace' token");
213
214  // Eat 'namespace'.
215  SourceLocation NamespcLoc = ConsumeToken();
216
217  CXXScopeSpec SS;
218  // Parse (optional) nested-name-specifier.
219  ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, false);
220
221  AttributeList *AttrList = 0;
222  IdentifierInfo *NamespcName = 0;
223  SourceLocation IdentLoc = SourceLocation();
224
225  // Parse namespace-name.
226  if (SS.isInvalid() || Tok.isNot(tok::identifier)) {
227    Diag(Tok, diag::err_expected_namespace_name);
228    // If there was invalid namespace name, skip to end of decl, and eat ';'.
229    SkipUntil(tok::semi);
230    // FIXME: Are there cases, when we would like to call ActOnUsingDirective?
231    return DeclPtrTy();
232  }
233
234  // Parse identifier.
235  NamespcName = Tok.getIdentifierInfo();
236  IdentLoc = ConsumeToken();
237
238  // Parse (optional) attributes (most likely GNU strong-using extension).
239  if (Tok.is(tok::kw___attribute))
240    AttrList = ParseAttributes();
241
242  // Eat ';'.
243  DeclEnd = Tok.getLocation();
244  ExpectAndConsume(tok::semi,
245                   AttrList ? diag::err_expected_semi_after_attribute_list :
246                   diag::err_expected_semi_after_namespace_name, "", tok::semi);
247
248  return Actions.ActOnUsingDirective(CurScope, UsingLoc, NamespcLoc, SS,
249                                      IdentLoc, NamespcName, AttrList);
250}
251
252/// ParseUsingDeclaration - Parse C++ using-declaration. Assumes that
253/// 'using' was already seen.
254///
255///     using-declaration: [C++ 7.3.p3: namespace.udecl]
256///       'using' 'typename'[opt] ::[opt] nested-name-specifier
257///               unqualified-id
258///       'using' :: unqualified-id
259///
260Parser::DeclPtrTy Parser::ParseUsingDeclaration(unsigned Context,
261                                                SourceLocation UsingLoc,
262                                                SourceLocation &DeclEnd,
263                                                AccessSpecifier AS) {
264  CXXScopeSpec SS;
265  bool IsTypeName;
266
267  // Ignore optional 'typename'.
268  if (Tok.is(tok::kw_typename)) {
269    ConsumeToken();
270    IsTypeName = true;
271  }
272  else
273    IsTypeName = false;
274
275  // Parse nested-name-specifier.
276  ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, false);
277
278  AttributeList *AttrList = 0;
279
280  // Check nested-name specifier.
281  if (SS.isInvalid()) {
282    SkipUntil(tok::semi);
283    return DeclPtrTy();
284  }
285  if (Tok.is(tok::annot_template_id)) {
286    // C++0x N2914 [namespace.udecl]p5:
287    // A using-declaration shall not name a template-id.
288    Diag(Tok, diag::err_using_decl_can_not_refer_to_template_spec);
289    SkipUntil(tok::semi);
290    return DeclPtrTy();
291  }
292
293  IdentifierInfo *TargetName = 0;
294  OverloadedOperatorKind Op = OO_None;
295  SourceLocation IdentLoc;
296
297  if (Tok.is(tok::kw_operator)) {
298    IdentLoc = Tok.getLocation();
299
300    Op = TryParseOperatorFunctionId();
301    if (!Op) {
302      // If there was an invalid operator, skip to end of decl, and eat ';'.
303      SkipUntil(tok::semi);
304      return DeclPtrTy();
305    }
306  } else if (Tok.is(tok::identifier)) {
307    // Parse identifier.
308    TargetName = Tok.getIdentifierInfo();
309    IdentLoc = ConsumeToken();
310  } else {
311    // FIXME: Use a better diagnostic here.
312    Diag(Tok, diag::err_expected_ident_in_using);
313
314    // If there was invalid identifier, skip to end of decl, and eat ';'.
315    SkipUntil(tok::semi);
316    return DeclPtrTy();
317  }
318
319  // Parse (optional) attributes (most likely GNU strong-using extension).
320  if (Tok.is(tok::kw___attribute))
321    AttrList = ParseAttributes();
322
323  // Eat ';'.
324  DeclEnd = Tok.getLocation();
325  ExpectAndConsume(tok::semi, diag::err_expected_semi_after,
326                   AttrList ? "attributes list" : "namespace name", tok::semi);
327
328  return Actions.ActOnUsingDeclaration(CurScope, AS, UsingLoc, SS,
329                                       IdentLoc, TargetName, Op,
330                                       AttrList, IsTypeName);
331}
332
333/// ParseStaticAssertDeclaration - Parse C++0x static_assert-declaratoion.
334///
335///      static_assert-declaration:
336///        static_assert ( constant-expression  ,  string-literal  ) ;
337///
338Parser::DeclPtrTy Parser::ParseStaticAssertDeclaration(SourceLocation &DeclEnd){
339  assert(Tok.is(tok::kw_static_assert) && "Not a static_assert declaration");
340  SourceLocation StaticAssertLoc = ConsumeToken();
341
342  if (Tok.isNot(tok::l_paren)) {
343    Diag(Tok, diag::err_expected_lparen);
344    return DeclPtrTy();
345  }
346
347  SourceLocation LParenLoc = ConsumeParen();
348
349  OwningExprResult AssertExpr(ParseConstantExpression());
350  if (AssertExpr.isInvalid()) {
351    SkipUntil(tok::semi);
352    return DeclPtrTy();
353  }
354
355  if (ExpectAndConsume(tok::comma, diag::err_expected_comma, "", tok::semi))
356    return DeclPtrTy();
357
358  if (Tok.isNot(tok::string_literal)) {
359    Diag(Tok, diag::err_expected_string_literal);
360    SkipUntil(tok::semi);
361    return DeclPtrTy();
362  }
363
364  OwningExprResult AssertMessage(ParseStringLiteralExpression());
365  if (AssertMessage.isInvalid())
366    return DeclPtrTy();
367
368  MatchRHSPunctuation(tok::r_paren, LParenLoc);
369
370  DeclEnd = Tok.getLocation();
371  ExpectAndConsume(tok::semi, diag::err_expected_semi_after_static_assert);
372
373  return Actions.ActOnStaticAssertDeclaration(StaticAssertLoc, move(AssertExpr),
374                                              move(AssertMessage));
375}
376
377/// ParseDecltypeSpecifier - Parse a C++0x decltype specifier.
378///
379/// 'decltype' ( expression )
380///
381void Parser::ParseDecltypeSpecifier(DeclSpec &DS) {
382  assert(Tok.is(tok::kw_decltype) && "Not a decltype specifier");
383
384  SourceLocation StartLoc = ConsumeToken();
385  SourceLocation LParenLoc = Tok.getLocation();
386
387  if (ExpectAndConsume(tok::l_paren, diag::err_expected_lparen_after,
388                       "decltype")) {
389    SkipUntil(tok::r_paren);
390    return;
391  }
392
393  // Parse the expression
394
395  // C++0x [dcl.type.simple]p4:
396  //   The operand of the decltype specifier is an unevaluated operand.
397  EnterExpressionEvaluationContext Unevaluated(Actions,
398                                               Action::Unevaluated);
399  OwningExprResult Result = ParseExpression();
400  if (Result.isInvalid()) {
401    SkipUntil(tok::r_paren);
402    return;
403  }
404
405  // Match the ')'
406  SourceLocation RParenLoc;
407  if (Tok.is(tok::r_paren))
408    RParenLoc = ConsumeParen();
409  else
410    MatchRHSPunctuation(tok::r_paren, LParenLoc);
411
412  if (RParenLoc.isInvalid())
413    return;
414
415  const char *PrevSpec = 0;
416  unsigned DiagID;
417  // Check for duplicate type specifiers (e.g. "int decltype(a)").
418  if (DS.SetTypeSpecType(DeclSpec::TST_decltype, StartLoc, PrevSpec,
419                         DiagID, Result.release()))
420    Diag(StartLoc, DiagID) << PrevSpec;
421}
422
423/// ParseClassName - Parse a C++ class-name, which names a class. Note
424/// that we only check that the result names a type; semantic analysis
425/// will need to verify that the type names a class. The result is
426/// either a type or NULL, depending on whether a type name was
427/// found.
428///
429///       class-name: [C++ 9.1]
430///         identifier
431///         simple-template-id
432///
433Parser::TypeResult Parser::ParseClassName(SourceLocation &EndLocation,
434                                          const CXXScopeSpec *SS,
435                                          bool DestrExpected) {
436  // Check whether we have a template-id that names a type.
437  if (Tok.is(tok::annot_template_id)) {
438    TemplateIdAnnotation *TemplateId
439      = static_cast<TemplateIdAnnotation *>(Tok.getAnnotationValue());
440    if (TemplateId->Kind == TNK_Type_template) {
441      AnnotateTemplateIdTokenAsType(SS);
442
443      assert(Tok.is(tok::annot_typename) && "template-id -> type failed");
444      TypeTy *Type = Tok.getAnnotationValue();
445      EndLocation = Tok.getAnnotationEndLoc();
446      ConsumeToken();
447
448      if (Type)
449        return Type;
450      return true;
451    }
452
453    // Fall through to produce an error below.
454  }
455
456  if (Tok.isNot(tok::identifier)) {
457    Diag(Tok, diag::err_expected_class_name);
458    return true;
459  }
460
461  // We have an identifier; check whether it is actually a type.
462  TypeTy *Type = Actions.getTypeName(*Tok.getIdentifierInfo(),
463                                     Tok.getLocation(), CurScope, SS,
464                                     true);
465  if (!Type) {
466    Diag(Tok, DestrExpected ? diag::err_destructor_class_name
467                            : diag::err_expected_class_name);
468    return true;
469  }
470
471  // Consume the identifier.
472  EndLocation = ConsumeToken();
473  return Type;
474}
475
476/// ParseClassSpecifier - Parse a C++ class-specifier [C++ class] or
477/// elaborated-type-specifier [C++ dcl.type.elab]; we can't tell which
478/// until we reach the start of a definition or see a token that
479/// cannot start a definition.
480///
481///       class-specifier: [C++ class]
482///         class-head '{' member-specification[opt] '}'
483///         class-head '{' member-specification[opt] '}' attributes[opt]
484///       class-head:
485///         class-key identifier[opt] base-clause[opt]
486///         class-key nested-name-specifier identifier base-clause[opt]
487///         class-key nested-name-specifier[opt] simple-template-id
488///                          base-clause[opt]
489/// [GNU]   class-key attributes[opt] identifier[opt] base-clause[opt]
490/// [GNU]   class-key attributes[opt] nested-name-specifier
491///                          identifier base-clause[opt]
492/// [GNU]   class-key attributes[opt] nested-name-specifier[opt]
493///                          simple-template-id base-clause[opt]
494///       class-key:
495///         'class'
496///         'struct'
497///         'union'
498///
499///       elaborated-type-specifier: [C++ dcl.type.elab]
500///         class-key ::[opt] nested-name-specifier[opt] identifier
501///         class-key ::[opt] nested-name-specifier[opt] 'template'[opt]
502///                          simple-template-id
503///
504///  Note that the C++ class-specifier and elaborated-type-specifier,
505///  together, subsume the C99 struct-or-union-specifier:
506///
507///       struct-or-union-specifier: [C99 6.7.2.1]
508///         struct-or-union identifier[opt] '{' struct-contents '}'
509///         struct-or-union identifier
510/// [GNU]   struct-or-union attributes[opt] identifier[opt] '{' struct-contents
511///                                                         '}' attributes[opt]
512/// [GNU]   struct-or-union attributes[opt] identifier
513///       struct-or-union:
514///         'struct'
515///         'union'
516void Parser::ParseClassSpecifier(tok::TokenKind TagTokKind,
517                                 SourceLocation StartLoc, DeclSpec &DS,
518                                 const ParsedTemplateInfo &TemplateInfo,
519                                 AccessSpecifier AS) {
520  DeclSpec::TST TagType;
521  if (TagTokKind == tok::kw_struct)
522    TagType = DeclSpec::TST_struct;
523  else if (TagTokKind == tok::kw_class)
524    TagType = DeclSpec::TST_class;
525  else {
526    assert(TagTokKind == tok::kw_union && "Not a class specifier");
527    TagType = DeclSpec::TST_union;
528  }
529
530  AttributeList *Attr = 0;
531  // If attributes exist after tag, parse them.
532  if (Tok.is(tok::kw___attribute))
533    Attr = ParseAttributes();
534
535  // If declspecs exist after tag, parse them.
536  if (Tok.is(tok::kw___declspec))
537    Attr = ParseMicrosoftDeclSpec(Attr);
538
539  // Parse the (optional) nested-name-specifier.
540  CXXScopeSpec SS;
541  if (getLang().CPlusPlus &&
542      ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, true))
543    if (Tok.isNot(tok::identifier) && Tok.isNot(tok::annot_template_id))
544      Diag(Tok, diag::err_expected_ident);
545
546  // Parse the (optional) class name or simple-template-id.
547  IdentifierInfo *Name = 0;
548  SourceLocation NameLoc;
549  TemplateIdAnnotation *TemplateId = 0;
550  if (Tok.is(tok::identifier)) {
551    Name = Tok.getIdentifierInfo();
552    NameLoc = ConsumeToken();
553  } else if (Tok.is(tok::annot_template_id)) {
554    TemplateId = static_cast<TemplateIdAnnotation *>(Tok.getAnnotationValue());
555    NameLoc = ConsumeToken();
556
557    if (TemplateId->Kind != TNK_Type_template) {
558      // The template-name in the simple-template-id refers to
559      // something other than a class template. Give an appropriate
560      // error message and skip to the ';'.
561      SourceRange Range(NameLoc);
562      if (SS.isNotEmpty())
563        Range.setBegin(SS.getBeginLoc());
564
565      Diag(TemplateId->LAngleLoc, diag::err_template_spec_syntax_non_template)
566        << Name << static_cast<int>(TemplateId->Kind) << Range;
567
568      DS.SetTypeSpecError();
569      SkipUntil(tok::semi, false, true);
570      TemplateId->Destroy();
571      return;
572    }
573  }
574
575  // There are four options here.  If we have 'struct foo;', then this
576  // is either a forward declaration or a friend declaration, which
577  // have to be treated differently.  If we have 'struct foo {...' or
578  // 'struct foo :...' then this is a definition. Otherwise we have
579  // something like 'struct foo xyz', a reference.
580  Action::TagUseKind TUK;
581  if (Tok.is(tok::l_brace) || (getLang().CPlusPlus && Tok.is(tok::colon)))
582    TUK = Action::TUK_Definition;
583  else if (Tok.is(tok::semi))
584    TUK = DS.isFriendSpecified() ? Action::TUK_Friend : Action::TUK_Declaration;
585  else
586    TUK = Action::TUK_Reference;
587
588  if (!Name && !TemplateId && TUK != Action::TUK_Definition) {
589    // We have a declaration or reference to an anonymous class.
590    Diag(StartLoc, diag::err_anon_type_definition)
591      << DeclSpec::getSpecifierName(TagType);
592
593    // Skip the rest of this declarator, up until the comma or semicolon.
594    SkipUntil(tok::comma, true);
595
596    if (TemplateId)
597      TemplateId->Destroy();
598    return;
599  }
600
601  // Create the tag portion of the class or class template.
602  Action::DeclResult TagOrTempResult;
603  TemplateParameterLists *TemplateParams = TemplateInfo.TemplateParams;
604
605  // FIXME: When TUK == TUK_Reference and we have a template-id, we need
606  // to turn that template-id into a type.
607
608  bool Owned = false;
609  if (TemplateId) {
610    // Explicit specialization, class template partial specialization,
611    // or explicit instantiation.
612    ASTTemplateArgsPtr TemplateArgsPtr(Actions,
613                                       TemplateId->getTemplateArgs(),
614                                       TemplateId->getTemplateArgIsType(),
615                                       TemplateId->NumArgs);
616    if (TemplateInfo.Kind == ParsedTemplateInfo::ExplicitInstantiation &&
617        TUK == Action::TUK_Declaration) {
618      // This is an explicit instantiation of a class template.
619      TagOrTempResult
620        = Actions.ActOnExplicitInstantiation(CurScope,
621                                             TemplateInfo.TemplateLoc,
622                                             TagType,
623                                             StartLoc,
624                                             SS,
625                                     TemplateTy::make(TemplateId->Template),
626                                             TemplateId->TemplateNameLoc,
627                                             TemplateId->LAngleLoc,
628                                             TemplateArgsPtr,
629                                      TemplateId->getTemplateArgLocations(),
630                                             TemplateId->RAngleLoc,
631                                             Attr);
632    } else if (TUK == Action::TUK_Reference || TUK == Action::TUK_Friend) {
633      Action::TypeResult TypeResult =
634        Actions.ActOnTemplateIdType(TemplateTy::make(TemplateId->Template),
635                                    TemplateId->TemplateNameLoc,
636                                    TemplateId->LAngleLoc,
637                                    TemplateArgsPtr,
638                                    TemplateId->getTemplateArgLocations(),
639                                    TemplateId->RAngleLoc,
640                                    TagType, StartLoc);
641
642      TemplateId->Destroy();
643
644      if (TypeResult.isInvalid()) {
645        DS.SetTypeSpecError();
646        return;
647      }
648
649      const char *PrevSpec = 0;
650      unsigned DiagID;
651      if (DS.SetTypeSpecType(DeclSpec::TST_typename, StartLoc, PrevSpec,
652                             DiagID, TypeResult.get()))
653        Diag(StartLoc, DiagID) << PrevSpec;
654
655      return;
656
657    } else {
658      // This is an explicit specialization or a class template
659      // partial specialization.
660      TemplateParameterLists FakedParamLists;
661
662      if (TemplateInfo.Kind == ParsedTemplateInfo::ExplicitInstantiation) {
663        // This looks like an explicit instantiation, because we have
664        // something like
665        //
666        //   template class Foo<X>
667        //
668        // but it actually has a definition. Most likely, this was
669        // meant to be an explicit specialization, but the user forgot
670        // the '<>' after 'template'.
671        assert(TUK == Action::TUK_Definition && "Expected a definition here");
672
673        SourceLocation LAngleLoc
674          = PP.getLocForEndOfToken(TemplateInfo.TemplateLoc);
675        Diag(TemplateId->TemplateNameLoc,
676             diag::err_explicit_instantiation_with_definition)
677          << SourceRange(TemplateInfo.TemplateLoc)
678          << CodeModificationHint::CreateInsertion(LAngleLoc, "<>");
679
680        // Create a fake template parameter list that contains only
681        // "template<>", so that we treat this construct as a class
682        // template specialization.
683        FakedParamLists.push_back(
684          Actions.ActOnTemplateParameterList(0, SourceLocation(),
685                                             TemplateInfo.TemplateLoc,
686                                             LAngleLoc,
687                                             0, 0,
688                                             LAngleLoc));
689        TemplateParams = &FakedParamLists;
690      }
691
692      // Build the class template specialization.
693      TagOrTempResult
694        = Actions.ActOnClassTemplateSpecialization(CurScope, TagType, TUK,
695                       StartLoc, SS,
696                       TemplateTy::make(TemplateId->Template),
697                       TemplateId->TemplateNameLoc,
698                       TemplateId->LAngleLoc,
699                       TemplateArgsPtr,
700                       TemplateId->getTemplateArgLocations(),
701                       TemplateId->RAngleLoc,
702                       Attr,
703                       Action::MultiTemplateParamsArg(Actions,
704                                    TemplateParams? &(*TemplateParams)[0] : 0,
705                                 TemplateParams? TemplateParams->size() : 0));
706    }
707    TemplateId->Destroy();
708  } else if (TemplateInfo.Kind == ParsedTemplateInfo::ExplicitInstantiation &&
709             TUK == Action::TUK_Declaration) {
710    // Explicit instantiation of a member of a class template
711    // specialization, e.g.,
712    //
713    //   template struct Outer<int>::Inner;
714    //
715    TagOrTempResult
716      = Actions.ActOnExplicitInstantiation(CurScope,
717                                           TemplateInfo.TemplateLoc,
718                                           TagType, StartLoc, SS, Name,
719                                           NameLoc, Attr);
720  } else {
721    if (TemplateInfo.Kind == ParsedTemplateInfo::ExplicitInstantiation &&
722        TUK == Action::TUK_Definition) {
723      // FIXME: Diagnose this particular error.
724    }
725
726    // Declaration or definition of a class type
727    TagOrTempResult = Actions.ActOnTag(CurScope, TagType, TUK, StartLoc, SS,
728                                       Name, NameLoc, Attr, AS,
729                                  Action::MultiTemplateParamsArg(Actions,
730                                    TemplateParams? &(*TemplateParams)[0] : 0,
731                                    TemplateParams? TemplateParams->size() : 0),
732                                       Owned);
733  }
734
735  // Parse the optional base clause (C++ only).
736  if (getLang().CPlusPlus && Tok.is(tok::colon))
737    ParseBaseClause(TagOrTempResult.get());
738
739  // If there is a body, parse it and inform the actions module.
740  if (Tok.is(tok::l_brace))
741    if (getLang().CPlusPlus)
742      ParseCXXMemberSpecification(StartLoc, TagType, TagOrTempResult.get());
743    else
744      ParseStructUnionBody(StartLoc, TagType, TagOrTempResult.get());
745  else if (TUK == Action::TUK_Definition) {
746    // FIXME: Complain that we have a base-specifier list but no
747    // definition.
748    Diag(Tok, diag::err_expected_lbrace);
749  }
750
751  if (TagOrTempResult.isInvalid()) {
752    DS.SetTypeSpecError();
753    return;
754  }
755
756  const char *PrevSpec = 0;
757  unsigned DiagID;
758  if (DS.SetTypeSpecType(TagType, StartLoc, PrevSpec, DiagID,
759                         TagOrTempResult.get().getAs<void>(), Owned))
760    Diag(StartLoc, DiagID) << PrevSpec;
761}
762
763/// ParseBaseClause - Parse the base-clause of a C++ class [C++ class.derived].
764///
765///       base-clause : [C++ class.derived]
766///         ':' base-specifier-list
767///       base-specifier-list:
768///         base-specifier '...'[opt]
769///         base-specifier-list ',' base-specifier '...'[opt]
770void Parser::ParseBaseClause(DeclPtrTy ClassDecl) {
771  assert(Tok.is(tok::colon) && "Not a base clause");
772  ConsumeToken();
773
774  // Build up an array of parsed base specifiers.
775  llvm::SmallVector<BaseTy *, 8> BaseInfo;
776
777  while (true) {
778    // Parse a base-specifier.
779    BaseResult Result = ParseBaseSpecifier(ClassDecl);
780    if (Result.isInvalid()) {
781      // Skip the rest of this base specifier, up until the comma or
782      // opening brace.
783      SkipUntil(tok::comma, tok::l_brace, true, true);
784    } else {
785      // Add this to our array of base specifiers.
786      BaseInfo.push_back(Result.get());
787    }
788
789    // If the next token is a comma, consume it and keep reading
790    // base-specifiers.
791    if (Tok.isNot(tok::comma)) break;
792
793    // Consume the comma.
794    ConsumeToken();
795  }
796
797  // Attach the base specifiers
798  Actions.ActOnBaseSpecifiers(ClassDecl, BaseInfo.data(), BaseInfo.size());
799}
800
801/// ParseBaseSpecifier - Parse a C++ base-specifier. A base-specifier is
802/// one entry in the base class list of a class specifier, for example:
803///    class foo : public bar, virtual private baz {
804/// 'public bar' and 'virtual private baz' are each base-specifiers.
805///
806///       base-specifier: [C++ class.derived]
807///         ::[opt] nested-name-specifier[opt] class-name
808///         'virtual' access-specifier[opt] ::[opt] nested-name-specifier[opt]
809///                        class-name
810///         access-specifier 'virtual'[opt] ::[opt] nested-name-specifier[opt]
811///                        class-name
812Parser::BaseResult Parser::ParseBaseSpecifier(DeclPtrTy ClassDecl) {
813  bool IsVirtual = false;
814  SourceLocation StartLoc = Tok.getLocation();
815
816  // Parse the 'virtual' keyword.
817  if (Tok.is(tok::kw_virtual))  {
818    ConsumeToken();
819    IsVirtual = true;
820  }
821
822  // Parse an (optional) access specifier.
823  AccessSpecifier Access = getAccessSpecifierIfPresent();
824  if (Access)
825    ConsumeToken();
826
827  // Parse the 'virtual' keyword (again!), in case it came after the
828  // access specifier.
829  if (Tok.is(tok::kw_virtual))  {
830    SourceLocation VirtualLoc = ConsumeToken();
831    if (IsVirtual) {
832      // Complain about duplicate 'virtual'
833      Diag(VirtualLoc, diag::err_dup_virtual)
834        << CodeModificationHint::CreateRemoval(SourceRange(VirtualLoc));
835    }
836
837    IsVirtual = true;
838  }
839
840  // Parse optional '::' and optional nested-name-specifier.
841  CXXScopeSpec SS;
842  ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, true);
843
844  // The location of the base class itself.
845  SourceLocation BaseLoc = Tok.getLocation();
846
847  // Parse the class-name.
848  SourceLocation EndLocation;
849  TypeResult BaseType = ParseClassName(EndLocation, &SS);
850  if (BaseType.isInvalid())
851    return true;
852
853  // Find the complete source range for the base-specifier.
854  SourceRange Range(StartLoc, EndLocation);
855
856  // Notify semantic analysis that we have parsed a complete
857  // base-specifier.
858  return Actions.ActOnBaseSpecifier(ClassDecl, Range, IsVirtual, Access,
859                                    BaseType.get(), BaseLoc);
860}
861
862/// getAccessSpecifierIfPresent - Determine whether the next token is
863/// a C++ access-specifier.
864///
865///       access-specifier: [C++ class.derived]
866///         'private'
867///         'protected'
868///         'public'
869AccessSpecifier Parser::getAccessSpecifierIfPresent() const
870{
871  switch (Tok.getKind()) {
872  default: return AS_none;
873  case tok::kw_private: return AS_private;
874  case tok::kw_protected: return AS_protected;
875  case tok::kw_public: return AS_public;
876  }
877}
878
879void Parser::HandleMemberFunctionDefaultArgs(Declarator& DeclaratorInfo,
880                                             DeclPtrTy ThisDecl) {
881  // We just declared a member function. If this member function
882  // has any default arguments, we'll need to parse them later.
883  LateParsedMethodDeclaration *LateMethod = 0;
884  DeclaratorChunk::FunctionTypeInfo &FTI
885    = DeclaratorInfo.getTypeObject(0).Fun;
886  for (unsigned ParamIdx = 0; ParamIdx < FTI.NumArgs; ++ParamIdx) {
887    if (LateMethod || FTI.ArgInfo[ParamIdx].DefaultArgTokens) {
888      if (!LateMethod) {
889        // Push this method onto the stack of late-parsed method
890        // declarations.
891        getCurrentClass().MethodDecls.push_back(
892                                LateParsedMethodDeclaration(ThisDecl));
893        LateMethod = &getCurrentClass().MethodDecls.back();
894        LateMethod->TemplateScope = CurScope->isTemplateParamScope();
895
896        // Add all of the parameters prior to this one (they don't
897        // have default arguments).
898        LateMethod->DefaultArgs.reserve(FTI.NumArgs);
899        for (unsigned I = 0; I < ParamIdx; ++I)
900          LateMethod->DefaultArgs.push_back(
901                    LateParsedDefaultArgument(FTI.ArgInfo[ParamIdx].Param));
902      }
903
904      // Add this parameter to the list of parameters (it or may
905      // not have a default argument).
906      LateMethod->DefaultArgs.push_back(
907        LateParsedDefaultArgument(FTI.ArgInfo[ParamIdx].Param,
908                                  FTI.ArgInfo[ParamIdx].DefaultArgTokens));
909    }
910  }
911}
912
913/// ParseCXXClassMemberDeclaration - Parse a C++ class member declaration.
914///
915///       member-declaration:
916///         decl-specifier-seq[opt] member-declarator-list[opt] ';'
917///         function-definition ';'[opt]
918///         ::[opt] nested-name-specifier template[opt] unqualified-id ';'[TODO]
919///         using-declaration                                            [TODO]
920/// [C++0x] static_assert-declaration
921///         template-declaration
922/// [GNU]   '__extension__' member-declaration
923///
924///       member-declarator-list:
925///         member-declarator
926///         member-declarator-list ',' member-declarator
927///
928///       member-declarator:
929///         declarator pure-specifier[opt]
930///         declarator constant-initializer[opt]
931///         identifier[opt] ':' constant-expression
932///
933///       pure-specifier:
934///         '= 0'
935///
936///       constant-initializer:
937///         '=' constant-expression
938///
939void Parser::ParseCXXClassMemberDeclaration(AccessSpecifier AS,
940                                       const ParsedTemplateInfo &TemplateInfo) {
941  // static_assert-declaration
942  if (Tok.is(tok::kw_static_assert)) {
943    // FIXME: Check for templates
944    SourceLocation DeclEnd;
945    ParseStaticAssertDeclaration(DeclEnd);
946    return;
947  }
948
949  if (Tok.is(tok::kw_template)) {
950    assert(!TemplateInfo.TemplateParams &&
951           "Nested template improperly parsed?");
952    SourceLocation DeclEnd;
953    ParseDeclarationStartingWithTemplate(Declarator::MemberContext, DeclEnd,
954                                         AS);
955    return;
956  }
957
958  // Handle:  member-declaration ::= '__extension__' member-declaration
959  if (Tok.is(tok::kw___extension__)) {
960    // __extension__ silences extension warnings in the subexpression.
961    ExtensionRAIIObject O(Diags);  // Use RAII to do this.
962    ConsumeToken();
963    return ParseCXXClassMemberDeclaration(AS, TemplateInfo);
964  }
965
966  if (Tok.is(tok::kw_using)) {
967    // FIXME: Check for template aliases
968
969    // Eat 'using'.
970    SourceLocation UsingLoc = ConsumeToken();
971
972    if (Tok.is(tok::kw_namespace)) {
973      Diag(UsingLoc, diag::err_using_namespace_in_class);
974      SkipUntil(tok::semi, true, true);
975    }
976    else {
977      SourceLocation DeclEnd;
978      // Otherwise, it must be using-declaration.
979      ParseUsingDeclaration(Declarator::MemberContext, UsingLoc, DeclEnd, AS);
980    }
981    return;
982  }
983
984  SourceLocation DSStart = Tok.getLocation();
985  // decl-specifier-seq:
986  // Parse the common declaration-specifiers piece.
987  DeclSpec DS;
988  ParseDeclarationSpecifiers(DS, TemplateInfo, AS, DSC_class);
989
990  if (Tok.is(tok::semi)) {
991    ConsumeToken();
992
993    // FIXME: Friend templates?
994    if (DS.isFriendSpecified())
995      Actions.ActOnFriendDecl(CurScope, &DS, /*IsDefinition*/ false);
996    else
997      Actions.ParsedFreeStandingDeclSpec(CurScope, DS);
998
999    return;
1000  }
1001
1002  Declarator DeclaratorInfo(DS, Declarator::MemberContext);
1003
1004  if (Tok.isNot(tok::colon)) {
1005    // Parse the first declarator.
1006    ParseDeclarator(DeclaratorInfo);
1007    // Error parsing the declarator?
1008    if (!DeclaratorInfo.hasName()) {
1009      // If so, skip until the semi-colon or a }.
1010      SkipUntil(tok::r_brace, true);
1011      if (Tok.is(tok::semi))
1012        ConsumeToken();
1013      return;
1014    }
1015
1016    // function-definition:
1017    if (Tok.is(tok::l_brace)
1018        || (DeclaratorInfo.isFunctionDeclarator() &&
1019            (Tok.is(tok::colon) || Tok.is(tok::kw_try)))) {
1020      if (!DeclaratorInfo.isFunctionDeclarator()) {
1021        Diag(Tok, diag::err_func_def_no_params);
1022        ConsumeBrace();
1023        SkipUntil(tok::r_brace, true);
1024        return;
1025      }
1026
1027      if (DS.getStorageClassSpec() == DeclSpec::SCS_typedef) {
1028        Diag(Tok, diag::err_function_declared_typedef);
1029        // This recovery skips the entire function body. It would be nice
1030        // to simply call ParseCXXInlineMethodDef() below, however Sema
1031        // assumes the declarator represents a function, not a typedef.
1032        ConsumeBrace();
1033        SkipUntil(tok::r_brace, true);
1034        return;
1035      }
1036
1037      ParseCXXInlineMethodDef(AS, DeclaratorInfo, TemplateInfo);
1038      return;
1039    }
1040  }
1041
1042  // member-declarator-list:
1043  //   member-declarator
1044  //   member-declarator-list ',' member-declarator
1045
1046  llvm::SmallVector<DeclPtrTy, 8> DeclsInGroup;
1047  OwningExprResult BitfieldSize(Actions);
1048  OwningExprResult Init(Actions);
1049  bool Deleted = false;
1050
1051  while (1) {
1052
1053    // member-declarator:
1054    //   declarator pure-specifier[opt]
1055    //   declarator constant-initializer[opt]
1056    //   identifier[opt] ':' constant-expression
1057
1058    if (Tok.is(tok::colon)) {
1059      ConsumeToken();
1060      BitfieldSize = ParseConstantExpression();
1061      if (BitfieldSize.isInvalid())
1062        SkipUntil(tok::comma, true, true);
1063    }
1064
1065    // pure-specifier:
1066    //   '= 0'
1067    //
1068    // constant-initializer:
1069    //   '=' constant-expression
1070    //
1071    // defaulted/deleted function-definition:
1072    //   '=' 'default'                          [TODO]
1073    //   '=' 'delete'
1074
1075    if (Tok.is(tok::equal)) {
1076      ConsumeToken();
1077      if (getLang().CPlusPlus0x && Tok.is(tok::kw_delete)) {
1078        ConsumeToken();
1079        Deleted = true;
1080      } else {
1081        Init = ParseInitializer();
1082        if (Init.isInvalid())
1083          SkipUntil(tok::comma, true, true);
1084      }
1085    }
1086
1087    // If attributes exist after the declarator, parse them.
1088    if (Tok.is(tok::kw___attribute)) {
1089      SourceLocation Loc;
1090      AttributeList *AttrList = ParseAttributes(&Loc);
1091      DeclaratorInfo.AddAttributes(AttrList, Loc);
1092    }
1093
1094    // NOTE: If Sema is the Action module and declarator is an instance field,
1095    // this call will *not* return the created decl; It will return null.
1096    // See Sema::ActOnCXXMemberDeclarator for details.
1097
1098    DeclPtrTy ThisDecl;
1099    if (DS.isFriendSpecified()) {
1100      // TODO: handle initializers, bitfields, 'delete', friend templates
1101      ThisDecl = Actions.ActOnFriendDecl(CurScope, &DeclaratorInfo,
1102                                         /*IsDefinition*/ false);
1103    } else {
1104      Action::MultiTemplateParamsArg TemplateParams(Actions,
1105          TemplateInfo.TemplateParams? TemplateInfo.TemplateParams->data() : 0,
1106          TemplateInfo.TemplateParams? TemplateInfo.TemplateParams->size() : 0);
1107      ThisDecl = Actions.ActOnCXXMemberDeclarator(CurScope, AS,
1108                                                  DeclaratorInfo,
1109                                                  move(TemplateParams),
1110                                                  BitfieldSize.release(),
1111                                                  Init.release(),
1112                                                  Deleted);
1113    }
1114    if (ThisDecl)
1115      DeclsInGroup.push_back(ThisDecl);
1116
1117    if (DeclaratorInfo.isFunctionDeclarator() &&
1118        DeclaratorInfo.getDeclSpec().getStorageClassSpec()
1119          != DeclSpec::SCS_typedef) {
1120      HandleMemberFunctionDefaultArgs(DeclaratorInfo, ThisDecl);
1121    }
1122
1123    // If we don't have a comma, it is either the end of the list (a ';')
1124    // or an error, bail out.
1125    if (Tok.isNot(tok::comma))
1126      break;
1127
1128    // Consume the comma.
1129    ConsumeToken();
1130
1131    // Parse the next declarator.
1132    DeclaratorInfo.clear();
1133    BitfieldSize = 0;
1134    Init = 0;
1135    Deleted = false;
1136
1137    // Attributes are only allowed on the second declarator.
1138    if (Tok.is(tok::kw___attribute)) {
1139      SourceLocation Loc;
1140      AttributeList *AttrList = ParseAttributes(&Loc);
1141      DeclaratorInfo.AddAttributes(AttrList, Loc);
1142    }
1143
1144    if (Tok.isNot(tok::colon))
1145      ParseDeclarator(DeclaratorInfo);
1146  }
1147
1148  if (Tok.is(tok::semi)) {
1149    ConsumeToken();
1150    Actions.FinalizeDeclaratorGroup(CurScope, DS, DeclsInGroup.data(),
1151                                    DeclsInGroup.size());
1152    return;
1153  }
1154
1155  Diag(Tok, diag::err_expected_semi_decl_list);
1156  // Skip to end of block or statement
1157  SkipUntil(tok::r_brace, true, true);
1158  if (Tok.is(tok::semi))
1159    ConsumeToken();
1160  return;
1161}
1162
1163/// ParseCXXMemberSpecification - Parse the class definition.
1164///
1165///       member-specification:
1166///         member-declaration member-specification[opt]
1167///         access-specifier ':' member-specification[opt]
1168///
1169void Parser::ParseCXXMemberSpecification(SourceLocation RecordLoc,
1170                                         unsigned TagType, DeclPtrTy TagDecl) {
1171  assert((TagType == DeclSpec::TST_struct ||
1172         TagType == DeclSpec::TST_union  ||
1173         TagType == DeclSpec::TST_class) && "Invalid TagType!");
1174
1175  PrettyStackTraceActionsDecl CrashInfo(TagDecl, RecordLoc, Actions,
1176                                        PP.getSourceManager(),
1177                                        "parsing struct/union/class body");
1178
1179  SourceLocation LBraceLoc = ConsumeBrace();
1180
1181  // Determine whether this is a top-level (non-nested) class.
1182  bool TopLevelClass = ClassStack.empty() ||
1183    CurScope->isInCXXInlineMethodScope();
1184
1185  // Enter a scope for the class.
1186  ParseScope ClassScope(this, Scope::ClassScope|Scope::DeclScope);
1187
1188  // Note that we are parsing a new (potentially-nested) class definition.
1189  ParsingClassDefinition ParsingDef(*this, TagDecl, TopLevelClass);
1190
1191  if (TagDecl)
1192    Actions.ActOnTagStartDefinition(CurScope, TagDecl);
1193  else {
1194    SkipUntil(tok::r_brace, false, false);
1195    return;
1196  }
1197
1198  // C++ 11p3: Members of a class defined with the keyword class are private
1199  // by default. Members of a class defined with the keywords struct or union
1200  // are public by default.
1201  AccessSpecifier CurAS;
1202  if (TagType == DeclSpec::TST_class)
1203    CurAS = AS_private;
1204  else
1205    CurAS = AS_public;
1206
1207  // While we still have something to read, read the member-declarations.
1208  while (Tok.isNot(tok::r_brace) && Tok.isNot(tok::eof)) {
1209    // Each iteration of this loop reads one member-declaration.
1210
1211    // Check for extraneous top-level semicolon.
1212    if (Tok.is(tok::semi)) {
1213      Diag(Tok, diag::ext_extra_struct_semi);
1214      ConsumeToken();
1215      continue;
1216    }
1217
1218    AccessSpecifier AS = getAccessSpecifierIfPresent();
1219    if (AS != AS_none) {
1220      // Current token is a C++ access specifier.
1221      CurAS = AS;
1222      ConsumeToken();
1223      ExpectAndConsume(tok::colon, diag::err_expected_colon);
1224      continue;
1225    }
1226
1227    // FIXME: Make sure we don't have a template here.
1228
1229    // Parse all the comma separated declarators.
1230    ParseCXXClassMemberDeclaration(CurAS);
1231  }
1232
1233  SourceLocation RBraceLoc = MatchRHSPunctuation(tok::r_brace, LBraceLoc);
1234
1235  AttributeList *AttrList = 0;
1236  // If attributes exist after class contents, parse them.
1237  if (Tok.is(tok::kw___attribute))
1238    AttrList = ParseAttributes(); // FIXME: where should I put them?
1239
1240  Actions.ActOnFinishCXXMemberSpecification(CurScope, RecordLoc, TagDecl,
1241                                            LBraceLoc, RBraceLoc);
1242
1243  // C++ 9.2p2: Within the class member-specification, the class is regarded as
1244  // complete within function bodies, default arguments,
1245  // exception-specifications, and constructor ctor-initializers (including
1246  // such things in nested classes).
1247  //
1248  // FIXME: Only function bodies and constructor ctor-initializers are
1249  // parsed correctly, fix the rest.
1250  if (TopLevelClass) {
1251    // We are not inside a nested class. This class and its nested classes
1252    // are complete and we can parse the delayed portions of method
1253    // declarations and the lexed inline method definitions.
1254    ParseLexedMethodDeclarations(getCurrentClass());
1255    ParseLexedMethodDefs(getCurrentClass());
1256  }
1257
1258  // Leave the class scope.
1259  ParsingDef.Pop();
1260  ClassScope.Exit();
1261
1262  Actions.ActOnTagFinishDefinition(CurScope, TagDecl, RBraceLoc);
1263}
1264
1265/// ParseConstructorInitializer - Parse a C++ constructor initializer,
1266/// which explicitly initializes the members or base classes of a
1267/// class (C++ [class.base.init]). For example, the three initializers
1268/// after the ':' in the Derived constructor below:
1269///
1270/// @code
1271/// class Base { };
1272/// class Derived : Base {
1273///   int x;
1274///   float f;
1275/// public:
1276///   Derived(float f) : Base(), x(17), f(f) { }
1277/// };
1278/// @endcode
1279///
1280/// [C++]  ctor-initializer:
1281///          ':' mem-initializer-list
1282///
1283/// [C++]  mem-initializer-list:
1284///          mem-initializer
1285///          mem-initializer , mem-initializer-list
1286void Parser::ParseConstructorInitializer(DeclPtrTy ConstructorDecl) {
1287  assert(Tok.is(tok::colon) && "Constructor initializer always starts with ':'");
1288
1289  SourceLocation ColonLoc = ConsumeToken();
1290
1291  llvm::SmallVector<MemInitTy*, 4> MemInitializers;
1292
1293  do {
1294    MemInitResult MemInit = ParseMemInitializer(ConstructorDecl);
1295    if (!MemInit.isInvalid())
1296      MemInitializers.push_back(MemInit.get());
1297
1298    if (Tok.is(tok::comma))
1299      ConsumeToken();
1300    else if (Tok.is(tok::l_brace))
1301      break;
1302    else {
1303      // Skip over garbage, until we get to '{'.  Don't eat the '{'.
1304      Diag(Tok.getLocation(), diag::err_expected_lbrace_or_comma);
1305      SkipUntil(tok::l_brace, true, true);
1306      break;
1307    }
1308  } while (true);
1309
1310  Actions.ActOnMemInitializers(ConstructorDecl, ColonLoc,
1311                               MemInitializers.data(), MemInitializers.size());
1312}
1313
1314/// ParseMemInitializer - Parse a C++ member initializer, which is
1315/// part of a constructor initializer that explicitly initializes one
1316/// member or base class (C++ [class.base.init]). See
1317/// ParseConstructorInitializer for an example.
1318///
1319/// [C++] mem-initializer:
1320///         mem-initializer-id '(' expression-list[opt] ')'
1321///
1322/// [C++] mem-initializer-id:
1323///         '::'[opt] nested-name-specifier[opt] class-name
1324///         identifier
1325Parser::MemInitResult Parser::ParseMemInitializer(DeclPtrTy ConstructorDecl) {
1326  // parse '::'[opt] nested-name-specifier[opt]
1327  CXXScopeSpec SS;
1328  ParseOptionalCXXScopeSpecifier(SS, /*ObjectType=*/0, false);
1329  TypeTy *TemplateTypeTy = 0;
1330  if (Tok.is(tok::annot_template_id)) {
1331    TemplateIdAnnotation *TemplateId
1332      = static_cast<TemplateIdAnnotation *>(Tok.getAnnotationValue());
1333    if (TemplateId->Kind == TNK_Type_template) {
1334      AnnotateTemplateIdTokenAsType(&SS);
1335      assert(Tok.is(tok::annot_typename) && "template-id -> type failed");
1336      TemplateTypeTy = Tok.getAnnotationValue();
1337    }
1338    // FIXME. May need to check for TNK_Dependent_template as well.
1339  }
1340  if (!TemplateTypeTy && Tok.isNot(tok::identifier)) {
1341    Diag(Tok, diag::err_expected_member_or_base_name);
1342    return true;
1343  }
1344
1345  // Get the identifier. This may be a member name or a class name,
1346  // but we'll let the semantic analysis determine which it is.
1347  IdentifierInfo *II = Tok.is(tok::identifier) ? Tok.getIdentifierInfo() : 0;
1348  SourceLocation IdLoc = ConsumeToken();
1349
1350  // Parse the '('.
1351  if (Tok.isNot(tok::l_paren)) {
1352    Diag(Tok, diag::err_expected_lparen);
1353    return true;
1354  }
1355  SourceLocation LParenLoc = ConsumeParen();
1356
1357  // Parse the optional expression-list.
1358  ExprVector ArgExprs(Actions);
1359  CommaLocsTy CommaLocs;
1360  if (Tok.isNot(tok::r_paren) && ParseExpressionList(ArgExprs, CommaLocs)) {
1361    SkipUntil(tok::r_paren);
1362    return true;
1363  }
1364
1365  SourceLocation RParenLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1366
1367  return Actions.ActOnMemInitializer(ConstructorDecl, CurScope, SS, II,
1368                                     TemplateTypeTy, IdLoc,
1369                                     LParenLoc, ArgExprs.take(),
1370                                     ArgExprs.size(), CommaLocs.data(),
1371                                     RParenLoc);
1372}
1373
1374/// ParseExceptionSpecification - Parse a C++ exception-specification
1375/// (C++ [except.spec]).
1376///
1377///       exception-specification:
1378///         'throw' '(' type-id-list [opt] ')'
1379/// [MS]    'throw' '(' '...' ')'
1380///
1381///       type-id-list:
1382///         type-id
1383///         type-id-list ',' type-id
1384///
1385bool Parser::ParseExceptionSpecification(SourceLocation &EndLoc,
1386                                         llvm::SmallVector<TypeTy*, 2>
1387                                             &Exceptions,
1388                                         llvm::SmallVector<SourceRange, 2>
1389                                             &Ranges,
1390                                         bool &hasAnyExceptionSpec) {
1391  assert(Tok.is(tok::kw_throw) && "expected throw");
1392
1393  SourceLocation ThrowLoc = ConsumeToken();
1394
1395  if (!Tok.is(tok::l_paren)) {
1396    return Diag(Tok, diag::err_expected_lparen_after) << "throw";
1397  }
1398  SourceLocation LParenLoc = ConsumeParen();
1399
1400  // Parse throw(...), a Microsoft extension that means "this function
1401  // can throw anything".
1402  if (Tok.is(tok::ellipsis)) {
1403    hasAnyExceptionSpec = true;
1404    SourceLocation EllipsisLoc = ConsumeToken();
1405    if (!getLang().Microsoft)
1406      Diag(EllipsisLoc, diag::ext_ellipsis_exception_spec);
1407    EndLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1408    return false;
1409  }
1410
1411  // Parse the sequence of type-ids.
1412  SourceRange Range;
1413  while (Tok.isNot(tok::r_paren)) {
1414    TypeResult Res(ParseTypeName(&Range));
1415    if (!Res.isInvalid()) {
1416      Exceptions.push_back(Res.get());
1417      Ranges.push_back(Range);
1418    }
1419    if (Tok.is(tok::comma))
1420      ConsumeToken();
1421    else
1422      break;
1423  }
1424
1425  EndLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1426  return false;
1427}
1428
1429/// \brief We have just started parsing the definition of a new class,
1430/// so push that class onto our stack of classes that is currently
1431/// being parsed.
1432void Parser::PushParsingClass(DeclPtrTy ClassDecl, bool TopLevelClass) {
1433  assert((TopLevelClass || !ClassStack.empty()) &&
1434         "Nested class without outer class");
1435  ClassStack.push(new ParsingClass(ClassDecl, TopLevelClass));
1436}
1437
1438/// \brief Deallocate the given parsed class and all of its nested
1439/// classes.
1440void Parser::DeallocateParsedClasses(Parser::ParsingClass *Class) {
1441  for (unsigned I = 0, N = Class->NestedClasses.size(); I != N; ++I)
1442    DeallocateParsedClasses(Class->NestedClasses[I]);
1443  delete Class;
1444}
1445
1446/// \brief Pop the top class of the stack of classes that are
1447/// currently being parsed.
1448///
1449/// This routine should be called when we have finished parsing the
1450/// definition of a class, but have not yet popped the Scope
1451/// associated with the class's definition.
1452///
1453/// \returns true if the class we've popped is a top-level class,
1454/// false otherwise.
1455void Parser::PopParsingClass() {
1456  assert(!ClassStack.empty() && "Mismatched push/pop for class parsing");
1457
1458  ParsingClass *Victim = ClassStack.top();
1459  ClassStack.pop();
1460  if (Victim->TopLevelClass) {
1461    // Deallocate all of the nested classes of this class,
1462    // recursively: we don't need to keep any of this information.
1463    DeallocateParsedClasses(Victim);
1464    return;
1465  }
1466  assert(!ClassStack.empty() && "Missing top-level class?");
1467
1468  if (Victim->MethodDecls.empty() && Victim->MethodDefs.empty() &&
1469      Victim->NestedClasses.empty()) {
1470    // The victim is a nested class, but we will not need to perform
1471    // any processing after the definition of this class since it has
1472    // no members whose handling was delayed. Therefore, we can just
1473    // remove this nested class.
1474    delete Victim;
1475    return;
1476  }
1477
1478  // This nested class has some members that will need to be processed
1479  // after the top-level class is completely defined. Therefore, add
1480  // it to the list of nested classes within its parent.
1481  assert(CurScope->isClassScope() && "Nested class outside of class scope?");
1482  ClassStack.top()->NestedClasses.push_back(Victim);
1483  Victim->TemplateScope = CurScope->getParent()->isTemplateParamScope();
1484}
1485