xref: /llvm-project/clang/lib/Parse/ParseObjc.cpp (revision d65cea8dde2f824a4035f5903932f6d38af81c93)
1 //===--- ParseObjC.cpp - Objective C 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 Objective-C portions of the Parser interface.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/Parse/Parser.h"
15 #include "clang/Parse/DeclSpec.h"
16 #include "clang/Parse/Scope.h"
17 #include "AstGuard.h"
18 #include "clang/Basic/Diagnostic.h"
19 #include "llvm/ADT/SmallVector.h"
20 using namespace clang;
21 
22 
23 /// ParseObjCAtDirectives - Handle parts of the external-declaration production:
24 ///       external-declaration: [C99 6.9]
25 /// [OBJC]  objc-class-definition
26 /// [OBJC]  objc-class-declaration
27 /// [OBJC]  objc-alias-declaration
28 /// [OBJC]  objc-protocol-definition
29 /// [OBJC]  objc-method-definition
30 /// [OBJC]  '@' 'end'
31 Parser::DeclTy *Parser::ParseObjCAtDirectives() {
32   SourceLocation AtLoc = ConsumeToken(); // the "@"
33 
34   switch (Tok.getObjCKeywordID()) {
35   case tok::objc_class:
36     return ParseObjCAtClassDeclaration(AtLoc);
37   case tok::objc_interface:
38     return ParseObjCAtInterfaceDeclaration(AtLoc);
39   case tok::objc_protocol:
40     return ParseObjCAtProtocolDeclaration(AtLoc);
41   case tok::objc_implementation:
42     return ParseObjCAtImplementationDeclaration(AtLoc);
43   case tok::objc_end:
44     return ParseObjCAtEndDeclaration(AtLoc);
45   case tok::objc_compatibility_alias:
46     return ParseObjCAtAliasDeclaration(AtLoc);
47   case tok::objc_synthesize:
48     return ParseObjCPropertySynthesize(AtLoc);
49   case tok::objc_dynamic:
50     return ParseObjCPropertyDynamic(AtLoc);
51   default:
52     Diag(AtLoc, diag::err_unexpected_at);
53     SkipUntil(tok::semi);
54     return 0;
55   }
56 }
57 
58 ///
59 /// objc-class-declaration:
60 ///    '@' 'class' identifier-list ';'
61 ///
62 Parser::DeclTy *Parser::ParseObjCAtClassDeclaration(SourceLocation atLoc) {
63   ConsumeToken(); // the identifier "class"
64   llvm::SmallVector<IdentifierInfo *, 8> ClassNames;
65 
66   while (1) {
67     if (Tok.isNot(tok::identifier)) {
68       Diag(Tok, diag::err_expected_ident);
69       SkipUntil(tok::semi);
70       return 0;
71     }
72     ClassNames.push_back(Tok.getIdentifierInfo());
73     ConsumeToken();
74 
75     if (Tok.isNot(tok::comma))
76       break;
77 
78     ConsumeToken();
79   }
80 
81   // Consume the ';'.
82   if (ExpectAndConsume(tok::semi, diag::err_expected_semi_after, "@class"))
83     return 0;
84 
85   return Actions.ActOnForwardClassDeclaration(atLoc,
86                                       &ClassNames[0], ClassNames.size());
87 }
88 
89 ///
90 ///   objc-interface:
91 ///     objc-class-interface-attributes[opt] objc-class-interface
92 ///     objc-category-interface
93 ///
94 ///   objc-class-interface:
95 ///     '@' 'interface' identifier objc-superclass[opt]
96 ///       objc-protocol-refs[opt]
97 ///       objc-class-instance-variables[opt]
98 ///       objc-interface-decl-list
99 ///     @end
100 ///
101 ///   objc-category-interface:
102 ///     '@' 'interface' identifier '(' identifier[opt] ')'
103 ///       objc-protocol-refs[opt]
104 ///       objc-interface-decl-list
105 ///     @end
106 ///
107 ///   objc-superclass:
108 ///     ':' identifier
109 ///
110 ///   objc-class-interface-attributes:
111 ///     __attribute__((visibility("default")))
112 ///     __attribute__((visibility("hidden")))
113 ///     __attribute__((deprecated))
114 ///     __attribute__((unavailable))
115 ///     __attribute__((objc_exception)) - used by NSException on 64-bit
116 ///
117 Parser::DeclTy *Parser::ParseObjCAtInterfaceDeclaration(
118   SourceLocation atLoc, AttributeList *attrList) {
119   assert(Tok.isObjCAtKeyword(tok::objc_interface) &&
120          "ParseObjCAtInterfaceDeclaration(): Expected @interface");
121   ConsumeToken(); // the "interface" identifier
122 
123   if (Tok.isNot(tok::identifier)) {
124     Diag(Tok, diag::err_expected_ident); // missing class or category name.
125     return 0;
126   }
127   // We have a class or category name - consume it.
128   IdentifierInfo *nameId = Tok.getIdentifierInfo();
129   SourceLocation nameLoc = ConsumeToken();
130 
131   if (Tok.is(tok::l_paren)) { // we have a category.
132     SourceLocation lparenLoc = ConsumeParen();
133     SourceLocation categoryLoc, rparenLoc;
134     IdentifierInfo *categoryId = 0;
135 
136     // For ObjC2, the category name is optional (not an error).
137     if (Tok.is(tok::identifier)) {
138       categoryId = Tok.getIdentifierInfo();
139       categoryLoc = ConsumeToken();
140     } else if (!getLang().ObjC2) {
141       Diag(Tok, diag::err_expected_ident); // missing category name.
142       return 0;
143     }
144     if (Tok.isNot(tok::r_paren)) {
145       Diag(Tok, diag::err_expected_rparen);
146       SkipUntil(tok::r_paren, false); // don't stop at ';'
147       return 0;
148     }
149     rparenLoc = ConsumeParen();
150 
151     // Next, we need to check for any protocol references.
152     SourceLocation EndProtoLoc;
153     llvm::SmallVector<DeclTy *, 8> ProtocolRefs;
154     if (Tok.is(tok::less) &&
155         ParseObjCProtocolReferences(ProtocolRefs, true, EndProtoLoc))
156       return 0;
157 
158     if (attrList) // categories don't support attributes.
159       Diag(Tok, diag::err_objc_no_attributes_on_category);
160 
161     DeclTy *CategoryType = Actions.ActOnStartCategoryInterface(atLoc,
162                                      nameId, nameLoc, categoryId, categoryLoc,
163                                      &ProtocolRefs[0], ProtocolRefs.size(),
164                                      EndProtoLoc);
165 
166     ParseObjCInterfaceDeclList(CategoryType, tok::objc_not_keyword);
167     return CategoryType;
168   }
169   // Parse a class interface.
170   IdentifierInfo *superClassId = 0;
171   SourceLocation superClassLoc;
172 
173   if (Tok.is(tok::colon)) { // a super class is specified.
174     ConsumeToken();
175     if (Tok.isNot(tok::identifier)) {
176       Diag(Tok, diag::err_expected_ident); // missing super class name.
177       return 0;
178     }
179     superClassId = Tok.getIdentifierInfo();
180     superClassLoc = ConsumeToken();
181   }
182   // Next, we need to check for any protocol references.
183   llvm::SmallVector<Action::DeclTy*, 8> ProtocolRefs;
184   SourceLocation EndProtoLoc;
185   if (Tok.is(tok::less) &&
186       ParseObjCProtocolReferences(ProtocolRefs, true, EndProtoLoc))
187     return 0;
188 
189   DeclTy *ClsType =
190     Actions.ActOnStartClassInterface(atLoc, nameId, nameLoc,
191                                      superClassId, superClassLoc,
192                                      &ProtocolRefs[0], ProtocolRefs.size(),
193                                      EndProtoLoc, attrList);
194 
195   if (Tok.is(tok::l_brace))
196     ParseObjCClassInstanceVariables(ClsType, atLoc);
197 
198   ParseObjCInterfaceDeclList(ClsType, tok::objc_interface);
199   return ClsType;
200 }
201 
202 /// constructSetterName - Return the setter name for the given
203 /// identifier, i.e. "set" + Name where the initial character of Name
204 /// has been capitalized.
205 static IdentifierInfo *constructSetterName(IdentifierTable &Idents,
206                                            const IdentifierInfo *Name) {
207   llvm::SmallString<100> SelectorName;
208   SelectorName = "set";
209   SelectorName.append(Name->getName(), Name->getName()+Name->getLength());
210   SelectorName[3] = toupper(SelectorName[3]);
211   return &Idents.get(&SelectorName[0], &SelectorName[SelectorName.size()]);
212 }
213 
214 ///   objc-interface-decl-list:
215 ///     empty
216 ///     objc-interface-decl-list objc-property-decl [OBJC2]
217 ///     objc-interface-decl-list objc-method-requirement [OBJC2]
218 ///     objc-interface-decl-list objc-method-proto ';'
219 ///     objc-interface-decl-list declaration
220 ///     objc-interface-decl-list ';'
221 ///
222 ///   objc-method-requirement: [OBJC2]
223 ///     @required
224 ///     @optional
225 ///
226 void Parser::ParseObjCInterfaceDeclList(DeclTy *interfaceDecl,
227                                         tok::ObjCKeywordKind contextKey) {
228   llvm::SmallVector<DeclTy*, 32> allMethods;
229   llvm::SmallVector<DeclTy*, 16> allProperties;
230   tok::ObjCKeywordKind MethodImplKind = tok::objc_not_keyword;
231 
232   SourceLocation AtEndLoc;
233 
234   while (1) {
235     // If this is a method prototype, parse it.
236     if (Tok.is(tok::minus) || Tok.is(tok::plus)) {
237       DeclTy *methodPrototype =
238         ParseObjCMethodPrototype(interfaceDecl, MethodImplKind);
239       allMethods.push_back(methodPrototype);
240       // Consume the ';' here, since ParseObjCMethodPrototype() is re-used for
241       // method definitions.
242       ExpectAndConsume(tok::semi, diag::err_expected_semi_after,"method proto");
243       continue;
244     }
245 
246     // Ignore excess semicolons.
247     if (Tok.is(tok::semi)) {
248       ConsumeToken();
249       continue;
250     }
251 
252     // If we got to the end of the file, exit the loop.
253     if (Tok.is(tok::eof))
254       break;
255 
256     // If we don't have an @ directive, parse it as a function definition.
257     if (Tok.isNot(tok::at)) {
258       // FIXME: as the name implies, this rule allows function definitions.
259       // We could pass a flag or check for functions during semantic analysis.
260       ParseDeclarationOrFunctionDefinition();
261       continue;
262     }
263 
264     // Otherwise, we have an @ directive, eat the @.
265     SourceLocation AtLoc = ConsumeToken(); // the "@"
266     tok::ObjCKeywordKind DirectiveKind = Tok.getObjCKeywordID();
267 
268     if (DirectiveKind == tok::objc_end) { // @end -> terminate list
269       AtEndLoc = AtLoc;
270       break;
271     }
272 
273     // Eat the identifier.
274     ConsumeToken();
275 
276     switch (DirectiveKind) {
277     default:
278       // FIXME: If someone forgets an @end on a protocol, this loop will
279       // continue to eat up tons of stuff and spew lots of nonsense errors.  It
280       // would probably be better to bail out if we saw an @class or @interface
281       // or something like that.
282       Diag(AtLoc, diag::err_objc_illegal_interface_qual);
283       // Skip until we see an '@' or '}' or ';'.
284       SkipUntil(tok::r_brace, tok::at);
285       break;
286 
287     case tok::objc_required:
288     case tok::objc_optional:
289       // This is only valid on protocols.
290       // FIXME: Should this check for ObjC2 being enabled?
291       if (contextKey != tok::objc_protocol)
292         Diag(AtLoc, diag::err_objc_directive_only_in_protocol);
293       else
294         MethodImplKind = DirectiveKind;
295       break;
296 
297     case tok::objc_property:
298       if (!getLang().ObjC2)
299         Diag(AtLoc, diag::err_objc_propertoes_require_objc2);
300 
301       ObjCDeclSpec OCDS;
302       // Parse property attribute list, if any.
303       if (Tok.is(tok::l_paren))
304         ParseObjCPropertyAttribute(OCDS);
305 
306       // Parse all the comma separated declarators.
307       DeclSpec DS;
308       llvm::SmallVector<FieldDeclarator, 8> FieldDeclarators;
309       ParseStructDeclaration(DS, FieldDeclarators);
310 
311       ExpectAndConsume(tok::semi, diag::err_expected_semi_decl_list, "",
312                        tok::at);
313 
314       // Convert them all to property declarations.
315       for (unsigned i = 0, e = FieldDeclarators.size(); i != e; ++i) {
316         FieldDeclarator &FD = FieldDeclarators[i];
317         if (FD.D.getIdentifier() == 0) {
318           Diag(AtLoc, diag::err_objc_property_requires_field_name)
319             << FD.D.getSourceRange();
320           continue;
321         }
322 
323         // Install the property declarator into interfaceDecl.
324         IdentifierInfo *SelName =
325           OCDS.getGetterName() ? OCDS.getGetterName() : FD.D.getIdentifier();
326 
327         Selector GetterSel =
328           PP.getSelectorTable().getNullarySelector(SelName);
329         IdentifierInfo *SetterName = OCDS.getSetterName();
330         if (!SetterName)
331           SetterName = constructSetterName(PP.getIdentifierTable(),
332                                            FD.D.getIdentifier());
333         Selector SetterSel =
334           PP.getSelectorTable().getUnarySelector(SetterName);
335         bool isOverridingProperty = false;
336         DeclTy *Property = Actions.ActOnProperty(CurScope, AtLoc, FD, OCDS,
337                                                  GetterSel, SetterSel,
338                                                  interfaceDecl,
339                                                  &isOverridingProperty,
340                                                  MethodImplKind);
341         if (!isOverridingProperty)
342           allProperties.push_back(Property);
343       }
344       break;
345     }
346   }
347 
348   // We break out of the big loop in two cases: when we see @end or when we see
349   // EOF.  In the former case, eat the @end.  In the later case, emit an error.
350   if (Tok.isObjCAtKeyword(tok::objc_end))
351     ConsumeToken(); // the "end" identifier
352   else
353     Diag(Tok, diag::err_objc_missing_end);
354 
355   // Insert collected methods declarations into the @interface object.
356   // This passes in an invalid SourceLocation for AtEndLoc when EOF is hit.
357   Actions.ActOnAtEnd(AtEndLoc, interfaceDecl,
358                      allMethods.empty() ? 0 : &allMethods[0],
359                      allMethods.size(),
360                      allProperties.empty() ? 0 : &allProperties[0],
361                      allProperties.size());
362 }
363 
364 ///   Parse property attribute declarations.
365 ///
366 ///   property-attr-decl: '(' property-attrlist ')'
367 ///   property-attrlist:
368 ///     property-attribute
369 ///     property-attrlist ',' property-attribute
370 ///   property-attribute:
371 ///     getter '=' identifier
372 ///     setter '=' identifier ':'
373 ///     readonly
374 ///     readwrite
375 ///     assign
376 ///     retain
377 ///     copy
378 ///     nonatomic
379 ///
380 void Parser::ParseObjCPropertyAttribute(ObjCDeclSpec &DS) {
381   assert(Tok.getKind() == tok::l_paren);
382   SourceLocation LHSLoc = ConsumeParen(); // consume '('
383 
384   while (1) {
385     const IdentifierInfo *II = Tok.getIdentifierInfo();
386 
387     // If this is not an identifier at all, bail out early.
388     if (II == 0) {
389       MatchRHSPunctuation(tok::r_paren, LHSLoc);
390       return;
391     }
392 
393     SourceLocation AttrName = ConsumeToken(); // consume last attribute name
394 
395     if (II->isStr("readonly"))
396       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_readonly);
397     else if (II->isStr("assign"))
398       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_assign);
399     else if (II->isStr("readwrite"))
400       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_readwrite);
401     else if (II->isStr("retain"))
402       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_retain);
403     else if (II->isStr("copy"))
404       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_copy);
405     else if (II->isStr("nonatomic"))
406       DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_nonatomic);
407     else if (II->isStr("getter") || II->isStr("setter")) {
408       // getter/setter require extra treatment.
409       if (ExpectAndConsume(tok::equal, diag::err_objc_expected_equal, "",
410                            tok::r_paren))
411         return;
412 
413       if (Tok.isNot(tok::identifier)) {
414         Diag(Tok, diag::err_expected_ident);
415         SkipUntil(tok::r_paren);
416         return;
417       }
418 
419       if (II->getName()[0] == 's') {
420         DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_setter);
421         DS.setSetterName(Tok.getIdentifierInfo());
422         ConsumeToken();  // consume method name
423 
424         if (ExpectAndConsume(tok::colon, diag::err_expected_colon, "",
425                              tok::r_paren))
426           return;
427       } else {
428         DS.setPropertyAttributes(ObjCDeclSpec::DQ_PR_getter);
429         DS.setGetterName(Tok.getIdentifierInfo());
430         ConsumeToken();  // consume method name
431       }
432     } else {
433       Diag(AttrName, diag::err_objc_expected_property_attr) << II;
434       SkipUntil(tok::r_paren);
435       return;
436     }
437 
438     if (Tok.isNot(tok::comma))
439       break;
440 
441     ConsumeToken();
442   }
443 
444   MatchRHSPunctuation(tok::r_paren, LHSLoc);
445 }
446 
447 ///   objc-method-proto:
448 ///     objc-instance-method objc-method-decl objc-method-attributes[opt]
449 ///     objc-class-method objc-method-decl objc-method-attributes[opt]
450 ///
451 ///   objc-instance-method: '-'
452 ///   objc-class-method: '+'
453 ///
454 ///   objc-method-attributes:         [OBJC2]
455 ///     __attribute__((deprecated))
456 ///
457 Parser::DeclTy *Parser::ParseObjCMethodPrototype(DeclTy *IDecl,
458                           tok::ObjCKeywordKind MethodImplKind) {
459   assert((Tok.is(tok::minus) || Tok.is(tok::plus)) && "expected +/-");
460 
461   tok::TokenKind methodType = Tok.getKind();
462   SourceLocation mLoc = ConsumeToken();
463 
464   DeclTy *MDecl = ParseObjCMethodDecl(mLoc, methodType, IDecl, MethodImplKind);
465   // Since this rule is used for both method declarations and definitions,
466   // the caller is (optionally) responsible for consuming the ';'.
467   return MDecl;
468 }
469 
470 ///   objc-selector:
471 ///     identifier
472 ///     one of
473 ///       enum struct union if else while do for switch case default
474 ///       break continue return goto asm sizeof typeof __alignof
475 ///       unsigned long const short volatile signed restrict _Complex
476 ///       in out inout bycopy byref oneway int char float double void _Bool
477 ///
478 IdentifierInfo *Parser::ParseObjCSelector(SourceLocation &SelectorLoc) {
479   switch (Tok.getKind()) {
480   default:
481     return 0;
482   case tok::identifier:
483   case tok::kw_asm:
484   case tok::kw_auto:
485   case tok::kw_bool:
486   case tok::kw_break:
487   case tok::kw_case:
488   case tok::kw_catch:
489   case tok::kw_char:
490   case tok::kw_class:
491   case tok::kw_const:
492   case tok::kw_const_cast:
493   case tok::kw_continue:
494   case tok::kw_default:
495   case tok::kw_delete:
496   case tok::kw_do:
497   case tok::kw_double:
498   case tok::kw_dynamic_cast:
499   case tok::kw_else:
500   case tok::kw_enum:
501   case tok::kw_explicit:
502   case tok::kw_export:
503   case tok::kw_extern:
504   case tok::kw_false:
505   case tok::kw_float:
506   case tok::kw_for:
507   case tok::kw_friend:
508   case tok::kw_goto:
509   case tok::kw_if:
510   case tok::kw_inline:
511   case tok::kw_int:
512   case tok::kw_long:
513   case tok::kw_mutable:
514   case tok::kw_namespace:
515   case tok::kw_new:
516   case tok::kw_operator:
517   case tok::kw_private:
518   case tok::kw_protected:
519   case tok::kw_public:
520   case tok::kw_register:
521   case tok::kw_reinterpret_cast:
522   case tok::kw_restrict:
523   case tok::kw_return:
524   case tok::kw_short:
525   case tok::kw_signed:
526   case tok::kw_sizeof:
527   case tok::kw_static:
528   case tok::kw_static_cast:
529   case tok::kw_struct:
530   case tok::kw_switch:
531   case tok::kw_template:
532   case tok::kw_this:
533   case tok::kw_throw:
534   case tok::kw_true:
535   case tok::kw_try:
536   case tok::kw_typedef:
537   case tok::kw_typeid:
538   case tok::kw_typename:
539   case tok::kw_typeof:
540   case tok::kw_union:
541   case tok::kw_unsigned:
542   case tok::kw_using:
543   case tok::kw_virtual:
544   case tok::kw_void:
545   case tok::kw_volatile:
546   case tok::kw_wchar_t:
547   case tok::kw_while:
548   case tok::kw__Bool:
549   case tok::kw__Complex:
550   case tok::kw___alignof:
551     IdentifierInfo *II = Tok.getIdentifierInfo();
552     SelectorLoc = ConsumeToken();
553     return II;
554   }
555 }
556 
557 ///  objc-for-collection-in: 'in'
558 ///
559 bool Parser::isTokIdentifier_in() const {
560   // FIXME: May have to do additional look-ahead to only allow for
561   // valid tokens following an 'in'; such as an identifier, unary operators,
562   // '[' etc.
563   return (getLang().ObjC2 && Tok.is(tok::identifier) &&
564           Tok.getIdentifierInfo() == ObjCTypeQuals[objc_in]);
565 }
566 
567 /// ParseObjCTypeQualifierList - This routine parses the objective-c's type
568 /// qualifier list and builds their bitmask representation in the input
569 /// argument.
570 ///
571 ///   objc-type-qualifiers:
572 ///     objc-type-qualifier
573 ///     objc-type-qualifiers objc-type-qualifier
574 ///
575 void Parser::ParseObjCTypeQualifierList(ObjCDeclSpec &DS) {
576   while (1) {
577     if (Tok.isNot(tok::identifier))
578       return;
579 
580     const IdentifierInfo *II = Tok.getIdentifierInfo();
581     for (unsigned i = 0; i != objc_NumQuals; ++i) {
582       if (II != ObjCTypeQuals[i])
583         continue;
584 
585       ObjCDeclSpec::ObjCDeclQualifier Qual;
586       switch (i) {
587       default: assert(0 && "Unknown decl qualifier");
588       case objc_in:     Qual = ObjCDeclSpec::DQ_In; break;
589       case objc_out:    Qual = ObjCDeclSpec::DQ_Out; break;
590       case objc_inout:  Qual = ObjCDeclSpec::DQ_Inout; break;
591       case objc_oneway: Qual = ObjCDeclSpec::DQ_Oneway; break;
592       case objc_bycopy: Qual = ObjCDeclSpec::DQ_Bycopy; break;
593       case objc_byref:  Qual = ObjCDeclSpec::DQ_Byref; break;
594       }
595       DS.setObjCDeclQualifier(Qual);
596       ConsumeToken();
597       II = 0;
598       break;
599     }
600 
601     // If this wasn't a recognized qualifier, bail out.
602     if (II) return;
603   }
604 }
605 
606 ///   objc-type-name:
607 ///     '(' objc-type-qualifiers[opt] type-name ')'
608 ///     '(' objc-type-qualifiers[opt] ')'
609 ///
610 Parser::TypeTy *Parser::ParseObjCTypeName(ObjCDeclSpec &DS) {
611   assert(Tok.is(tok::l_paren) && "expected (");
612 
613   SourceLocation LParenLoc = ConsumeParen();
614   SourceLocation TypeStartLoc = Tok.getLocation();
615 
616   // Parse type qualifiers, in, inout, etc.
617   ParseObjCTypeQualifierList(DS);
618 
619   TypeTy *Ty = 0;
620   if (isTypeSpecifierQualifier())
621     Ty = ParseTypeName();
622 
623   if (Tok.is(tok::r_paren))
624     ConsumeParen();
625   else if (Tok.getLocation() == TypeStartLoc) {
626     // If we didn't eat any tokens, then this isn't a type.
627     Diag(Tok, diag::err_expected_type);
628     SkipUntil(tok::r_paren);
629   } else {
630     // Otherwise, we found *something*, but didn't get a ')' in the right
631     // place.  Emit an error then return what we have as the type.
632     MatchRHSPunctuation(tok::r_paren, LParenLoc);
633   }
634   return Ty;
635 }
636 
637 ///   objc-method-decl:
638 ///     objc-selector
639 ///     objc-keyword-selector objc-parmlist[opt]
640 ///     objc-type-name objc-selector
641 ///     objc-type-name objc-keyword-selector objc-parmlist[opt]
642 ///
643 ///   objc-keyword-selector:
644 ///     objc-keyword-decl
645 ///     objc-keyword-selector objc-keyword-decl
646 ///
647 ///   objc-keyword-decl:
648 ///     objc-selector ':' objc-type-name objc-keyword-attributes[opt] identifier
649 ///     objc-selector ':' objc-keyword-attributes[opt] identifier
650 ///     ':' objc-type-name objc-keyword-attributes[opt] identifier
651 ///     ':' objc-keyword-attributes[opt] identifier
652 ///
653 ///   objc-parmlist:
654 ///     objc-parms objc-ellipsis[opt]
655 ///
656 ///   objc-parms:
657 ///     objc-parms , parameter-declaration
658 ///
659 ///   objc-ellipsis:
660 ///     , ...
661 ///
662 ///   objc-keyword-attributes:         [OBJC2]
663 ///     __attribute__((unused))
664 ///
665 Parser::DeclTy *Parser::ParseObjCMethodDecl(SourceLocation mLoc,
666                                             tok::TokenKind mType,
667                                             DeclTy *IDecl,
668                                             tok::ObjCKeywordKind MethodImplKind)
669 {
670   // Parse the return type if present.
671   TypeTy *ReturnType = 0;
672   ObjCDeclSpec DSRet;
673   if (Tok.is(tok::l_paren))
674     ReturnType = ParseObjCTypeName(DSRet);
675 
676   SourceLocation selLoc;
677   IdentifierInfo *SelIdent = ParseObjCSelector(selLoc);
678 
679   if (!SelIdent) { // missing selector name.
680     Diag(Tok, diag::err_expected_selector_for_method)
681       << SourceRange(mLoc, Tok.getLocation());
682     // Skip until we get a ; or {}.
683     SkipUntil(tok::r_brace);
684     return 0;
685   }
686 
687   if (Tok.isNot(tok::colon)) {
688     // If attributes exist after the method, parse them.
689     AttributeList *MethodAttrs = 0;
690     if (getLang().ObjC2 && Tok.is(tok::kw___attribute))
691       MethodAttrs = ParseAttributes();
692 
693     Selector Sel = PP.getSelectorTable().getNullarySelector(SelIdent);
694     return Actions.ActOnMethodDeclaration(mLoc, Tok.getLocation(),
695                                           mType, IDecl, DSRet, ReturnType, Sel,
696                                           0, 0, 0, MethodAttrs, MethodImplKind);
697   }
698 
699   llvm::SmallVector<IdentifierInfo *, 12> KeyIdents;
700   llvm::SmallVector<Action::TypeTy *, 12> KeyTypes;
701   llvm::SmallVector<ObjCDeclSpec, 12> ArgTypeQuals;
702   llvm::SmallVector<IdentifierInfo *, 12> ArgNames;
703 
704   Action::TypeTy *TypeInfo;
705   while (1) {
706     KeyIdents.push_back(SelIdent);
707 
708     // Each iteration parses a single keyword argument.
709     if (Tok.isNot(tok::colon)) {
710       Diag(Tok, diag::err_expected_colon);
711       break;
712     }
713     ConsumeToken(); // Eat the ':'.
714     ObjCDeclSpec DSType;
715     if (Tok.is(tok::l_paren)) // Parse the argument type.
716       TypeInfo = ParseObjCTypeName(DSType);
717     else
718       TypeInfo = 0;
719     KeyTypes.push_back(TypeInfo);
720     ArgTypeQuals.push_back(DSType);
721 
722     // If attributes exist before the argument name, parse them.
723     if (getLang().ObjC2 && Tok.is(tok::kw___attribute))
724       ParseAttributes(); // FIXME: pass attributes through.
725 
726     if (Tok.isNot(tok::identifier)) {
727       Diag(Tok, diag::err_expected_ident); // missing argument name.
728       break;
729     }
730     ArgNames.push_back(Tok.getIdentifierInfo());
731     ConsumeToken(); // Eat the identifier.
732 
733     // Check for another keyword selector.
734     SourceLocation Loc;
735     SelIdent = ParseObjCSelector(Loc);
736     if (!SelIdent && Tok.isNot(tok::colon))
737       break;
738     // We have a selector or a colon, continue parsing.
739   }
740 
741   bool isVariadic = false;
742 
743   // Parse the (optional) parameter list.
744   while (Tok.is(tok::comma)) {
745     ConsumeToken();
746     if (Tok.is(tok::ellipsis)) {
747       isVariadic = true;
748       ConsumeToken();
749       break;
750     }
751     // FIXME: implement this...
752     // Parse the c-style argument declaration-specifier.
753     DeclSpec DS;
754     ParseDeclarationSpecifiers(DS);
755     // Parse the declarator.
756     Declarator ParmDecl(DS, Declarator::PrototypeContext);
757     ParseDeclarator(ParmDecl);
758   }
759 
760   // FIXME: Add support for optional parmameter list...
761   // If attributes exist after the method, parse them.
762   AttributeList *MethodAttrs = 0;
763   if (getLang().ObjC2 && Tok.is(tok::kw___attribute))
764     MethodAttrs = ParseAttributes();
765 
766   Selector Sel = PP.getSelectorTable().getSelector(KeyIdents.size(),
767                                                    &KeyIdents[0]);
768   return Actions.ActOnMethodDeclaration(mLoc, Tok.getLocation(),
769                                         mType, IDecl, DSRet, ReturnType, Sel,
770                                         &ArgTypeQuals[0], &KeyTypes[0],
771                                         &ArgNames[0], MethodAttrs,
772                                         MethodImplKind, isVariadic);
773 }
774 
775 ///   objc-protocol-refs:
776 ///     '<' identifier-list '>'
777 ///
778 bool Parser::
779 ParseObjCProtocolReferences(llvm::SmallVectorImpl<Action::DeclTy*> &Protocols,
780                             bool WarnOnDeclarations, SourceLocation &EndLoc) {
781   assert(Tok.is(tok::less) && "expected <");
782 
783   ConsumeToken(); // the "<"
784 
785   llvm::SmallVector<IdentifierLocPair, 8> ProtocolIdents;
786 
787   while (1) {
788     if (Tok.isNot(tok::identifier)) {
789       Diag(Tok, diag::err_expected_ident);
790       SkipUntil(tok::greater);
791       return true;
792     }
793     ProtocolIdents.push_back(std::make_pair(Tok.getIdentifierInfo(),
794                                        Tok.getLocation()));
795     ConsumeToken();
796 
797     if (Tok.isNot(tok::comma))
798       break;
799     ConsumeToken();
800   }
801 
802   // Consume the '>'.
803   if (Tok.isNot(tok::greater)) {
804     Diag(Tok, diag::err_expected_greater);
805     return true;
806   }
807 
808   EndLoc = ConsumeAnyToken();
809 
810   // Convert the list of protocols identifiers into a list of protocol decls.
811   Actions.FindProtocolDeclaration(WarnOnDeclarations,
812                                   &ProtocolIdents[0], ProtocolIdents.size(),
813                                   Protocols);
814   return false;
815 }
816 
817 ///   objc-class-instance-variables:
818 ///     '{' objc-instance-variable-decl-list[opt] '}'
819 ///
820 ///   objc-instance-variable-decl-list:
821 ///     objc-visibility-spec
822 ///     objc-instance-variable-decl ';'
823 ///     ';'
824 ///     objc-instance-variable-decl-list objc-visibility-spec
825 ///     objc-instance-variable-decl-list objc-instance-variable-decl ';'
826 ///     objc-instance-variable-decl-list ';'
827 ///
828 ///   objc-visibility-spec:
829 ///     @private
830 ///     @protected
831 ///     @public
832 ///     @package [OBJC2]
833 ///
834 ///   objc-instance-variable-decl:
835 ///     struct-declaration
836 ///
837 void Parser::ParseObjCClassInstanceVariables(DeclTy *interfaceDecl,
838                                              SourceLocation atLoc) {
839   assert(Tok.is(tok::l_brace) && "expected {");
840   llvm::SmallVector<DeclTy*, 32> AllIvarDecls;
841   llvm::SmallVector<FieldDeclarator, 8> FieldDeclarators;
842 
843   SourceLocation LBraceLoc = ConsumeBrace(); // the "{"
844 
845   tok::ObjCKeywordKind visibility = tok::objc_protected;
846   // While we still have something to read, read the instance variables.
847   while (Tok.isNot(tok::r_brace) && Tok.isNot(tok::eof)) {
848     // Each iteration of this loop reads one objc-instance-variable-decl.
849 
850     // Check for extraneous top-level semicolon.
851     if (Tok.is(tok::semi)) {
852       Diag(Tok, diag::ext_extra_struct_semi);
853       ConsumeToken();
854       continue;
855     }
856 
857     // Set the default visibility to private.
858     if (Tok.is(tok::at)) { // parse objc-visibility-spec
859       ConsumeToken(); // eat the @ sign
860       switch (Tok.getObjCKeywordID()) {
861       case tok::objc_private:
862       case tok::objc_public:
863       case tok::objc_protected:
864       case tok::objc_package:
865         visibility = Tok.getObjCKeywordID();
866         ConsumeToken();
867         continue;
868       default:
869         Diag(Tok, diag::err_objc_illegal_visibility_spec);
870         continue;
871       }
872     }
873 
874     // Parse all the comma separated declarators.
875     DeclSpec DS;
876     FieldDeclarators.clear();
877     ParseStructDeclaration(DS, FieldDeclarators);
878 
879     // Convert them all to fields.
880     for (unsigned i = 0, e = FieldDeclarators.size(); i != e; ++i) {
881       FieldDeclarator &FD = FieldDeclarators[i];
882       // Install the declarator into interfaceDecl.
883       DeclTy *Field = Actions.ActOnIvar(CurScope,
884                                          DS.getSourceRange().getBegin(),
885                                          FD.D, FD.BitfieldSize, visibility);
886       AllIvarDecls.push_back(Field);
887     }
888 
889     if (Tok.is(tok::semi)) {
890       ConsumeToken();
891     } else {
892       Diag(Tok, diag::err_expected_semi_decl_list);
893       // Skip to end of block or statement
894       SkipUntil(tok::r_brace, true, true);
895     }
896   }
897   SourceLocation RBraceLoc = MatchRHSPunctuation(tok::r_brace, LBraceLoc);
898   // Call ActOnFields() even if we don't have any decls. This is useful
899   // for code rewriting tools that need to be aware of the empty list.
900   Actions.ActOnFields(CurScope, atLoc, interfaceDecl,
901                       &AllIvarDecls[0], AllIvarDecls.size(),
902                       LBraceLoc, RBraceLoc, 0);
903   return;
904 }
905 
906 ///   objc-protocol-declaration:
907 ///     objc-protocol-definition
908 ///     objc-protocol-forward-reference
909 ///
910 ///   objc-protocol-definition:
911 ///     @protocol identifier
912 ///       objc-protocol-refs[opt]
913 ///       objc-interface-decl-list
914 ///     @end
915 ///
916 ///   objc-protocol-forward-reference:
917 ///     @protocol identifier-list ';'
918 ///
919 ///   "@protocol identifier ;" should be resolved as "@protocol
920 ///   identifier-list ;": objc-interface-decl-list may not start with a
921 ///   semicolon in the first alternative if objc-protocol-refs are omitted.
922 Parser::DeclTy *Parser::ParseObjCAtProtocolDeclaration(SourceLocation AtLoc,
923                                                AttributeList *attrList) {
924   assert(Tok.isObjCAtKeyword(tok::objc_protocol) &&
925          "ParseObjCAtProtocolDeclaration(): Expected @protocol");
926   ConsumeToken(); // the "protocol" identifier
927 
928   if (Tok.isNot(tok::identifier)) {
929     Diag(Tok, diag::err_expected_ident); // missing protocol name.
930     return 0;
931   }
932   // Save the protocol name, then consume it.
933   IdentifierInfo *protocolName = Tok.getIdentifierInfo();
934   SourceLocation nameLoc = ConsumeToken();
935 
936   if (Tok.is(tok::semi)) { // forward declaration of one protocol.
937     IdentifierLocPair ProtoInfo(protocolName, nameLoc);
938     ConsumeToken();
939     return Actions.ActOnForwardProtocolDeclaration(AtLoc, &ProtoInfo, 1);
940   }
941 
942   if (Tok.is(tok::comma)) { // list of forward declarations.
943     llvm::SmallVector<IdentifierLocPair, 8> ProtocolRefs;
944     ProtocolRefs.push_back(std::make_pair(protocolName, nameLoc));
945 
946     // Parse the list of forward declarations.
947     while (1) {
948       ConsumeToken(); // the ','
949       if (Tok.isNot(tok::identifier)) {
950         Diag(Tok, diag::err_expected_ident);
951         SkipUntil(tok::semi);
952         return 0;
953       }
954       ProtocolRefs.push_back(IdentifierLocPair(Tok.getIdentifierInfo(),
955                                                Tok.getLocation()));
956       ConsumeToken(); // the identifier
957 
958       if (Tok.isNot(tok::comma))
959         break;
960     }
961     // Consume the ';'.
962     if (ExpectAndConsume(tok::semi, diag::err_expected_semi_after, "@protocol"))
963       return 0;
964 
965     return Actions.ActOnForwardProtocolDeclaration(AtLoc,
966                                                    &ProtocolRefs[0],
967                                                    ProtocolRefs.size());
968   }
969 
970   // Last, and definitely not least, parse a protocol declaration.
971   SourceLocation EndProtoLoc;
972 
973   llvm::SmallVector<DeclTy *, 8> ProtocolRefs;
974   if (Tok.is(tok::less) &&
975       ParseObjCProtocolReferences(ProtocolRefs, true, EndProtoLoc))
976     return 0;
977 
978   DeclTy *ProtoType =
979     Actions.ActOnStartProtocolInterface(AtLoc, protocolName, nameLoc,
980                                         &ProtocolRefs[0], ProtocolRefs.size(),
981                                         EndProtoLoc, attrList);
982   ParseObjCInterfaceDeclList(ProtoType, tok::objc_protocol);
983   return ProtoType;
984 }
985 
986 ///   objc-implementation:
987 ///     objc-class-implementation-prologue
988 ///     objc-category-implementation-prologue
989 ///
990 ///   objc-class-implementation-prologue:
991 ///     @implementation identifier objc-superclass[opt]
992 ///       objc-class-instance-variables[opt]
993 ///
994 ///   objc-category-implementation-prologue:
995 ///     @implementation identifier ( identifier )
996 
997 Parser::DeclTy *Parser::ParseObjCAtImplementationDeclaration(
998   SourceLocation atLoc) {
999   assert(Tok.isObjCAtKeyword(tok::objc_implementation) &&
1000          "ParseObjCAtImplementationDeclaration(): Expected @implementation");
1001   ConsumeToken(); // the "implementation" identifier
1002 
1003   if (Tok.isNot(tok::identifier)) {
1004     Diag(Tok, diag::err_expected_ident); // missing class or category name.
1005     return 0;
1006   }
1007   // We have a class or category name - consume it.
1008   IdentifierInfo *nameId = Tok.getIdentifierInfo();
1009   SourceLocation nameLoc = ConsumeToken(); // consume class or category name
1010 
1011   if (Tok.is(tok::l_paren)) {
1012     // we have a category implementation.
1013     SourceLocation lparenLoc = ConsumeParen();
1014     SourceLocation categoryLoc, rparenLoc;
1015     IdentifierInfo *categoryId = 0;
1016 
1017     if (Tok.is(tok::identifier)) {
1018       categoryId = Tok.getIdentifierInfo();
1019       categoryLoc = ConsumeToken();
1020     } else {
1021       Diag(Tok, diag::err_expected_ident); // missing category name.
1022       return 0;
1023     }
1024     if (Tok.isNot(tok::r_paren)) {
1025       Diag(Tok, diag::err_expected_rparen);
1026       SkipUntil(tok::r_paren, false); // don't stop at ';'
1027       return 0;
1028     }
1029     rparenLoc = ConsumeParen();
1030     DeclTy *ImplCatType = Actions.ActOnStartCategoryImplementation(
1031                                     atLoc, nameId, nameLoc, categoryId,
1032                                     categoryLoc);
1033     ObjCImpDecl = ImplCatType;
1034     return 0;
1035   }
1036   // We have a class implementation
1037   SourceLocation superClassLoc;
1038   IdentifierInfo *superClassId = 0;
1039   if (Tok.is(tok::colon)) {
1040     // We have a super class
1041     ConsumeToken();
1042     if (Tok.isNot(tok::identifier)) {
1043       Diag(Tok, diag::err_expected_ident); // missing super class name.
1044       return 0;
1045     }
1046     superClassId = Tok.getIdentifierInfo();
1047     superClassLoc = ConsumeToken(); // Consume super class name
1048   }
1049   DeclTy *ImplClsType = Actions.ActOnStartClassImplementation(
1050                                   atLoc, nameId, nameLoc,
1051                                   superClassId, superClassLoc);
1052 
1053   if (Tok.is(tok::l_brace)) // we have ivars
1054     ParseObjCClassInstanceVariables(ImplClsType/*FIXME*/, atLoc);
1055   ObjCImpDecl = ImplClsType;
1056 
1057   return 0;
1058 }
1059 
1060 Parser::DeclTy *Parser::ParseObjCAtEndDeclaration(SourceLocation atLoc) {
1061   assert(Tok.isObjCAtKeyword(tok::objc_end) &&
1062          "ParseObjCAtEndDeclaration(): Expected @end");
1063   ConsumeToken(); // the "end" identifier
1064   if (ObjCImpDecl)
1065     Actions.ActOnAtEnd(atLoc, ObjCImpDecl);
1066   else
1067     Diag(atLoc, diag::warn_expected_implementation); // missing @implementation
1068   return ObjCImpDecl;
1069 }
1070 
1071 ///   compatibility-alias-decl:
1072 ///     @compatibility_alias alias-name  class-name ';'
1073 ///
1074 Parser::DeclTy *Parser::ParseObjCAtAliasDeclaration(SourceLocation atLoc) {
1075   assert(Tok.isObjCAtKeyword(tok::objc_compatibility_alias) &&
1076          "ParseObjCAtAliasDeclaration(): Expected @compatibility_alias");
1077   ConsumeToken(); // consume compatibility_alias
1078   if (Tok.isNot(tok::identifier)) {
1079     Diag(Tok, diag::err_expected_ident);
1080     return 0;
1081   }
1082   IdentifierInfo *aliasId = Tok.getIdentifierInfo();
1083   SourceLocation aliasLoc = ConsumeToken(); // consume alias-name
1084   if (Tok.isNot(tok::identifier)) {
1085     Diag(Tok, diag::err_expected_ident);
1086     return 0;
1087   }
1088   IdentifierInfo *classId = Tok.getIdentifierInfo();
1089   SourceLocation classLoc = ConsumeToken(); // consume class-name;
1090   if (Tok.isNot(tok::semi)) {
1091     Diag(Tok, diag::err_expected_semi_after) << "@compatibility_alias";
1092     return 0;
1093   }
1094   DeclTy *ClsType = Actions.ActOnCompatiblityAlias(atLoc,
1095                                                    aliasId, aliasLoc,
1096                                                    classId, classLoc);
1097   return ClsType;
1098 }
1099 
1100 ///   property-synthesis:
1101 ///     @synthesize property-ivar-list ';'
1102 ///
1103 ///   property-ivar-list:
1104 ///     property-ivar
1105 ///     property-ivar-list ',' property-ivar
1106 ///
1107 ///   property-ivar:
1108 ///     identifier
1109 ///     identifier '=' identifier
1110 ///
1111 Parser::DeclTy *Parser::ParseObjCPropertySynthesize(SourceLocation atLoc) {
1112   assert(Tok.isObjCAtKeyword(tok::objc_synthesize) &&
1113          "ParseObjCPropertyDynamic(): Expected '@synthesize'");
1114   SourceLocation loc = ConsumeToken(); // consume synthesize
1115   if (Tok.isNot(tok::identifier)) {
1116     Diag(Tok, diag::err_expected_ident);
1117     return 0;
1118   }
1119   while (Tok.is(tok::identifier)) {
1120     IdentifierInfo *propertyIvar = 0;
1121     IdentifierInfo *propertyId = Tok.getIdentifierInfo();
1122     SourceLocation propertyLoc = ConsumeToken(); // consume property name
1123     if (Tok.is(tok::equal)) {
1124       // property '=' ivar-name
1125       ConsumeToken(); // consume '='
1126       if (Tok.isNot(tok::identifier)) {
1127         Diag(Tok, diag::err_expected_ident);
1128         break;
1129       }
1130       propertyIvar = Tok.getIdentifierInfo();
1131       ConsumeToken(); // consume ivar-name
1132     }
1133     Actions.ActOnPropertyImplDecl(atLoc, propertyLoc, true, ObjCImpDecl,
1134                                   propertyId, propertyIvar);
1135     if (Tok.isNot(tok::comma))
1136       break;
1137     ConsumeToken(); // consume ','
1138   }
1139   if (Tok.isNot(tok::semi))
1140     Diag(Tok, diag::err_expected_semi_after) << "@synthesize";
1141   return 0;
1142 }
1143 
1144 ///   property-dynamic:
1145 ///     @dynamic  property-list
1146 ///
1147 ///   property-list:
1148 ///     identifier
1149 ///     property-list ',' identifier
1150 ///
1151 Parser::DeclTy *Parser::ParseObjCPropertyDynamic(SourceLocation atLoc) {
1152   assert(Tok.isObjCAtKeyword(tok::objc_dynamic) &&
1153          "ParseObjCPropertyDynamic(): Expected '@dynamic'");
1154   SourceLocation loc = ConsumeToken(); // consume dynamic
1155   if (Tok.isNot(tok::identifier)) {
1156     Diag(Tok, diag::err_expected_ident);
1157     return 0;
1158   }
1159   while (Tok.is(tok::identifier)) {
1160     IdentifierInfo *propertyId = Tok.getIdentifierInfo();
1161     SourceLocation propertyLoc = ConsumeToken(); // consume property name
1162     Actions.ActOnPropertyImplDecl(atLoc, propertyLoc, false, ObjCImpDecl,
1163                                   propertyId, 0);
1164 
1165     if (Tok.isNot(tok::comma))
1166       break;
1167     ConsumeToken(); // consume ','
1168   }
1169   if (Tok.isNot(tok::semi))
1170     Diag(Tok, diag::err_expected_semi_after) << "@dynamic";
1171   return 0;
1172 }
1173 
1174 ///  objc-throw-statement:
1175 ///    throw expression[opt];
1176 ///
1177 Parser::OwningStmtResult Parser::ParseObjCThrowStmt(SourceLocation atLoc) {
1178   OwningExprResult Res(Actions);
1179   ConsumeToken(); // consume throw
1180   if (Tok.isNot(tok::semi)) {
1181     Res = ParseExpression();
1182     if (Res.isInvalid()) {
1183       SkipUntil(tok::semi);
1184       return StmtError();
1185     }
1186   }
1187   ConsumeToken(); // consume ';'
1188   return Owned(Actions.ActOnObjCAtThrowStmt(atLoc, Res.release()));
1189 }
1190 
1191 /// objc-synchronized-statement:
1192 ///   @synchronized '(' expression ')' compound-statement
1193 ///
1194 Parser::OwningStmtResult
1195 Parser::ParseObjCSynchronizedStmt(SourceLocation atLoc) {
1196   ConsumeToken(); // consume synchronized
1197   if (Tok.isNot(tok::l_paren)) {
1198     Diag(Tok, diag::err_expected_lparen_after) << "@synchronized";
1199     return StmtError();
1200   }
1201   ConsumeParen();  // '('
1202   OwningExprResult Res(ParseExpression());
1203   if (Res.isInvalid()) {
1204     SkipUntil(tok::semi);
1205     return StmtError();
1206   }
1207   if (Tok.isNot(tok::r_paren)) {
1208     Diag(Tok, diag::err_expected_lbrace);
1209     return StmtError();
1210   }
1211   ConsumeParen();  // ')'
1212   if (Tok.isNot(tok::l_brace)) {
1213     Diag(Tok, diag::err_expected_lbrace);
1214     return StmtError();
1215   }
1216   // Enter a scope to hold everything within the compound stmt.  Compound
1217   // statements can always hold declarations.
1218   ParseScope BodyScope(this, Scope::DeclScope);
1219 
1220   OwningStmtResult SynchBody(ParseCompoundStatementBody());
1221 
1222   BodyScope.Exit();
1223   if (SynchBody.isInvalid())
1224     SynchBody = Actions.ActOnNullStmt(Tok.getLocation());
1225   return Owned(Actions.ActOnObjCAtSynchronizedStmt(atLoc, Res.release(),
1226                                                    SynchBody.release()));
1227 }
1228 
1229 ///  objc-try-catch-statement:
1230 ///    @try compound-statement objc-catch-list[opt]
1231 ///    @try compound-statement objc-catch-list[opt] @finally compound-statement
1232 ///
1233 ///  objc-catch-list:
1234 ///    @catch ( parameter-declaration ) compound-statement
1235 ///    objc-catch-list @catch ( catch-parameter-declaration ) compound-statement
1236 ///  catch-parameter-declaration:
1237 ///     parameter-declaration
1238 ///     '...' [OBJC2]
1239 ///
1240 Parser::OwningStmtResult Parser::ParseObjCTryStmt(SourceLocation atLoc) {
1241   bool catch_or_finally_seen = false;
1242 
1243   ConsumeToken(); // consume try
1244   if (Tok.isNot(tok::l_brace)) {
1245     Diag(Tok, diag::err_expected_lbrace);
1246     return StmtError();
1247   }
1248   OwningStmtResult CatchStmts(Actions);
1249   OwningStmtResult FinallyStmt(Actions);
1250   ParseScope TryScope(this, Scope::DeclScope);
1251   OwningStmtResult TryBody(ParseCompoundStatementBody());
1252   TryScope.Exit();
1253   if (TryBody.isInvalid())
1254     TryBody = Actions.ActOnNullStmt(Tok.getLocation());
1255 
1256   while (Tok.is(tok::at)) {
1257     // At this point, we need to lookahead to determine if this @ is the start
1258     // of an @catch or @finally.  We don't want to consume the @ token if this
1259     // is an @try or @encode or something else.
1260     Token AfterAt = GetLookAheadToken(1);
1261     if (!AfterAt.isObjCAtKeyword(tok::objc_catch) &&
1262         !AfterAt.isObjCAtKeyword(tok::objc_finally))
1263       break;
1264 
1265     SourceLocation AtCatchFinallyLoc = ConsumeToken();
1266     if (Tok.isObjCAtKeyword(tok::objc_catch)) {
1267       OwningStmtResult FirstPart(Actions);
1268       ConsumeToken(); // consume catch
1269       if (Tok.is(tok::l_paren)) {
1270         ConsumeParen();
1271         ParseScope CatchScope(this, Scope::DeclScope);
1272         if (Tok.isNot(tok::ellipsis)) {
1273           DeclSpec DS;
1274           ParseDeclarationSpecifiers(DS);
1275           // For some odd reason, the name of the exception variable is
1276           // optional. As a result, we need to use PrototypeContext.
1277           Declarator DeclaratorInfo(DS, Declarator::PrototypeContext);
1278           ParseDeclarator(DeclaratorInfo);
1279           if (DeclaratorInfo.getIdentifier()) {
1280             DeclTy *aBlockVarDecl = Actions.ActOnDeclarator(CurScope,
1281                                                           DeclaratorInfo, 0);
1282             FirstPart =
1283               Actions.ActOnDeclStmt(aBlockVarDecl,
1284                                     DS.getSourceRange().getBegin(),
1285                                     DeclaratorInfo.getSourceRange().getEnd());
1286           }
1287         } else
1288           ConsumeToken(); // consume '...'
1289         SourceLocation RParenLoc = ConsumeParen();
1290 
1291         OwningStmtResult CatchBody(Actions, true);
1292         if (Tok.is(tok::l_brace))
1293           CatchBody = ParseCompoundStatementBody();
1294         else
1295           Diag(Tok, diag::err_expected_lbrace);
1296         if (CatchBody.isInvalid())
1297           CatchBody = Actions.ActOnNullStmt(Tok.getLocation());
1298         CatchStmts = Actions.ActOnObjCAtCatchStmt(AtCatchFinallyLoc,
1299           RParenLoc, FirstPart.release(), CatchBody.release(),
1300           CatchStmts.release());
1301       } else {
1302         Diag(AtCatchFinallyLoc, diag::err_expected_lparen_after)
1303           << "@catch clause";
1304         return StmtError();
1305       }
1306       catch_or_finally_seen = true;
1307     } else {
1308       assert(Tok.isObjCAtKeyword(tok::objc_finally) && "Lookahead confused?");
1309       ConsumeToken(); // consume finally
1310       ParseScope FinallyScope(this, Scope::DeclScope);
1311 
1312       OwningStmtResult FinallyBody(Actions, true);
1313       if (Tok.is(tok::l_brace))
1314         FinallyBody = ParseCompoundStatementBody();
1315       else
1316         Diag(Tok, diag::err_expected_lbrace);
1317       if (FinallyBody.isInvalid())
1318         FinallyBody = Actions.ActOnNullStmt(Tok.getLocation());
1319       FinallyStmt = Actions.ActOnObjCAtFinallyStmt(AtCatchFinallyLoc,
1320                                                    FinallyBody.release());
1321       catch_or_finally_seen = true;
1322       break;
1323     }
1324   }
1325   if (!catch_or_finally_seen) {
1326     Diag(atLoc, diag::err_missing_catch_finally);
1327     return StmtError();
1328   }
1329   return Owned(Actions.ActOnObjCAtTryStmt(atLoc, TryBody.release(),
1330                                           CatchStmts.release(),
1331                                           FinallyStmt.release()));
1332 }
1333 
1334 ///   objc-method-def: objc-method-proto ';'[opt] '{' body '}'
1335 ///
1336 Parser::DeclTy *Parser::ParseObjCMethodDefinition() {
1337   DeclTy *MDecl = ParseObjCMethodPrototype(ObjCImpDecl);
1338   // parse optional ';'
1339   if (Tok.is(tok::semi))
1340     ConsumeToken();
1341 
1342   // We should have an opening brace now.
1343   if (Tok.isNot(tok::l_brace)) {
1344     Diag(Tok, diag::err_expected_method_body);
1345 
1346     // Skip over garbage, until we get to '{'.  Don't eat the '{'.
1347     SkipUntil(tok::l_brace, true, true);
1348 
1349     // If we didn't find the '{', bail out.
1350     if (Tok.isNot(tok::l_brace))
1351       return 0;
1352   }
1353   SourceLocation BraceLoc = Tok.getLocation();
1354 
1355   // Enter a scope for the method body.
1356   ParseScope BodyScope(this, Scope::FnScope|Scope::DeclScope);
1357 
1358   // Tell the actions module that we have entered a method definition with the
1359   // specified Declarator for the method.
1360   Actions.ObjCActOnStartOfMethodDef(CurScope, MDecl);
1361 
1362   OwningStmtResult FnBody(ParseCompoundStatementBody());
1363 
1364   // If the function body could not be parsed, make a bogus compoundstmt.
1365   if (FnBody.isInvalid())
1366     FnBody = Actions.ActOnCompoundStmt(BraceLoc, BraceLoc, 0, 0, false);
1367 
1368   // Leave the function body scope.
1369   BodyScope.Exit();
1370 
1371   // TODO: Pass argument information.
1372   Actions.ActOnFinishFunctionBody(MDecl, FnBody.release());
1373   return MDecl;
1374 }
1375 
1376 Parser::OwningStmtResult Parser::ParseObjCAtStatement(SourceLocation AtLoc) {
1377   if (Tok.isObjCAtKeyword(tok::objc_try)) {
1378     return ParseObjCTryStmt(AtLoc);
1379   } else if (Tok.isObjCAtKeyword(tok::objc_throw))
1380     return ParseObjCThrowStmt(AtLoc);
1381   else if (Tok.isObjCAtKeyword(tok::objc_synchronized))
1382     return ParseObjCSynchronizedStmt(AtLoc);
1383   OwningExprResult Res(ParseExpressionWithLeadingAt(AtLoc));
1384   if (Res.isInvalid()) {
1385     // If the expression is invalid, skip ahead to the next semicolon. Not
1386     // doing this opens us up to the possibility of infinite loops if
1387     // ParseExpression does not consume any tokens.
1388     SkipUntil(tok::semi);
1389     return StmtError();
1390   }
1391   // Otherwise, eat the semicolon.
1392   ExpectAndConsume(tok::semi, diag::err_expected_semi_after_expr);
1393   return Owned(Actions.ActOnExprStmt(Res.release()));
1394 }
1395 
1396 Parser::ExprResult Parser::ParseObjCAtExpression(SourceLocation AtLoc) {
1397   switch (Tok.getKind()) {
1398   case tok::string_literal:    // primary-expression: string-literal
1399   case tok::wide_string_literal:
1400     return ParsePostfixExpressionSuffix(
1401       Owned(ParseObjCStringLiteral(AtLoc))).result();
1402   default:
1403     if (Tok.getIdentifierInfo() == 0)
1404       return Diag(AtLoc, diag::err_unexpected_at);
1405 
1406     switch (Tok.getIdentifierInfo()->getObjCKeywordID()) {
1407     case tok::objc_encode:
1408       return ParsePostfixExpressionSuffix(
1409         Owned(ParseObjCEncodeExpression(AtLoc))).result();
1410     case tok::objc_protocol:
1411       return ParsePostfixExpressionSuffix(
1412         Owned(ParseObjCProtocolExpression(AtLoc))).result();
1413     case tok::objc_selector:
1414       return ParsePostfixExpressionSuffix(
1415         Owned(ParseObjCSelectorExpression(AtLoc))).result();
1416     default:
1417         return Diag(AtLoc, diag::err_unexpected_at);
1418     }
1419   }
1420 }
1421 
1422 ///   objc-message-expr:
1423 ///     '[' objc-receiver objc-message-args ']'
1424 ///
1425 ///   objc-receiver:
1426 ///     expression
1427 ///     class-name
1428 ///     type-name
1429 Parser::ExprResult Parser::ParseObjCMessageExpression() {
1430   assert(Tok.is(tok::l_square) && "'[' expected");
1431   SourceLocation LBracLoc = ConsumeBracket(); // consume '['
1432 
1433   // Parse receiver
1434   if (isTokObjCMessageIdentifierReceiver()) {
1435     IdentifierInfo *ReceiverName = Tok.getIdentifierInfo();
1436     SourceLocation NameLoc = ConsumeToken();
1437     return ParseObjCMessageExpressionBody(LBracLoc, NameLoc, ReceiverName, 0);
1438   }
1439 
1440   OwningExprResult Res(ParseExpression());
1441   if (Res.isInvalid()) {
1442     SkipUntil(tok::r_square);
1443     return Res.result();
1444   }
1445 
1446   return ParseObjCMessageExpressionBody(LBracLoc, SourceLocation(),
1447                                         0, Res.release());
1448 }
1449 
1450 /// ParseObjCMessageExpressionBody - Having parsed "'[' objc-receiver", parse
1451 /// the rest of a message expression.
1452 ///
1453 ///   objc-message-args:
1454 ///     objc-selector
1455 ///     objc-keywordarg-list
1456 ///
1457 ///   objc-keywordarg-list:
1458 ///     objc-keywordarg
1459 ///     objc-keywordarg-list objc-keywordarg
1460 ///
1461 ///   objc-keywordarg:
1462 ///     selector-name[opt] ':' objc-keywordexpr
1463 ///
1464 ///   objc-keywordexpr:
1465 ///     nonempty-expr-list
1466 ///
1467 ///   nonempty-expr-list:
1468 ///     assignment-expression
1469 ///     nonempty-expr-list , assignment-expression
1470 ///
1471 Parser::ExprResult
1472 Parser::ParseObjCMessageExpressionBody(SourceLocation LBracLoc,
1473                                        SourceLocation NameLoc,
1474                                        IdentifierInfo *ReceiverName,
1475                                        ExprTy *ReceiverExpr) {
1476   // Parse objc-selector
1477   SourceLocation Loc;
1478   IdentifierInfo *selIdent = ParseObjCSelector(Loc);
1479 
1480   llvm::SmallVector<IdentifierInfo *, 12> KeyIdents;
1481   ExprVector KeyExprs(Actions);
1482 
1483   if (Tok.is(tok::colon)) {
1484     while (1) {
1485       // Each iteration parses a single keyword argument.
1486       KeyIdents.push_back(selIdent);
1487 
1488       if (Tok.isNot(tok::colon)) {
1489         Diag(Tok, diag::err_expected_colon);
1490         // We must manually skip to a ']', otherwise the expression skipper will
1491         // stop at the ']' when it skips to the ';'.  We want it to skip beyond
1492         // the enclosing expression.
1493         SkipUntil(tok::r_square);
1494         return true;
1495       }
1496 
1497       ConsumeToken(); // Eat the ':'.
1498       ///  Parse the expression after ':'
1499       OwningExprResult Res(ParseAssignmentExpression());
1500       if (Res.isInvalid()) {
1501         // We must manually skip to a ']', otherwise the expression skipper will
1502         // stop at the ']' when it skips to the ';'.  We want it to skip beyond
1503         // the enclosing expression.
1504         SkipUntil(tok::r_square);
1505         return Res.result();
1506       }
1507 
1508       // We have a valid expression.
1509       KeyExprs.push_back(Res.release());
1510 
1511       // Check for another keyword selector.
1512       selIdent = ParseObjCSelector(Loc);
1513       if (!selIdent && Tok.isNot(tok::colon))
1514         break;
1515       // We have a selector or a colon, continue parsing.
1516     }
1517     // Parse the, optional, argument list, comma separated.
1518     while (Tok.is(tok::comma)) {
1519       ConsumeToken(); // Eat the ','.
1520       ///  Parse the expression after ','
1521       OwningExprResult Res(ParseAssignmentExpression());
1522       if (Res.isInvalid()) {
1523         // We must manually skip to a ']', otherwise the expression skipper will
1524         // stop at the ']' when it skips to the ';'.  We want it to skip beyond
1525         // the enclosing expression.
1526         SkipUntil(tok::r_square);
1527         return Res.result();
1528       }
1529 
1530       // We have a valid expression.
1531       KeyExprs.push_back(Res.release());
1532     }
1533   } else if (!selIdent) {
1534     Diag(Tok, diag::err_expected_ident); // missing selector name.
1535 
1536     // We must manually skip to a ']', otherwise the expression skipper will
1537     // stop at the ']' when it skips to the ';'.  We want it to skip beyond
1538     // the enclosing expression.
1539     SkipUntil(tok::r_square);
1540     return true;
1541   }
1542 
1543   if (Tok.isNot(tok::r_square)) {
1544     Diag(Tok, diag::err_expected_rsquare);
1545     // We must manually skip to a ']', otherwise the expression skipper will
1546     // stop at the ']' when it skips to the ';'.  We want it to skip beyond
1547     // the enclosing expression.
1548     SkipUntil(tok::r_square);
1549     return true;
1550   }
1551 
1552   SourceLocation RBracLoc = ConsumeBracket(); // consume ']'
1553 
1554   unsigned nKeys = KeyIdents.size();
1555   if (nKeys == 0)
1556     KeyIdents.push_back(selIdent);
1557   Selector Sel = PP.getSelectorTable().getSelector(nKeys, &KeyIdents[0]);
1558 
1559   // We've just parsed a keyword message.
1560   if (ReceiverName)
1561     return Actions.ActOnClassMessage(CurScope,
1562                                      ReceiverName, Sel,
1563                                      LBracLoc, NameLoc, RBracLoc,
1564                                      KeyExprs.take(), KeyExprs.size());
1565   return Actions.ActOnInstanceMessage(ReceiverExpr, Sel, LBracLoc, RBracLoc,
1566                                       KeyExprs.take(), KeyExprs.size());
1567 }
1568 
1569 Parser::ExprResult Parser::ParseObjCStringLiteral(SourceLocation AtLoc) {
1570   OwningExprResult Res(ParseStringLiteralExpression());
1571   if (Res.isInvalid()) return Res.result();
1572 
1573   // @"foo" @"bar" is a valid concatenated string.  Eat any subsequent string
1574   // expressions.  At this point, we know that the only valid thing that starts
1575   // with '@' is an @"".
1576   llvm::SmallVector<SourceLocation, 4> AtLocs;
1577   ExprVector AtStrings(Actions);
1578   AtLocs.push_back(AtLoc);
1579   AtStrings.push_back(Res.release());
1580 
1581   while (Tok.is(tok::at)) {
1582     AtLocs.push_back(ConsumeToken()); // eat the @.
1583 
1584     // Invalid unless there is a string literal.
1585     OwningExprResult Lit(Actions, true);
1586     if (isTokenStringLiteral())
1587       Lit = ParseStringLiteralExpression();
1588     else
1589       Diag(Tok, diag::err_objc_concat_string);
1590 
1591     if (Lit.isInvalid())
1592       return Lit.result();
1593 
1594     AtStrings.push_back(Lit.release());
1595   }
1596 
1597   return Actions.ParseObjCStringLiteral(&AtLocs[0], AtStrings.take(),
1598                                         AtStrings.size());
1599 }
1600 
1601 ///    objc-encode-expression:
1602 ///      @encode ( type-name )
1603 Parser::ExprResult Parser::ParseObjCEncodeExpression(SourceLocation AtLoc) {
1604   assert(Tok.isObjCAtKeyword(tok::objc_encode) && "Not an @encode expression!");
1605 
1606   SourceLocation EncLoc = ConsumeToken();
1607 
1608   if (Tok.isNot(tok::l_paren))
1609     return Diag(Tok, diag::err_expected_lparen_after) << "@encode";
1610 
1611   SourceLocation LParenLoc = ConsumeParen();
1612 
1613   TypeTy *Ty = ParseTypeName();
1614 
1615   SourceLocation RParenLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1616 
1617   return Actions.ParseObjCEncodeExpression(AtLoc, EncLoc, LParenLoc, Ty,
1618                                            RParenLoc);
1619 }
1620 
1621 ///     objc-protocol-expression
1622 ///       @protocol ( protocol-name )
1623 Parser::ExprResult Parser::ParseObjCProtocolExpression(SourceLocation AtLoc) {
1624   SourceLocation ProtoLoc = ConsumeToken();
1625 
1626   if (Tok.isNot(tok::l_paren))
1627     return Diag(Tok, diag::err_expected_lparen_after) << "@protocol";
1628 
1629   SourceLocation LParenLoc = ConsumeParen();
1630 
1631   if (Tok.isNot(tok::identifier))
1632     return Diag(Tok, diag::err_expected_ident);
1633 
1634   IdentifierInfo *protocolId = Tok.getIdentifierInfo();
1635   ConsumeToken();
1636 
1637   SourceLocation RParenLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1638 
1639   return Actions.ParseObjCProtocolExpression(protocolId, AtLoc, ProtoLoc,
1640                                              LParenLoc, RParenLoc);
1641 }
1642 
1643 ///     objc-selector-expression
1644 ///       @selector '(' objc-keyword-selector ')'
1645 Parser::ExprResult Parser::ParseObjCSelectorExpression(SourceLocation AtLoc) {
1646   SourceLocation SelectorLoc = ConsumeToken();
1647 
1648   if (Tok.isNot(tok::l_paren))
1649     return Diag(Tok, diag::err_expected_lparen_after) << "@selector";
1650 
1651   llvm::SmallVector<IdentifierInfo *, 12> KeyIdents;
1652   SourceLocation LParenLoc = ConsumeParen();
1653   SourceLocation sLoc;
1654   IdentifierInfo *SelIdent = ParseObjCSelector(sLoc);
1655   if (!SelIdent && Tok.isNot(tok::colon))
1656     return Diag(Tok, diag::err_expected_ident); // missing selector name.
1657 
1658   KeyIdents.push_back(SelIdent);
1659   unsigned nColons = 0;
1660   if (Tok.isNot(tok::r_paren)) {
1661     while (1) {
1662       if (Tok.isNot(tok::colon))
1663         return Diag(Tok, diag::err_expected_colon);
1664 
1665       nColons++;
1666       ConsumeToken(); // Eat the ':'.
1667       if (Tok.is(tok::r_paren))
1668         break;
1669       // Check for another keyword selector.
1670       SourceLocation Loc;
1671       SelIdent = ParseObjCSelector(Loc);
1672       KeyIdents.push_back(SelIdent);
1673       if (!SelIdent && Tok.isNot(tok::colon))
1674         break;
1675     }
1676   }
1677   SourceLocation RParenLoc = MatchRHSPunctuation(tok::r_paren, LParenLoc);
1678   Selector Sel = PP.getSelectorTable().getSelector(nColons, &KeyIdents[0]);
1679   return Actions.ParseObjCSelectorExpression(Sel, AtLoc, SelectorLoc, LParenLoc,
1680                                              RParenLoc);
1681  }
1682