CHCSVParser 1.0

CHCSVParser is an Objective-C parser for CSV files.<br /><br />Parsing<br />In order to parse CSV files, you'll need CHCSVParser.h and CHCSVParser.m. A CHCSVParser works very similarly to an NSXMLParser, in that it synchronously parses the data and invokes delegate callback methods to let you know that it has found a field, or has finished reading a line, or has encountered a syntax error.<br /><br />A CHCSVParser can be created either with a path to a CSV file, or with an NSString of CSV data.<br /><br />Writing<br />In order to write data to a CSV file, you'll need CHCSVWriter.h and CHCSVWriter.m. A CHCSVWriter has 2 primary methods (beyond the designated initializer): writeField: and writeLine.<br /><br />writeField: accepts an object and writes its -description (after being properly escaped) out to the CSV file. It will also write field seperator (,) if necessary. You may pass an empty string (@"") or nil to write an empty field.<br /><br />writeLine is used to terminate the current CSV line. If you do not invoke writeLine, then all of your CSV fields will be on a single line.<br /><br />Convenience Methods<br />Included in the code is an NSArray category to simplify reading from and writing to CSV files. In order to use these methods, you must include CHCSVParser.*, CHCSVWriter.*, and NSArray+CHCSVAdditions.* in your project (all six files). This category adds 7 methods to NSArray: three class methods, three initializers, and one write method:<br /><br /> . + (id) arrayWithContentsOfCSVFile:(NSString *)csvFile encoding:(NSStringEncoding)encoding error:(NSError **)error;<br /> . - (id) initWithContentsOfCSVFile:(NSString *)csvFile encoding:(NSStringEncoding)encoding error:(NSError **)error;<br /> . + (id) arrayWithContentsOfCSVFile:(NSString *)csvFile usedEncoding:(NSStringEncoding *)usedEncoding error:(NSError **)error;<br /> . - (id) initWithContentsOfCSVFile:(NSString *)csvFile usedEncoding:(NSStringEncoding *)usedEncoding error:(NSError **)error;<br /> . + (id) arrayWithContentsOfCSVString:(NSString *)csvString encoding:(NSStringEncoding)encoding error:(NSError **)error;<br /> . - (id) initWithContentsOfCSVString:(NSString *)csvString encoding:(NSStringEncoding)encoding error:(NSError **)error;<br /> . - (BOOL) writeToCSVFile:(NSString *)csvFile atomically:(BOOL)atomically;<br /><br />All of the initializers (both class and instance versions) return an NSArray of NSArray objects.<br /><br />The writeToCSVFile: method expects the same structure (an NSArray of NSArray objects).<br /><br />There is also an NSString category to parse an NSString of CSV data into an NSArray of NSArray objects. This method is:<br /><br /> - (NSArray *) CSVComponents;<br /><br />Both the NSArray and NSString categories require including the CHCSVSupport.h and CHCSVSupport.m files in your project.<br /><br />General Use<br />The simplest use of CHCSVParser is to include all of the files in your project:<br /><br /> . CHCSV.h<br /> . CHCSVParser.h and CHCSVParser.m<br /> . CHCSVWriter.h and CHCSVWriter.m<br /> . NSArray+CHCSVAdditions.h and NSArray+CHCSVAdditions.m<br /> . NSString+CHCSVAdditions.h and NSString+CHCSVAdditions.m<br /> . CHCSVSupport.h and CHCSVSupport.m<br /><br />Then to use any of the CSV parsing or writing functionality, simply #import "CHCSV.h" and use any of the classes and categories as you'd like.

Requirements:	No special requirements
Platforms:	Mac, Mac OS X v10.5
Keyword:	Arraywithcontentsofcsvstringnsstring,  Atomicallyboolatomicallyall,  Csvfile,  Encodingnsstringencodingencoding,  Error,  Errornserror,  Initwithcon,  Initwithcontentsofcsvfilensstring,  Instance,  Usedencoding,  Usedencodingnsstringencoding,  Writetocsvfilensstring
Users rating:	0/10