//  NSString_HMext.m
 //
 //  Created by John Wiseman on 9/6/05.
 //  Copyright 2005 John Wiseman.
 //
 //  Licensed under the MIT license--see the accompanying LICENSE.txt
 //  file.
 
 #import "NSString_HMExt.h"
 #import "NSData_HMExt.h"
 
 @implementation NSString (NSString_ParsingExtensions)
 
 /*
  * Returns an NSArray containing substrings from the receiver that have been
  * divided by characters in separatorSet. The substrings in the array appear
  * in the order they did in the receiver.
  *
  * Based on GnuStep's componentsSeparatedByString.
  */
 - (NSArray*) componentsSeparatedByCharacterFromSet: (NSCharacterSet*)separatorSet
 {
 	NSRange search;
 	NSRange complete;
 	NSRange found;
 	NSMutableArray *array = [NSMutableArray array];
 
 	search = NSMakeRange(0, [self length]);
 	complete = search;
 	found = [self rangeOfCharacterFromSet:separatorSet];
 	while (found.length != 0)
     {
 		NSRange current;
 
 		current = NSMakeRange(search.location, found.location - search.location);
 		[array addObject:[self substringWithRange:current]];
 
 		search = NSMakeRange(found.location + found.length, complete.length - found.location - found.length);
 		found = [self rangeOfCharacterFromSet:separatorSet options:0 range:search];
     }
 	// Add the last search string range
 	[array addObject: [self substringWithRange: search]];
 
 	return array;
 }
 
 /**
  * Load up to the first theMaxSize bytes of file at path into a new string.
  */
 + (NSString*)stringWithContentsOfFile:(NSString*)pathToFile maxSize:(int)theMaxSize encoding:(NSStringEncoding)theEncoding error:(NSError**)theError
 {
 	NSString	*obj;
 	
 	obj = [self allocWithZone:NSDefaultMallocZone()];
 	obj = [obj initWithContentsOfFile:pathToFile maxSize:theMaxSize encoding:theEncoding error:theError];
 	return [obj autorelease];
 }
 
 /**
  * Initialises the receiver with up to the first maxSize bytes of the
  * file at path.
  *
  * Invokes [NSData-initWithContentsOfFile:maxSize:error:] to read the
  * file, then examines the data to infer its encoding type, and
  * converts the data to a string using -initWithData:encoding:
  *
  * Releases the receiver and returns nil if the file could not be read
  * and converted to a string.
  * 
  */
 - (NSString*)initWithContentsOfFile:(NSString*)path maxSize:(int)theMaxSize encoding:(NSStringEncoding)theEncoding error:(NSError**)theError
 {
 	NSData		*d;
 	unsigned int		len;
 	const unsigned char	*data_bytes;
 	
 	d = [[NSData alloc] initWithContentsOfFile:path maxSize:theMaxSize error:theError];
 	if (d == nil)
     {
 		[self dealloc];
 		return nil;
     }
 	len = [d length];
 	if (len == 0)
     {
 		[d release];
 		[self dealloc];
 		return @"";
     }
 	data_bytes = [d bytes];
 	
 	self = [self initWithData:d encoding:theEncoding];
 	[d release];
 	return self;
 }
 
 @end