Combining and dividing strings – Apple WebObjects 3.5 User Manual

Page 193

Commonly Used String Methods

193

+ stringWithContentsOfFile:

Returns a string created by reading characters from a speciﬁed ﬁle.
For example, the following statement creates an NSString
containing the contents of the ﬁle speciﬁed in

path

id fileContents = [NSString stringWithContentsOfFile:path];

See also

writeToFile:atomically:

(page 195) .

Combining and Dividing Strings

– stringByAppendingFormat:

Returns a string made by appending to the receiver a string
constructed from a speciﬁed format string and the arguments
following it in the manner of

stringWithFormat:

. For example, assume

the variable

guestName

contains the string “Rena”. Then the

following code excerpt produces the string

message

with contents

“Hi, Rena!”:

id string = @"Hi";
id message = [string stringByAppendingFormat:@", %@!",

guestName];

– stringByAppendingString:

Returns a string made by appending a speciﬁed string to the
receiver. This code excerpt, for example, produces the string
“Error: premature end of ﬁle.”:

id errorTag = @"Error: ";
id errorString = @"premature end of file.";
id errorMessage = [errorTag

stringByAppendingString:errorString];

– componentsSeparatedByString:

Returns an NSArray containing substrings from the receiver that
have been divided by a speciﬁed separator string. For example,
the following statements produce an NSArray containing the
strings “wrenches”, “hammers”, and “saws”:

id toolString = @"wrenches, hammers, saws";
id toolArray = [toolString componentsSeparatedByString:@", "];