HGKeeper

// LMXParser.h

// LMX

// Created by Peter Hosey on 2005-10-14.

#include <sys/types.h>

@class NSString;

enum LMXParseResult {

LMXParsedCompletely = 0, //Element stack reached zero depth, and there was no more XML to parse

LMXParsedIncomplete = -1, //Element stack is not empty; more data is wanted

LMXParsedCompletelyWithExtraData = -2, //Element stack reached zero depth, but there's still XML to parse

};

extern NSString *LMXStringFromParseResult(enum LMXParseResult result);

extern enum LMXParseResult LMXParseResultFromString(NSString *result);

@interface LMXParser : NSObject {

NSMutableData *dataToParse;

off_t currentIndex;

NSMutableArray *elementStack;

id delegate;

void *contextInfo;

//Parser state

NSMutableString *characters;

NSMutableString *currentToken;

NSMutableString *entityName;

NSMutableString *comment;

NSString *systemID;

NSMutableDictionary *overrideDict; //Stores any entities that we're using our own values instead of the DTD's values for

NSMutableDictionary *cacheDict; //Caches entity values

NSMutableDictionary *attributes;

NSString *attributeValue;

off_t charactersRunStartIndex, tokenRunStartIndex, entityNameRunStartIndex, commentRunStartIndex;

off_t greaterThanIndex;

unsigned reserved:22;

unsigned inComment:1;

//Start of a comment: <!--

// End of a comment: -->

unsigned hasBang:1; //With has{First,Second}Hyphen, indicates a comment may be about to start (if a < is encountered)

unsigned hasSecondHyphen:1; //With hasGreaterThan and hasFirstHyphen, part of the start of a comment

unsigned hasFirstHyphen:1; //With hasGreaterThan, 1/3 of the end of a comment; else, 1/3 of the start of a comment

unsigned hasEqualSign:1; //An attribute value has been recorded, and a = encountered

unsigned couldBeEndTag:1; //A / has been encountered

unsigned isEmptyTag:1; //A / was encountered immediately after a >

unsigned inEntity:1; //In between & and ;

unsigned hasHashMark:1; //A # was just encountered (if this is 1 when the & is encountered, it's a numeric entity; otherwise, the entity ends)

unsigned noNonWhitespaceSinceTagEnd:1; //Used by / to check for a <blah/> tag

unsigned inTag:1; //In between < and >

unsigned parsing:1; //Set to 0 by -pause

char attributeQuoteChar; //One of '"', '\'', or '\0'

}

//How to get an autoreleased parser in only one message instead of three:

+ parser;

- initWithData:(NSData *)data;

#pragma mark -

- (NSString *)systemID;

- (void)setSystemID:(NSString *)sysID;

- (void)overrideEntityNamed:(NSString *)name withValue:(NSData *)val;

- (void)setOverriddenEntities:(NSDictionary *)entityDict;

- (NSData *)dataForEntityNamed:(NSString *)name;

#pragma mark -

- (enum LMXParseResult)parseChunk:(NSData *)data;

- (void)addData:(NSData *)data; //Add more data (in front of the existing data) without parsing

- (enum LMXParseResult)parse; //Begin/resume parsing without adding more data

#pragma mark -

//Either or both of these can be called by the delegate.

- (void)pause;

- (enum LMXParseResult)resume; //Synonym for -parse

//Calling -reset leaves the parser in the same state it was in (more or less) after it was inited.

//*Don't* call this from the delegate.

- (void)reset;

#pragma mark -

- delegate;

- setDelegate:newDelegate; //Returns old delegate.

- (void *)contextInfo;

- (void)setContextInfo:(void *)newContextInfo;

@end

@interface LMXParser (LMXCompatibilityWithNSXMLParser)

- initWithData:(NSData *)data; //Same as -init, -addData:

- (void)abortParsing; //Compatibility synonym for -pause

@end

@interface NSObject (LMXParserDelegate)

- (void)parserDidStartDocument:(LMXParser *)parser;

- (void)parser:(LMXParser *)parser elementEnded:(NSString *)elementName;

//Returns one or two UTF-16 code units, or nil.

- (NSData *)parser:(LMXParser *)parser resolveExternalEntityName:(NSString *)entityName systemID:(NSString *)systemID;

- (void)parser:(LMXParser *)parser foundCharacters:(NSString *)string;

- (void)parser:(LMXParser *)parser elementStarted:(NSString *)elementName attributes:(NSDictionary *)attributes;

- (void)parserDidEndDocument:(LMXParser *)parser;

- (void)parser:(LMXParser *)parser finishedParsingChunk:(NSData *)chunkData withResult:(enum LMXParseResult)result;

@end

adium/adium