1 // 2 // ANTLRTreeWizard.h 3 // ANTLR 4 // 5 // Created by Alan Condit on 6/18/10. 6 // [The "BSD licence"] 7 // Copyright (c) 2010 Alan Condit 8 // All rights reserved. 9 // 10 // Redistribution and use in source and binary forms, with or without 11 // modification, are permitted provided that the following conditions 12 // are met: 13 // 1. Redistributions of source code must retain the above copyright 14 // notice, this list of conditions and the following disclaimer. 15 // 2. Redistributions in binary form must reproduce the above copyright 16 // notice, this list of conditions and the following disclaimer in the 17 // documentation and/or other materials provided with the distribution. 18 // 3. The name of the author may not be used to endorse or promote products 19 // derived from this software without specific prior written permission. 20 // 21 // THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 22 // IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 23 // OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24 // IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25 // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 26 // NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30 // THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31 32 #import <Cocoa/Cocoa.h> 33 #import "ANTLRCommonTreeAdaptor.h" 34 #import "ANTLRCommonTree.h" 35 #import "ANTLRMapElement.h" 36 #import "ANTLRMap.h" 37 #import "AMutableArray.h" 38 39 @class ANTLRVisitor; 40 41 @protocol ANTLRContextVisitor <NSObject> 42 // TODO: should this be called visit or something else? 43 - (void) visit:(ANTLRCommonTree *)t Parent:(ANTLRCommonTree *)parent ChildIndex:(NSInteger)childIndex Map:(ANTLRMap *)labels; 44 45 @end 46 47 @interface ANTLRVisitor : NSObject <ANTLRContextVisitor> { 48 NSInteger action; 49 id actor; 50 id object1; 51 id object2; 52 } 53 + (ANTLRVisitor *)newANTLRVisitor:(NSInteger)anAction Actor:(id)anActor Object:(id)anObject1 Object:(id)anObject2; 54 - (id) initWithAction:(NSInteger)anAction Actor:(id)anActor Object:(id)anObject1 Object:(id)anObject2; 55 56 - (void) visit:(ANTLRCommonTree *)t; 57 - (void) visit:(ANTLRCommonTree *)t Parent:(ANTLRCommonTree *)parent ChildIndex:(NSInteger)childIndex Map:(ANTLRMap *)labels; 58 59 @property NSInteger action; 60 @property (retain) id actor; 61 @property (retain) id object1; 62 @property (retain) id object2; 63 @end 64 65 /** When using %label:TOKENNAME in a tree for parse(), we must 66 * track the label. 67 */ 68 @interface ANTLRTreePattern : ANTLRCommonTree { 69 NSString *label; 70 BOOL hasTextArg; 71 } 72 @property (retain, getter=getLabel, setter=setLabel:) NSString *label; 73 @property (assign, getter=getHasTextArg, setter=setHasTextArg:) BOOL hasTextArg; 74 75 + (ANTLRCommonTree *)newANTLRTreePattern:(id<ANTLRToken>)payload; 76 77 - (id) initWithToken:(id<ANTLRToken>)payload; 78 - (NSString *)toString; 79 @end 80 81 @interface ANTLRWildcardTreePattern : ANTLRTreePattern { 82 } 83 84 + (ANTLRWildcardTreePattern *)newANTLRWildcardTreePattern:(id<ANTLRToken>)payload; 85 - (id) initWithToken:(id<ANTLRToken>)payload; 86 @end 87 88 /** This adaptor creates TreePattern objects for use during scan() */ 89 @interface ANTLRTreePatternTreeAdaptor : ANTLRCommonTreeAdaptor { 90 } 91 + (ANTLRTreePatternTreeAdaptor *)newTreeAdaptor; 92 - (id) init; 93 - (ANTLRCommonTree *)createTreePattern:(id<ANTLRToken>)payload; 94 95 @end 96 97 @interface ANTLRTreeWizard : NSObject { 98 id<ANTLRTreeAdaptor> adaptor; 99 ANTLRMap *tokenNameToTypeMap; 100 } 101 + (ANTLRTreeWizard *) newANTLRTreeWizard:(id<ANTLRTreeAdaptor>)anAdaptor; 102 + (ANTLRTreeWizard *)newANTLRTreeWizard:(id<ANTLRTreeAdaptor>)adaptor Map:(ANTLRMap *)aTokenNameToTypeMap; 103 + (ANTLRTreeWizard *)newANTLRTreeWizard:(id<ANTLRTreeAdaptor>)adaptor TokenNames:(NSArray *)theTokNams; 104 + (ANTLRTreeWizard *)newANTLRTreeWizardWithTokenNames:(NSArray *)theTokNams; 105 - (id) init; 106 - (id) initWithAdaptor:(id<ANTLRTreeAdaptor>)adaptor; 107 - (id) initWithAdaptor:(id<ANTLRTreeAdaptor>)adaptor Map:(ANTLRMap *)tokenNameToTypeMap; 108 - (id) initWithTokenNames:(NSArray *)theTokNams; 109 - (id) initWithTokenNames:(id<ANTLRTreeAdaptor>)anAdaptor TokenNames:(NSArray *)theTokNams; 110 - (void) dealloc; 111 - (ANTLRMap *)computeTokenTypes:(NSArray *)theTokNams; 112 - (NSInteger)getTokenType:(NSString *)tokenName; 113 - (ANTLRMap *)index:(ANTLRCommonTree *)t; 114 - (void) _index:(ANTLRCommonTree *)t Map:(ANTLRMap *)m; 115 - (AMutableArray *)find:(ANTLRCommonTree *) t Pattern:(NSString *)pattern; 116 - (ANTLRTreeWizard *)findFirst:(ANTLRCommonTree *) t Type:(NSInteger)ttype; 117 - (ANTLRTreeWizard *)findFirst:(ANTLRCommonTree *) t Pattern:(NSString *)pattern; 118 - (void) visit:(ANTLRCommonTree *)t Type:(NSInteger)ttype Visitor:(ANTLRVisitor *)visitor; 119 - (void) _visit:(ANTLRCommonTree *)t 120 Parent:(ANTLRCommonTree *)parent 121 ChildIndex:(NSInteger)childIndex 122 Type:(NSInteger)ttype 123 Visitor:(ANTLRVisitor *)visitor; 124 - (void)visit:(ANTLRCommonTree *)t Pattern:(NSString *)pattern Visitor:(ANTLRVisitor *)visitor; 125 - (BOOL)parse:(ANTLRCommonTree *)t Pattern:(NSString *)pattern Map:(ANTLRMap *)labels; 126 - (BOOL) parse:(ANTLRCommonTree *) t Pattern:(NSString *)pattern; 127 - (BOOL) _parse:(ANTLRCommonTree *)t1 Pattern:(ANTLRCommonTree *)tpattern Map:(ANTLRMap *)labels; 128 - (ANTLRCommonTree *) createTree:(NSString *)pattern; 129 - (BOOL)equals:(id)t1 O2:(id)t2 Adaptor:(id<ANTLRTreeAdaptor>)anAdaptor; 130 - (BOOL)equals:(id)t1 O2:(id)t2; 131 - (BOOL) _equals:(id)t1 O2:(id)t2 Adaptor:(id<ANTLRTreeAdaptor>)anAdaptor; 132 133 @property (retain) id<ANTLRTreeAdaptor> adaptor; 134 @property (retain) ANTLRMap *tokenNameToTypeMap; 135 @end 136 137
