(Preliminary Documentation) Copyright ã1994 by NeXT Computer, Inc.  All Rights Reserved.

NSMutableString 

Inherits From:	NSString : NSObject 

Conforms To:	NSCoding
NSCopying
NSMutableCopying
NSObject 

Declared In:	foundation/NSString.h 

Creating Temporary Strings 

+ (NSMutableString *)localizedStringWithFormat:(NSString *)format,...
	Returns a string created by using format as a printf() style format string, and the following arguments as values to be substituted into the format string.  The user's default locale is used for format information.
+ (NSMutableString *)stringWithCString:(const char *)byteString
	Returns a mutable string containing the characters in byteString, which must be null-terminated.  byteString should contain bytes in the default C string encoding.
+ (NSMutableString *)stringWithCString:(const char *)byteString
length:(unsigned)length	Returns a mutable string containing length characters made from byteString.  This method doesn't stop at a null byte.  byteString should contain bytes in the default C string encoding.
+ (NSMutableString *)stringWithCapacity:(unsigned)capacity
	Returns an empty mutable string, using capacity as a hint for how much initial storage to reserve.
+ (NSMutableString *)stringWithCharacters:(const unichar *)chars
length:(unsigned)length	Returns a mutable string containing chars.  The first length characters are copied into the string.  This method doesn't stop at a null character.
+ (NSMutableString *)stringWithFormat:(NSString *)format,...
	Returns a mutable string created by using format as a printf() style format string, and the subsequent arguments as values to be substituted into the format string.

Initializing a Mutable String

- initWithCapacity:(unsigned int)capacity	Initializes a newly allocated mutable string object, giving it enough allocated memory to hold capacity characters.

Modifying a String

- (void)appendFormat:(NSString *)format,...	Adds a constructed string to the receiver.  The new characters are created by using format as a printf() style format string, and the following arguments as values to be substituted into the format string.  Invokes replaceCharactersInRange:withString: as part of its implementation.
- (void)appendString:(NSString *)aString	Adds the characters of aString to end of the receiver.    Invokes replaceCharactersInRange:withString: as part of its implementation.
- (void)deleteCharactersInRange:(NSRange)aRange
	Removes from the receiver the characters in aRange.  This method raises an NSStringBoundsError exception if any part of aRange lies beyond the end of the string.    Invokes replaceCharactersInRange:withString: as part of its implementation.
- (void)insertString:(NSString *)aString	Inserts the characters of aString into the receiver, such that
atIndex:(unsigned)index	 	the new characters begin at index and the existing character from index to the end are shifted by the length of aString.  This method raises an NSStringBoundsError exception if index lies beyond the end of the string.    Invokes replaceCharactersInRange:withString: as part of its implementation.
- (void)replaceCharactersInRange:(NSRange)aRange
withString:(NSString *)otherString	Inserts the characters of otherString into the receiver, such that they replace the characters in aRange.  This method raises an NSStringBoundsError exception if any part of aRange lies beyond the end of the string.
- (void)setString:(NSString *)aString	Replaces the characters of the receiver with those in aString.