mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-26 18:21:04 +00:00
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@11371 72102866-910b-0410-8b05-ffd578937521
698 lines
24 KiB
HTML
698 lines
24 KiB
HTML
<html><head>
|
|
<title>NSString</title>
|
|
</head>
|
|
<body>
|
|
<a href ="NSSet.html">[Previous] </a>
|
|
<a href ="Base.html">[Up] </a>
|
|
<a href ="NSTask.html">[Next] </a>
|
|
<h1>NSString</h1>
|
|
<h3>Authors </h3>
|
|
<dl>
|
|
<dt><a href ="http://www.gnustep.org/developers/whoiswho.html">Richard Frith-Macdonald</a>
|
|
<dd>
|
|
<dt>James Dessart
|
|
<dd>
|
|
</dl>
|
|
<p>Version: $Revision$</p>
|
|
<p>Date: $Date$</p>
|
|
<h2><a name ="cont-0">NSString</a></h2>
|
|
<h2><a name ="NSString">NSString</a></h2>
|
|
<p><b>Declared in: </b> Foundation/NSString.h</p>
|
|
<p><b>Inherits from: </b> NSObject</p>
|
|
<p><b>Conforms to: </b> NSCoding
|
|
</p>
|
|
<hr>
|
|
|
|
<p>
|
|
|
|
NSString objects represent an immutable string of characters.
|
|
NSString itself is an abstract class which provides factory
|
|
methods to generate objects of unspecified subclasses.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
A constant NSString can be created using the following syntax:
|
|
<code>@"..."</code>, where the contents of the quotes are the
|
|
string, using only ASCII characters.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
To create a concrete subclass of NSString, you must have your
|
|
class inherit from NSString and override at least the two
|
|
primitive methods - length and characterAtIndex:
|
|
</p>
|
|
|
|
<p>
|
|
|
|
In general the rule is that your subclass must override any
|
|
initialiser that you want to use with it. The GNUstep
|
|
implementation relaxes that to say that, you may override
|
|
only the <em>designated initialiser</em> and the other
|
|
initialisation methods should work.
|
|
</p>
|
|
|
|
|
|
<h2>Instance Variables </h2>
|
|
<ul>
|
|
</ul>
|
|
<h2>Methods </h2>
|
|
<ul>
|
|
<li ><a href ="NSString.html#method-0">+availableStringEncodings</a>
|
|
<li ><a href ="NSString.html#method-1">+defaultCStringEncoding</a>
|
|
<li ><a href ="NSString.html#method-37">+getLineStart:end:contentsEnd:</a>
|
|
<li ><a href ="NSString.html#method-60">+lineRangeForRange:</a>
|
|
<li ><a href ="NSString.html#method-2">+localizedNameOfStringEncoding:</a>
|
|
<li ><a href ="NSString.html#method-3">+localizedStringWithFormat:</a>
|
|
<li ><a href ="NSString.html#method-4">+pathWithComponents:</a>
|
|
<li ><a href ="NSString.html#method-5">+string</a>
|
|
<li ><a href ="NSString.html#method-8">+stringWithCString:</a>
|
|
<li ><a href ="NSString.html#method-9">+stringWithCString:</a>
|
|
<li ><a href ="NSString.html#method-6">+stringWithCharacters:length:</a>
|
|
<li ><a href ="NSString.html#method-7">+stringWithContentsOfFile:</a>
|
|
<li ><a href ="NSString.html#method-10">+stringWithFormat:</a>
|
|
<li ><a href ="NSString.html#method-11">+stringWithString:</a>
|
|
<li ><a href ="NSString.html#method-22">-cString</a>
|
|
<li ><a href ="NSString.html#method-23">-cStringLength</a>
|
|
<li ><a href ="NSString.html#method-12">-canBeConvertedToEncoding:</a>
|
|
<li ><a href ="NSString.html#method-13">-capitalizedString</a>
|
|
<li ><a href ="NSString.html#method-14">-caseInsensitiveCompare:</a>
|
|
<li ><a href ="NSString.html#method-15">-characterAtIndex:</a>
|
|
<li ><a href ="NSString.html#method-16">-commonPrefixWithString:</a>
|
|
<li ><a href ="NSString.html#method-17">-compare:</a>
|
|
<li ><a href ="NSString.html#method-18">-compare:</a>
|
|
<li ><a href ="NSString.html#method-19">-compare:options:range:</a>
|
|
<li ><a href ="NSString.html#method-20">-completePathIntoString:caseSensitive:matchesIntoArray:</a>
|
|
<li ><a href ="NSString.html#method-21">-componentsSeparatedByString:</a>
|
|
<li ><a href ="NSString.html#method-24">-dataUsingEncoding:</a>
|
|
<li ><a href ="NSString.html#method-25">-dataUsingEncoding:allowLossyConversion:</a>
|
|
<li ><a href ="NSString.html#method-26">-description</a>
|
|
<li ><a href ="NSString.html#method-27">-doubleValue</a>
|
|
<li ><a href ="NSString.html#method-28">-fastestEncoding</a>
|
|
<li ><a href ="NSString.html#method-29">-fileSystemRepresentation</a>
|
|
<li ><a href ="NSString.html#method-30">-floatValue</a>
|
|
<li ><a href ="NSString.html#method-33">-getCString:</a>
|
|
<li ><a href ="NSString.html#method-34">-getCString:maxLength:</a>
|
|
<li ><a href ="NSString.html#method-35">-getCString:maxLength:range:remainingRange:</a>
|
|
<li ><a href ="NSString.html#method-31">-getCharacters:</a>
|
|
<li ><a href ="NSString.html#method-32">-getCharacters:</a>
|
|
<li ><a href ="NSString.html#method-36">-getFileSystemRepresentation:maxLength:</a>
|
|
<li ><a href ="NSString.html#method-39">-hasPrefix:</a>
|
|
<li ><a href ="NSString.html#method-40">-hasSuffix:</a>
|
|
<li ><a href ="NSString.html#method-38">-hash</a>
|
|
<li ><a href ="NSString.html#method-41">-init</a>
|
|
<li ><a href ="NSString.html#method-45">-initWithCString:</a>
|
|
<li ><a href ="NSString.html#method-46">-initWithCString:</a>
|
|
<li ><a href ="NSString.html#method-47">-initWithCStringNoCopy:length:freeWhenDone:</a>
|
|
<li ><a href ="NSString.html#method-42">-initWithCharacters:</a>
|
|
<li ><a href ="NSString.html#method-43">-initWithCharactersNoCopy:length:freeWhenDone:</a>
|
|
<li ><a href ="NSString.html#method-44">-initWithContentsOfFile:</a>
|
|
<li ><a href ="NSString.html#method-48">-initWithData:encoding:</a>
|
|
<li ><a href ="NSString.html#method-49">-initWithFormat:</a>
|
|
<li ><a href ="NSString.html#method-52">-initWithFormat:arguments:</a>
|
|
<li ><a href ="NSString.html#method-50">-initWithFormat:arguments:</a>
|
|
<li ><a href ="NSString.html#method-51">-initWithFormat:locale:</a>
|
|
<li ><a href ="NSString.html#method-53">-initWithFormat:locale:arguments:</a>
|
|
<li ><a href ="NSString.html#method-54">-initWithString:</a>
|
|
<li ><a href ="NSString.html#method-55">-intValue</a>
|
|
<li ><a href ="NSString.html#method-56">-isAbsolutePath</a>
|
|
<li ><a href ="NSString.html#method-57">-isEqualToString:</a>
|
|
<li ><a href ="NSString.html#method-58">-lastPathComponent</a>
|
|
<li ><a href ="NSString.html#method-59">-length</a>
|
|
<li ><a href ="NSString.html#method-61">-lossyCString</a>
|
|
<li ><a href ="NSString.html#method-62">-lowercaseString</a>
|
|
<li ><a href ="NSString.html#method-63">-pathComponents</a>
|
|
<li ><a href ="NSString.html#method-64">-pathExtension</a>
|
|
<li ><a href ="NSString.html#method-65">-propertyList</a>
|
|
<li ><a href ="NSString.html#method-66">-propertyListFromStringsFileFormat</a>
|
|
<li ><a href ="NSString.html#method-67">-rangeOfCharacterFromSet:</a>
|
|
<li ><a href ="NSString.html#method-68">-rangeOfCharacterFromSet:options:</a>
|
|
<li ><a href ="NSString.html#method-69">-rangeOfCharacterFromSet:options:range:</a>
|
|
<li ><a href ="NSString.html#method-70">-rangeOfComposedCharacterSequenceAtIndex:</a>
|
|
<li ><a href ="NSString.html#method-71">-rangeOfString:</a>
|
|
<li ><a href ="NSString.html#method-72">-rangeOfString:options:</a>
|
|
<li ><a href ="NSString.html#method-73">-rangeOfString:options:range:</a>
|
|
<li ><a href ="NSString.html#method-74">-smallestEncoding</a>
|
|
<li ><a href ="NSString.html#method-75">-stringByAbbreviatingWithTildeInPath</a>
|
|
<li ><a href ="NSString.html#method-76">-stringByAppendingFormat:</a>
|
|
<li ><a href ="NSString.html#method-77">-stringByAppendingPathComponent:</a>
|
|
<li ><a href ="NSString.html#method-78">-stringByAppendingPathExtension:</a>
|
|
<li ><a href ="NSString.html#method-79">-stringByAppendingString:</a>
|
|
<li ><a href ="NSString.html#method-80">-stringByDeletingLastPathComponent</a>
|
|
<li ><a href ="NSString.html#method-81">-stringByDeletingPathExtension</a>
|
|
<li ><a href ="NSString.html#method-82">-stringByExpandingTildeInPath</a>
|
|
<li ><a href ="NSString.html#method-83">-stringByReplacingString:withString:</a>
|
|
<li ><a href ="NSString.html#method-84">-stringsByAppendingPaths:</a>
|
|
<li ><a href ="NSString.html#method-85">-substringFromIndex:</a>
|
|
<li ><a href ="NSString.html#method-86">-substringToIndex:</a>
|
|
<li ><a href ="NSString.html#method-87">-substringWithRange:</a>
|
|
<li ><a href ="NSString.html#method-88">-uppercaseString</a>
|
|
<li ><a href ="NSString.html#method-89">-writeToFile:atomically:</a>
|
|
</ul>
|
|
<hr><h2>Class Methods </h2>
|
|
<h3><a name ="method-0">availableStringEncodings</a></h3>
|
|
+ (const NSStringEncoding*) <b>availableStringEncodings</b>;<br>
|
|
|
|
<p>
|
|
|
|
Returns an array of all available string encodings,
|
|
terminated by a null value.
|
|
</p>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-1">defaultCStringEncoding</a></h3>
|
|
+ (NSStringEncoding) <b>defaultCStringEncoding</b>;<br>
|
|
|
|
<p>
|
|
|
|
Returns the encoding used for any method accepting a C string.
|
|
This value is determined automatically from the programs
|
|
environment and cannot be changed programmatically.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
You should <em>NOT</em> override this method in an attempt to
|
|
change the encoding being used.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
In GNUstep, this encoding is determined by the initial value
|
|
of the <code>GNUSTEP_STRING_ENCODING</code> environment
|
|
variable. If this is not defined,
|
|
<code>NSISOLatin1StringEncoding</code> is assumed.
|
|
</p>
|
|
|
|
<p>
|
|
|
|
The default C string encoding must be a characterset containing
|
|
7 or 8 bit characters, and where the characters are a superset
|
|
of the 7-bit ASCII characterset. In particular, this means
|
|
that NSUTF8StringEncoding and NSUnicodeStringEncoding are not
|
|
permissable.
|
|
</p>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-2">localizedNameOfStringEncoding:</a></h3>
|
|
+ (NSString*) <b>localizedNameOfStringEncoding:</b> (NSStringEncoding)encoding;<br>
|
|
|
|
<p>
|
|
|
|
Returns the localized name of the encoding specified
|
|
by <var>encoding</var>.
|
|
</p>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-3">localizedStringWithFormat:</a></h3>
|
|
+ (NSString*) <b>localizedStringWithFormat:</b> (NSString*)format,;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-4">pathWithComponents:</a></h3>
|
|
+ (NSString*) <b>pathWithComponents:</b> (NSArray*)components;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-5">string</a></h3>
|
|
+ (id) <b>string</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-6">stringWithCharacters:length:</a></h3>
|
|
+ (id) <b>stringWithCharacters:</b> (const unichar*)chars <b>length:</b> (unsigned int)length;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-7">stringWithContentsOfFile:</a></h3>
|
|
+ (id) <b>stringWithContentsOfFile:</b> (NSString*)path;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-8">stringWithCString:</a></h3>
|
|
+ (id) <b>stringWithCString:</b> (const char*)cString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-9">stringWithCString:</a></h3>
|
|
+ (id) <b>stringWithCString:</b> (const char*)cString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-10">stringWithFormat:</a></h3>
|
|
+ (id) <b>stringWithFormat:</b> (NSString*)format,;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-11">stringWithString:</a></h3>
|
|
+ (id) <b>stringWithString:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-37">getLineStart:end:contentsEnd:</a></h3>
|
|
+ (void) <b>getLineStart:</b> (unsigned int*)startIndex <b>end:</b> (unsigned int*)lineEndIndex <b>contentsEnd:</b> (unsigned int*)contentsEndIndex;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-60">lineRangeForRange:</a></h3>
|
|
+ (NSRange) <b>lineRangeForRange:</b> (NSRange)aRange;<br>
|
|
|
|
|
|
<hr>
|
|
<hr><h2>Instances Methods </h2>
|
|
<h3><a name ="method-12">canBeConvertedToEncoding:</a></h3>
|
|
- (BOOL) <b>canBeConvertedToEncoding:</b> (NSStringEncoding)encoding;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-13">capitalizedString</a></h3>
|
|
- (NSString*) <b>capitalizedString</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-14">caseInsensitiveCompare:</a></h3>
|
|
- (NSComparisonResult) <b>caseInsensitiveCompare:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-15">characterAtIndex:</a></h3>
|
|
- (unichar) <b>characterAtIndex:</b> (unsigned int)index;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-16">commonPrefixWithString:</a></h3>
|
|
- (NSString*) <b>commonPrefixWithString:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-17">compare:</a></h3>
|
|
- (NSComparisonResult) <b>compare:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-18">compare:</a></h3>
|
|
- (NSComparisonResult) <b>compare:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-19">compare:options:range:</a></h3>
|
|
- (NSComparisonResult) <b>compare:</b> (NSString*)aString <b>options:</b> (unsigned int)mask <b>range:</b> (NSRange)aRange;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-20">completePathIntoString:caseSensitive:matchesIntoArray:</a></h3>
|
|
- (unsigned int) <b>completePathIntoString:</b> (NSString**)outputName <b>caseSensitive:</b> (BOOL)flag <b>matchesIntoArray:</b> (NSArray**)outputArray;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-21">componentsSeparatedByString:</a></h3>
|
|
- (NSArray*) <b>componentsSeparatedByString:</b> (NSString*)separator;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-22">cString</a></h3>
|
|
- (const char*) <b>cString</b>;<br>
|
|
|
|
Returns a pointer to a nul terminated string of 8-bit
|
|
characters in the default encoding. The memory pointed
|
|
to is not owned by the caller, so the caller must copy
|
|
its contents to keep it.
|
|
|
|
<hr>
|
|
<h3><a name ="method-23">cStringLength</a></h3>
|
|
- (unsigned int) <b>cStringLength</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-24">dataUsingEncoding:</a></h3>
|
|
- (NSData*) <b>dataUsingEncoding:</b> (NSStringEncoding)encoding;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-25">dataUsingEncoding:allowLossyConversion:</a></h3>
|
|
- (NSData*) <b>dataUsingEncoding:</b> (NSStringEncoding)encoding <b>allowLossyConversion:</b> (BOOL)flag;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-26">description</a></h3>
|
|
- (NSString*) <b>description</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-27">doubleValue</a></h3>
|
|
- (double) <b>doubleValue</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-28">fastestEncoding</a></h3>
|
|
- (NSStringEncoding) <b>fastestEncoding</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-29">fileSystemRepresentation</a></h3>
|
|
- (const char*) <b>fileSystemRepresentation</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-30">floatValue</a></h3>
|
|
- (float) <b>floatValue</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-31">getCharacters:</a></h3>
|
|
- (void) <b>getCharacters:</b> (unichar*)buffer;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-32">getCharacters:</a></h3>
|
|
- (void) <b>getCharacters:</b> (unichar*)buffer;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-33">getCString:</a></h3>
|
|
- (void) <b>getCString:</b> (char*)buffer;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-34">getCString:maxLength:</a></h3>
|
|
- (void) <b>getCString:</b> (char*)buffer <b>maxLength:</b> (unsigned int)maxLength;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-35">getCString:maxLength:range:remainingRange:</a></h3>
|
|
- (void) <b>getCString:</b> (char*)buffer <b>maxLength:</b> (unsigned int)maxLength <b>range:</b> (NSRange)aRange <b>remainingRange:</b> (NSRange*)leftoverRange;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-36">getFileSystemRepresentation:maxLength:</a></h3>
|
|
- (BOOL) <b>getFileSystemRepresentation:</b> (char*)buffer <b>maxLength:</b> (unsigned int)maxLength;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-38">hash</a></h3>
|
|
- (unsigned int) <b>hash</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-39">hasPrefix:</a></h3>
|
|
- (BOOL) <b>hasPrefix:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-40">hasSuffix:</a></h3>
|
|
- (BOOL) <b>hasSuffix:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-41">init</a></h3>
|
|
- (id) <b>init</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-42">initWithCharacters:</a></h3>
|
|
- (id) <b>initWithCharacters:</b> (const unichar*)characters;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-43">initWithCharactersNoCopy:length:freeWhenDone:</a></h3>
|
|
<b>This is the designated initialiser </b><br>
|
|
- (id) <b>initWithCharactersNoCopy:</b> (unichar*)characters <b>length:</b> (unsigned int)length <b>freeWhenDone:</b> (BOOL)flag;<br>
|
|
|
|
This is the most basic initialiser for unicode strings.
|
|
In the GNUstep implementation, your subclasses may override
|
|
this initialiser in order to have all others function.
|
|
|
|
<hr>
|
|
<h3><a name ="method-44">initWithContentsOfFile:</a></h3>
|
|
- (id) <b>initWithContentsOfFile:</b> (NSString*)path;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-45">initWithCString:</a></h3>
|
|
- (id) <b>initWithCString:</b> (const char*)cString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-46">initWithCString:</a></h3>
|
|
- (id) <b>initWithCString:</b> (const char*)cString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-47">initWithCStringNoCopy:length:freeWhenDone:</a></h3>
|
|
- (id) <b>initWithCStringNoCopy:</b> (char*)cString <b>length:</b> (unsigned int)length <b>freeWhenDone:</b> (BOOL)flag;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-48">initWithData:encoding:</a></h3>
|
|
- (id) <b>initWithData:</b> (NSData*)data <b>encoding:</b> (NSStringEncoding)encoding;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-49">initWithFormat:</a></h3>
|
|
- (id) <b>initWithFormat:</b> (NSString*)format, ...;<br>
|
|
|
|
Invokes initWithFormat:locale:arguments with a nil locale.
|
|
|
|
<hr>
|
|
<h3><a name ="method-50">initWithFormat:arguments:</a></h3>
|
|
- (id) <b>initWithFormat:</b> (NSString*)format <b>arguments:</b> (va_list)argList;<br>
|
|
|
|
Invokes initWithFormat:locale:arguments with a nil locale.
|
|
|
|
<hr>
|
|
<h3><a name ="method-51">initWithFormat:locale:</a></h3>
|
|
- (id) <b>initWithFormat:</b> (NSString*)format <b>locale:</b> (NSDictionary*)dictionary, ...;<br>
|
|
|
|
Initialises the string using the specified format and local
|
|
to format the following arguments.
|
|
|
|
<hr>
|
|
<h3><a name ="method-52">initWithFormat:arguments:</a></h3>
|
|
- (id) <b>initWithFormat:</b> (NSString*)format <b>arguments:</b> (va_list)argList;<br>
|
|
|
|
Invokes initWithFormat:locale:,... with a nil locale.
|
|
|
|
<hr>
|
|
<h3><a name ="method-53">initWithFormat:locale:arguments:</a></h3>
|
|
- (id) <b>initWithFormat:</b> (NSString*)format <b>locale:</b> (NSDictionary*)dictionary <b>arguments:</b> (va_list)argList;<br>
|
|
|
|
Initialises the string using the specified format and local
|
|
to format the following arguments.
|
|
|
|
<hr>
|
|
<h3><a name ="method-54">initWithString:</a></h3>
|
|
- (id) <b>initWithString:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-55">intValue</a></h3>
|
|
- (int) <b>intValue</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-56">isAbsolutePath</a></h3>
|
|
- (BOOL) <b>isAbsolutePath</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-57">isEqualToString:</a></h3>
|
|
- (BOOL) <b>isEqualToString:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-58">lastPathComponent</a></h3>
|
|
- (NSString*) <b>lastPathComponent</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-59">length</a></h3>
|
|
- (unsigned int) <b>length</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-61">lossyCString</a></h3>
|
|
- (const char*) <b>lossyCString</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-62">lowercaseString</a></h3>
|
|
- (NSString*) <b>lowercaseString</b>;<br>
|
|
|
|
Returns a copy of the receiver with all characters converted
|
|
to lowercase.
|
|
|
|
<hr>
|
|
<h3><a name ="method-63">pathComponents</a></h3>
|
|
- (NSArray*) <b>pathComponents</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-64">pathExtension</a></h3>
|
|
- (NSString*) <b>pathExtension</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-65">propertyList</a></h3>
|
|
- (id) <b>propertyList</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-66">propertyListFromStringsFileFormat</a></h3>
|
|
- (NSDictionary*) <b>propertyListFromStringsFileFormat</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-67">rangeOfCharacterFromSet:</a></h3>
|
|
- (NSRange) <b>rangeOfCharacterFromSet:</b> (NSCharacterSet*)aSet;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-68">rangeOfCharacterFromSet:options:</a></h3>
|
|
- (NSRange) <b>rangeOfCharacterFromSet:</b> (NSCharacterSet*)aSet <b>options:</b> (unsigned int)mask;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-69">rangeOfCharacterFromSet:options:range:</a></h3>
|
|
- (NSRange) <b>rangeOfCharacterFromSet:</b> (NSCharacterSet*)aSet <b>options:</b> (unsigned int)mask <b>range:</b> (NSRange)aRange;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-70">rangeOfComposedCharacterSequenceAtIndex:</a></h3>
|
|
- (NSRange) <b>rangeOfComposedCharacterSequenceAtIndex:</b> (unsigned int)anIndex;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-71">rangeOfString:</a></h3>
|
|
- (NSRange) <b>rangeOfString:</b> (NSString*)aString;<br>
|
|
|
|
Invokes <em>rangeOfString:options:</em> with the options mask
|
|
set to zero.
|
|
|
|
<hr>
|
|
<h3><a name ="method-72">rangeOfString:options:</a></h3>
|
|
- (NSRange) <b>rangeOfString:</b> (NSString*)aString <b>options:</b> (unsigned int)mask;<br>
|
|
|
|
Invokes <em>rangeOfString:options:range</em> with the range set
|
|
set to the range of the whole of the reciever.
|
|
|
|
<hr>
|
|
<h3><a name ="method-73">rangeOfString:options:range:</a></h3>
|
|
- (NSRange) <b>rangeOfString:</b> (NSString*)subString <b>options:</b> (unsigned int)mask <b>range:</b> (NSRange)aRange;<br>
|
|
|
|
Returns the range giving the location and length of the first
|
|
occurrence of <em>subString</em> within <em>aRange</em>.
|
|
<br>
|
|
If <em>subString</em> does not exist in the receiver (an empty
|
|
string is <em>never</em> considered to exist in the receiver),
|
|
the length of the returned range is zero.
|
|
<br>
|
|
If <em>substring</em> is nil, an exception is raised.
|
|
<br>
|
|
If any part of <em>aRange</em> lies outside the range of the
|
|
receiver, an exception is raised.
|
|
<br>
|
|
The optionsm mask may contain the following options -
|
|
<ul>
|
|
<li >NSCaseInsensitiveSearch
|
|
<li >NSLiteralSearch
|
|
<li >NSBackwardsSearch
|
|
<li >NSAnchoredSearch
|
|
</ul>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-74">smallestEncoding</a></h3>
|
|
- (NSStringEncoding) <b>smallestEncoding</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-75">stringByAbbreviatingWithTildeInPath</a></h3>
|
|
- (NSString*) <b>stringByAbbreviatingWithTildeInPath</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-76">stringByAppendingFormat:</a></h3>
|
|
- (NSString*) <b>stringByAppendingFormat:</b> (NSString*)format,;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-77">stringByAppendingPathComponent:</a></h3>
|
|
- (NSString*) <b>stringByAppendingPathComponent:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-78">stringByAppendingPathExtension:</a></h3>
|
|
- (NSString*) <b>stringByAppendingPathExtension:</b> (NSString*)string;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-79">stringByAppendingString:</a></h3>
|
|
- (NSString*) <b>stringByAppendingString:</b> (NSString*)aString;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-80">stringByDeletingLastPathComponent</a></h3>
|
|
- (NSString*) <b>stringByDeletingLastPathComponent</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-81">stringByDeletingPathExtension</a></h3>
|
|
- (NSString*) <b>stringByDeletingPathExtension</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-82">stringByExpandingTildeInPath</a></h3>
|
|
- (NSString*) <b>stringByExpandingTildeInPath</b>;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-83">stringByReplacingString:withString:</a></h3>
|
|
- (NSString*) <b>stringByReplacingString:</b> (NSString*)aString <b>withString:</b> (NSString*)replacement;<br>
|
|
Standards: GNUstep NotMacOS-X NotOpenStep<br>
|
|
|
|
Returns a string in which any (and all) occurrances of
|
|
<em>aString</em> in the receiver have been replaced by
|
|
<em>replacement</em>. Returns the receiver if <em>aString</em>
|
|
does not occur within the receiver. NB. an empty string is
|
|
not considered to exist within the receiver.
|
|
|
|
<hr>
|
|
<h3><a name ="method-84">stringsByAppendingPaths:</a></h3>
|
|
- (NSArray*) <b>stringsByAppendingPaths:</b> (NSArray*)paths;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-85">substringFromIndex:</a></h3>
|
|
- (NSString*) <b>substringFromIndex:</b> (unsigned int)anIndex;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-86">substringToIndex:</a></h3>
|
|
- (NSString*) <b>substringToIndex:</b> (unsigned int)anIndex;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-87">substringWithRange:</a></h3>
|
|
- (NSString*) <b>substringWithRange:</b> (NSRange)aRange;<br>
|
|
|
|
|
|
<hr>
|
|
<h3><a name ="method-88">uppercaseString</a></h3>
|
|
- (NSString*) <b>uppercaseString</b>;<br>
|
|
|
|
Returns a copy of the receiver with all characters converted
|
|
to uppercase.
|
|
|
|
<hr>
|
|
<h3><a name ="method-89">writeToFile:atomically:</a></h3>
|
|
- (BOOL) <b>writeToFile:</b> (NSString*)path <b>atomically:</b> (BOOL)flag;<br>
|
|
|
|
|
|
<hr>
|
|
</body>
|
|
|
|
</html>
|