NSString(SCString) Category Reference

Additional functionality for class NSString. More...

#import <SCString.h>

List of all members.

Public Member Functions
Comparing Strings
(BOOL)	- isEqualToStrings:
Dividing and Replacing Strings and Parts of Strings
(NSString *)	- leftPartOfString:
(NSString *)	- rightPartOfString:
(NSString *)	- skipLeftPart:
(NSString *)	- skipRightPart:
(NSString *)	- stringWithInsertedString:
(NSString *)	- stringWithInsertedString:index:
(NSString *)	- ltrim
(NSString *)	- rtrim
(NSString *)	- trim
(NSString *)	- normalizedString
(SCUInteger)	- wordsCount
(NSString *)	- word:
(NSString *)	- firstWord
(NSString *)	- endOfString
(NSString *)	- stringWithReplacedSubstringToIndex:string:
(NSString *)	- stringWithReplacedSubstringFromIndex:string:
(NSString *)	- stringWithReplacedSubstringWithRange:string:
(NSString *)	- stringWithReplacedSubstring:string:caseInsensitive:
(NSString *)	- stringWithReplacedSubstring:string:
(NSString *)	- stringWithDeletedSubstringToIndex:
(NSString *)	- stringWithDeletedSubstringFromIndex:
(NSString *)	- stringWithDeletedSubstringWithRange:
(NSString *)	- stringWithDeletedSubstring:caseInsensitive:
(NSString *)	- stringWithDeletedSubstring:
(NSString *)	- stringWithDeletedSubstringToRange:
(SCInteger)	- substringCount:caseInsensitive:
(SCInteger)	- substringCount:
(BOOL)	- substringExists:caseInsensitive:
(BOOL)	- substringExists:
(BOOL)	- rangeIsCorrect:
(SCUInteger)	- indexOfSubstring:caseInsensitive:
(SCUInteger)	- indexOfSubstring:
(SCArray *)	- indexesOfSubstring:caseInsensitive:
(SCArray *)	- indexesOfSubstring:
Other Methods
(BOOL)	- isEmpty
(NSString *)	- upperFirstLetter
(NSString *)	- className
Supporting Data Dictionaries
(void)	- writeToDataDictionary:
(void)	- writeToDataDictionaryFile:atomically:
(void)	- writeToDataDictionaryFile:
(NSDictionary *)	- dataDictionary
Supporting Coders and Serialized Files
(BOOL)	- writeContentsToSerializedFile:
Supporting Streams
(void)	- writeToStream:
(void)	- writeToFileStream:
(void)	- appendToFileStream:
Supporting Collections
(id< SCCollectionProtocol >)	- copyObject
(SCComparisonResult)	- compareWithObject:
Creating and Initializing Strings
(NSString *)	+ stringWithLength:character:
(NSString *)	+ stringWithLength:
(NSString *)	+ stringWithUnichar:
(NSString *)	+ stringWithPointer:
(NSString *)	+ stringWithID:
(NSString *)	+ stringWithDataDictionary:
(NSString *)	+ stringWithDataDictionaryFromFile:
(NSString *)	+ stringWithCoder:
(NSString *)	+ stringWithContentsOfSerializedFile:
(NSString *)	+ stringWithStream:
(NSString *)	+ stringWithFileStream:
(id)	- initWithLength:character:
(id)	- initWithLength:
(id)	- initWithUnichar:
(id)	- initWithPointer:
(id)	- initWithID:
(id)	- initWithDataDictionary:
(id)	- initWithDataDictionaryFromFile:
(id)	- initWithContentsOfSerializedFile:
(id)	- initWithStream:
(id)	- initWithFileStream:
Expanding Strings
(NSString *)	+ stringExpandedLeft:length:character:
(NSString *)	+ stringExpandedLeft:length:
(NSString *)	+ stringExpandedDigital:length:
(NSString *)	+ stringExpandedRight:length:character:
(NSString *)	+ stringExpandedRight:length:
(NSString *)	- expandLeftStringToLength:character:
(NSString *)	- expandLeftStringToLength:
(NSString *)	- expandDigitalStringToLength:
(NSString *)	- expandRightStringToLength:character:
(NSString *)	- expandRightStringToLength:
(id)	- initExpandedLeft:length:character:
(id)	- initExpandedLeft:length:
(id)	- initExpandedDigital:length:
(id)	- initExpandedRight:length:character:
(id)	- initExpandedRight:length:
Reversing Strings
(NSString *)	+ stringWithReversedString:
(NSString *)	- reverse
(id)	- initWithReversedString:
Grouping Parts in Strings
(NSString *)	+ stringWithString:groups:delimiter:
(NSString *)	+ stringWithString:groupsDelimiter:
(NSString *)	+ stringWithString:groups:
(NSString *)	+ stringWithStringGroups:
(NSString *)	- stringWithGroups:delimiter:
(NSString *)	- stringWithGroupsDelimiter:
(NSString *)	- stringWithGroups:
(NSString *)	- stringWithGroups
(id)	- initWithString:groups:delimiter:
(id)	- initWithString:groupsDelimiter:
(id)	- initWithString:groups:
(id)	- initWithStringGroups:
Dividing Strings by Using Separators
(NSString *)	+ stringWithString:separators:leftOver:
(NSString *)	+ stringWithString:spacesFromLeftOver:
(NSString *)	+ stringWithString:separators:rightOver:
(NSString *)	+ stringWithString:spacesFromRightOver:
(NSString *)	- insertSeparators:leftOver:
(NSString *)	- insertSpacesFromLeftOver:
(NSString *)	- insertSeparators:rightOver:
(NSString *)	- insertSpacesFromRightOver:
(NSString *)	- initWithString:separators:leftOver:
(NSString *)	- initWithString:spacesFromLeftOver:
(NSString *)	- initWithString:separators:rightOver:
(NSString *)	- initWithString:spacesFromRightOver:
Getting Text Representation of Integer Values
(BOOL)	+ characterIsInteger:base:
(SCInteger)	+ characterToInteger:
(NSString *)	+ stringWithInteger:base:capacity:uppercase:separators:
(NSString *)	+ stringWithInteger:base:capacity:uppercase:
(NSString *)	+ stringWithInteger:base:uppercase:separators:
(NSString *)	+ stringWithInteger:base:uppercase:
(NSString *)	+ stringWithInteger:base:capacity:separators:
(NSString *)	+ stringWithInteger:base:capacity:
(NSString *)	+ stringWithInteger:base:separators:
(NSString *)	+ stringWithInteger:base:
(BOOL)	- isIntegerStringWithBase:
(SCULong)	- integerWithBase:
(NSString *)	- initWithInteger:base:capacity:uppercase:separators:
(NSString *)	- initWithInteger:base:capacity:uppercase:
(NSString *)	- initWithInteger:base:uppercase:separators:
(NSString *)	- initWithInteger:base:uppercase:
(NSString *)	- initWithInteger:base:capacity:separators:
(NSString *)	- initWithInteger:base:capacity:
(NSString *)	- initWithInteger:base:separators:
(NSString *)	- initWithInteger:base:
Getting Text Representation of Binary Integer Values
(BOOL)	+ characterIsBinaryInteger:
(NSString *)	+ stringWithBinaryInteger:capacity:separators:
(NSString *)	+ stringWithBinaryInteger:capacity:
(NSString *)	+ stringWithBinaryInteger:separators:
(NSString *)	+ stringWithBinaryInteger:
(BOOL)	- isBinaryString
(SCULong)	- binaryInteger
(NSString *)	- initWithBinaryInteger:capacity:separators:
(NSString *)	- initWithBinaryInteger:capacity:
(NSString *)	- initWithBinaryInteger:separators:
(NSString *)	- initWithBinaryInteger:
Getting Text Representation of Octal Integer Values
(BOOL)	+ characterIsOctalInteger:
(NSString *)	+ stringWithOctalInteger:separators:
(NSString *)	+ stringWithOctalInteger:
(BOOL)	- isOctalString
(SCULong)	- octalInteger
(NSString *)	- initWithOctalInteger:separators:
(NSString *)	- initWithOctalInteger:
Getting Text Representation of Decimal Integer Values
(BOOL)	+ characterIsDecimalInteger:
(BOOL)	+ characterIsInteger:
(NSString *)	+ stringWithDecimalInteger:separators:
(NSString *)	+ stringWithDecimalInteger:
(NSString *)	+ stringWithDecimalInteger:separator:
(NSString *)	+ stringWithSignedInteger:
(NSString *)	+ stringWithSignedShort:
(NSString *)	+ stringWithUnsignedShort:
(NSString *)	+ stringWithSignedLong:
(BOOL)	- isDecimalString
(BOOL)	- isIntegerString
(SCULong)	- decimalInteger
(SCULong)	- integer
(NSString *)	- initWithDecimalInteger:separators:
(NSString *)	- initWithDecimalInteger:
(NSString *)	- initWithDecimalInteger:separator:
(id)	- initWithSignedInteger:
(id)	- initWithSignedShort:
(id)	- initWithUnsignedShort:
(id)	- initWithSignedLong:
Getting Text Representation of Hexadecimal Integer Values
(BOOL)	+ characterIsHexadecimalInteger:
(NSString *)	+ stringWithHexadecimalInteger:capacity:uppercase:separators:
(NSString *)	+ stringWithHexadecimalInteger:capacity:uppercase:
(NSString *)	+ stringWithHexadecimalInteger:capacity:separators:
(NSString *)	+ stringWithHexadecimalInteger:capacity:
(NSString *)	+ stringWithHexadecimalInteger:uppercase:separators:
(NSString *)	+ stringWithHexadecimalInteger:uppercase:
(NSString *)	+ stringWithHexadecimalInteger:separators:
(NSString *)	+ stringWithHexadecimalInteger:
(BOOL)	- isHexadecimalString
(SCULong)	- hexadecimalInteger
(NSString *)	- initWithHexadecimalInteger:capacity:uppercase:separators:
(NSString *)	- initWithHexadecimalInteger:capacity:uppercase:
(NSString *)	- initWithHexadecimalInteger:capacity:separators:
(NSString *)	- initWithHexadecimalInteger:capacity:
(NSString *)	- initWithHexadecimalInteger:uppercase:separators:
(NSString *)	- initWithHexadecimalInteger:uppercase:
(NSString *)	- initWithHexadecimalInteger:separators:
(NSString *)	- initWithHexadecimalInteger:
Getting Text Representation of Float Values
(NSString *)	+ stringWithDouble:
(id)	- initWithDouble:
Getting a Text Representation of a Boolean Values
(NSString *)	+ stringWithBoolean:
(id)	- initWithBoolean:
(BOOL)	- boolean

---

Detailed Description

Additional functionality for class NSString.

Category SCString extends functionality of standard class NSString.
This category was introduced in version 1.0.0.

Category declared the following properties:

• NSString* className - receiver's instance class name (read only)

---

Member Function Documentation

- (void) appendToFileStream:

(NSString *)

path

Appends the receiver's string to the new or existing stream file with the specified path.

Parameters:

path	- stream file path

Exceptions:

SCStreamException

- stream operation error detected

- (SCULong) binaryInteger

Converts the receiver's string into the integer value as a binary text representation.

Returns:

Integer value

- (BOOL) boolean

Returns boolean value of receiver's text representation of boolean value.

Returns:

YES if receiver's string containts "YES", "ON" or "TRUE", otherwise NO

+ (BOOL) characterIsBinaryInteger:

(unichar)

chr

Checks whether the specified character is a binary digit.

Parameters:

chr	- source character

Returns:

YES if the specified character is a binary digit, otherwise NO

+ (BOOL) characterIsDecimalInteger:

(unichar)

chr

Checks whether the specified character is a decimal digit.

Parameters:

chr	- source character

Returns:

YES if the character is a decimal digit, otherwise NO

+ (BOOL) characterIsHexadecimalInteger:

(unichar)

chr

Checks whether the specified character is a hexadecimal digit.

Parameters:

chr	- checked character

Returns:

YES if the character is a hexadecimal digit, otherwise NO

+ (BOOL) characterIsInteger:

(unichar)

chr

Checks whether the specified character is a decimal digit.

Parameters:

chr	- source character

Returns:

YES if the character is a decimal digit, otherwise NO

+ (BOOL) characterIsInteger:		(unichar)	chr
base:		(SCIntegerBase)	base

Checks whether character is digit with the specified base.

Parameters:

chr	- checked character
base	- integer base

Returns:

YES if the character is digit with the specified base, otherwise NO

+ (BOOL) characterIsOctalInteger:

(unichar)

chr

Checks whether the specified character is an octal digit.

Parameters:

chr	- source character

Returns:

YES if the character is an octal digit, otherwise NO

+ (SCInteger) characterToInteger:

(unichar)

chr

Converts the character into integer value.

Parameters:

chr	- source character

Returns:

Integer value or -1 if character is not digit

- (NSString *) className

Returns a receiver's string class name.

Returns:

Class name

- (SCComparisonResult) compareWithObject:

(id<SCCollectionProtocol>)

object

Returns the result of comparison receiver's instance with the specified instance.

Parameters:

object

- second instance for comparison

Returns:

Result of comparison:

• SCComparisonEqual - instances are equal
• SCComparisonLess - the receiver's instance is less than second instance
• SCComparisonGreater - the receiver's instance is greater than second instance
• SCComparisonNotAllowed - instances cannot be compared

Exceptions:

SCCollectionException

- incompatible second instance detected

- (id< SCCollectionProtocol >) copyObject

Returns the copy of receiver's instance.

Returns:

Copy of receiver's instance

- (NSDictionary *) dataDictionary

Returns the dictionary with the receiver's string.

Returns:

Dictionary with the receiver's string

- (SCULong) decimalInteger

Returns an integer value of the receiver's text representation of the decimal integer value.

Returns:

Integer value

- (NSString *) endOfString

Returns a receiver's string without first word.

Returns:

String without first word

- (NSString *) expandDigitalStringToLength:

(SCUInteger)

length

Returns a string padded on the left of the zero characters to the specified length.

Parameters:

length

- required string length

Returns:

Padded string

- (NSString *) expandLeftStringToLength:

(SCUInteger)

length

Returns a string padded on the left of the spaced to the specified length.

Parameters:

length

- required string length

Returns:

Padded string

- (NSString *) expandLeftStringToLength:		(SCUInteger)	length
character:		(unichar)	chr

Returns a string padded on the left of the specified character to the specified length.

Parameters:

length	- required string length
chr	- padding character

Returns:

Padded string

- (NSString *) expandRightStringToLength:

(SCUInteger)

length

Returns a string padded on the right of the spaced to the specified length.

Parameters:

length

- required string length

Returns:

Padding string

- (NSString *) expandRightStringToLength:		(SCUInteger)	length
character:		(unichar)	chr

Returns a string padded on the right of the specified characters to the specified length.

Parameters:

length	- required string length
chr	- padding character

Returns:

Padding string

- (NSString *) firstWord

Returns a first word of the receiver's string.

Returns:

First word

- (SCULong) hexadecimalInteger

Returns an integer value of hexadecimal text representation of receiver's value.

Returns:

Integer value

- (SCArray *) indexesOfSubstring:

(NSString *)

substring

Returns an array with the indexes of all occurrences of the specified substring.

Parameters:

substring

- desired substring

Returns:

Indexes array

See also:

- indexesOfSubstring:caseInsensitive:

- (SCArray *) indexesOfSubstring:		(NSString *)	substring
caseInsensitive:		(BOOL)	value

Returns an array with the indexes of all occurrences of the specified substring. Case insensitively depends on the value of the specified flag

Parameters:

substring	- desired substring
value	- YES for case insensitive comparison operations, otherwise NO

Returns:

Indexes array

See also:

- indexesOfSubstring:

- (SCUInteger) indexOfSubstring:

(NSString *)

substring

Returns the index of the first occurrence of the specified substring.

Parameters:

substring

- desired substring

Returns:

Index of the first substring occurrence or SCNotFound is the required substring not found

See also:

- indexOfSubstring:caseInsensitive:

- (SCUInteger) indexOfSubstring:		(NSString *)	substring
caseInsensitive:		(BOOL)	value

Returns the index of the first occurrence of the specified substring. Case insensitively depends on the value of the specified flag

Parameters:

substring	- desired substring
value	- YES for case insensitive comparison operations, otherwise NO

Returns:

Index of the first substring occurrence or SCNotFound is the required substring not found

See also:

- indexOfSubstring:

- (id) initExpandedDigital:		(NSString *)	str
length:		(SCUInteger)	length

Initializes the string padded on the left of the zero characters to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A newly initialized string

- (id) initExpandedLeft:		(NSString *)	str
length:		(SCUInteger)	length

Initializes the string padded on the left of the spaces to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A newly initialized string

- (id) initExpandedLeft:		(NSString *)	str
length:		(SCUInteger)	length
character:		(unichar)	chr

Initializes the string padded on the left of the specified characters to the specified length.

Parameters:

str	- source string
length	- required string length
chr	- padding character

Returns:

A newly initialized string

- (id) initExpandedRight:		(NSString *)	str
length:		(SCUInteger)	length

Initializes the string padded on the right of the spaces to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A newly initialized string

- (id) initExpandedRight:		(NSString *)	str
length:		(SCUInteger)	length
character:		(unichar)	chr

Initializes the string padded on the right of the specified characters to the specified length.

Parameters:

str	- source string
length	- required string length
chr	- padding character

Returns:

A newly initialized string

- (NSString *) initWithBinaryInteger:

(SCULong)

integer

Initializes a string as a text representation of the binary integer value without digits separators.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (NSString *) initWithBinaryInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity

Initializes a string as a text representation of the binary integer value with the specified capacity and without digits separators.

Parameters:

integer	- source integer value
capacity	- integer capacity

Returns:

A newly initialized string

- (NSString *) initWithBinaryInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Initializes a string as a text representation of the binary integer value with the specified capacity and flag of adding the digits separators.

Parameters:

integer	- source integer value
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initialized string

- (NSString *) initWithBinaryInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Initializes a string as a text representation of the binary integer value with the specified flag of using the digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initialized string

- (id) initWithBoolean:

(BOOL)

value

Initializes the string as a text representation of the boolean value.

Parameters:

value

- source boolean value

Returns:

A newly initialized string

- (id) initWithContentsOfSerializedFile:

(NSString *)

path

Initializes the string using the contens of serialized file with the specified path.

Parameters:

path	- source serialized file path

Returns:

A newly initialized string

- (id) initWithDataDictionary:

(NSDictionary *)

dictionary

Initializes the string using the specified dictionary.

Parameters:

dictionary

- source dictionary

Returns:

A newly initialized string

- (id) initWithDataDictionaryFromFile:

(NSString *)

path

Initializes the string using the dictionary from the specified file.

Parameters:

path	- source dictionary file path

Returns:

A newly initialized string

- (NSString *) initWithDecimalInteger:

(SCULong)

integer

Initializes a string as the text representation of the decimal integer value without the flag of the digits separators.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (NSString *) initWithDecimalInteger:		(SCULong)	integer
separator:		(NSString *)	separator

Initializes a string as the text representation of the decimal integer value with the specified digits separator.

Parameters:

integer	- source integer value
separator	- digits separator

Returns:

A newly initialized string

- (NSString *) initWithDecimalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Initializes a string as the text representation of the decimal integer value with the flag of using the digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initialized string

- (id) initWithDouble:

(SCDouble)

dbl

Initializes a string as a text representation of the double float value.

Parameters:

dbl	- source double value

Returns:

A newly initialized string

- (id) initWithFileStream:

(NSString *)

path

Initializes the string from the stream file with the specified path.

Parameters:

path	- stream file path

Returns:

A newly initialized string

Exceptions:

SCStreamException

- stream operation error detected

- (NSString *) initWithHexadecimalInteger:

(SCULong)

integer

Initializes the string as a text representation of the hexadecimal integer value without digits separators.

Parameters:

integer

- source integer

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity

Initializes the string as a text representation of the hexadecimal integer value with the specified capacity and without a digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Initializes the string as a text representation of the hexadecimal integer value with the specified capacity and flag of using the digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	up

Initializes the string as a text representation of the hexadecimal integer value with the specified capacity, digits case and without digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
up	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	up
separators:		(BOOL)	separators

Initializes the string as a text representation of the hexadecimal integer value with the specified capacity, digits case flag and flag of using the digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
up	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Initializes the string as a text representation of the hexadecimal integer value with the specified flag of using the digits separators.

Parameters:

integer	- source integer
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
uppercase:		(BOOL)	up

Initializes the string as a text representation of the hexadecimal integer value with the specified digits case and without using the digits separators.

Parameters:

integer	- source integer
up	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

A newly initializes string

- (NSString *) initWithHexadecimalInteger:		(SCULong)	integer
uppercase:		(BOOL)	up
separators:		(BOOL)	separators

Initializes the string as a text representation of the hexadecimal integer value with the specified digits case and flag of using the digits separators.

Parameters:

integer	- source integer
up	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (id) initWithID:

(id)

object

Initializes the string using the specified class instance description.

Parameters:

object

- source class instance

Returns:

A newly initialized string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base

Initializes a string as a text representation of integer value with the specified base without using the digits separators.

Parameters:

integer	- source integer
base	- integer base

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity

Initializes a string as a text representation of integer value with the specified base, capacity and without the digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Initializes a string as a text representation of integer value with the specified base, capacity and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	uppercase

Initializes a string as a text representaion of integer value with using the specified base, capacity, digits case and without digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	uppercase
separators:		(BOOL)	separators

Initializes a string as a text representation of integer value with using the specified base, capacity, digits case and flag of using the digits separator.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
separators:		(BOOL)	separators

Initializes a string as a text representation of integer value with the specified base and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
uppercase:		(BOOL)	uppercase

Initializes a string as a text representation of integer value with the specified base, digits case and without using the digits separators.

Parameters:

integer	- source integer
base	- integer base
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

A newly initializes string

- (NSString *) initWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
uppercase:		(BOOL)	uppercase
separators:		(BOOL)	separators

Initializes a string as a text representation of integer value with the specified base, digits case and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initializes string

- (id) initWithLength:

(SCUInteger)

length

Initializes the string using the specified number of space characters.

Parameters:

length

- required string length

Returns:

A newly initialized string

- (id) initWithLength:		(SCUInteger)	length
character:		(unichar)	chr

Initializes the string using the specified number of characters and character to fill the string.

Parameters:

length	- required string length
chr	- character to fill the string

Returns:

A newly initialized string

- (NSString *) initWithOctalInteger:

(SCULong)

integer

Initializes a string as a text representation of the octal integer value without digits separators.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (NSString *) initWithOctalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Initializes a string as a text representation of the octal integer value and flag of using digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

A newly initialized string

- (id) initWithPointer:

(void *)

pointer

Initializes the string as a text representation of the specified pointer.

Parameters:

pointer

- source pointer

Returns:

A newly initialized string

- (id) initWithReversedString:

(NSString *)

str

Initializes the string by reversing the specified source string.

Parameters:

str	- source string

Returns:

A newly initialized string

- (id) initWithSignedInteger:

(SCInteger)

integer

Initializes a string as the text representation of the decimal signed integer value.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (id) initWithSignedLong:

(SCLong)

longint

Initializes a string as the text representation of the decimal signed 64-bit integer value.

Parameters:

longint

- source integer value

Returns:

A newly initialized string

- (id) initWithSignedShort:

(short)

integer

Initializes a string as the text representation of the decimal signed short integer value.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (id) initWithStream:

(SCStream *)

stream

Initializes the string from the specified stream.

Parameters:

stream

- stream for reading string

Returns:

A newly initialized string

Exceptions:

SCStreamException	- stream operation error detected
SCSystemException	- system error detected

- (id) initWithString:		(NSString *)	str
groups:		(SCUInteger)	group

Initializes the string by deviding the source string into groups of the specified character number the with space delimiter character.

Parameters:

str	- source string
group	- number of characters in each group

Returns:

A newly initialized string

- (id) initWithString:		(NSString *)	str
groups:		(SCUInteger)	group
delimiter:		(unichar)	chr

Initializes the string by deviding the source string into groups of the specified character number with the specified delimiter character.

Parameters:

str	- source string
group	- number of characters in each group
chr	- delimiter character

Returns:

A newly initialized string

- (id) initWithString:		(NSString *)	str
groupsDelimiter:		(unichar)	chr

Initializes the string by deviding the source string into groups of the three characters with the specified delimiter character.

Parameters:

str	- source string
chr	- delimiter character

Returns:

A newly initialized string

- (NSString *) initWithString:		(NSString *)	source
separators:		(NSString *)	separator
leftOver:		(SCUInteger)	over

Initializes a string by adding into the source string the specified separators after the specified number of characters from left to right.

Parameters:

source	- source string
separator	- added separator
over	- number of characters in each group

Returns:

A newly initialized string

- (NSString *) initWithString:		(NSString *)	source
separators:		(NSString *)	separator
rightOver:		(SCUInteger)	over

Initializes a string by adding into the source string the specified separators after the specified number of characters from right to left.

Parameters:

source	- source string
separator	- added separator
over	- number of characters in each group

Returns:

A newly initialized string

- (NSString *) initWithString:		(NSString *)	source
spacesFromLeftOver:		(SCUInteger)	over

Initializes a string by adding into the source string the space separators after the specified number of characters from left to right.

Parameters:

source	- source string
over	- number of characters in each group

Returns:

A newly initialized string

- (NSString *) initWithString:		(NSString *)	source
spacesFromRightOver:		(SCUInteger)	over

Initializes a string by adding into the source string the space separators after the specified number of characters from right to left.

Parameters:

source	- source string
over	- number of characters in each group

Returns:

A newly initialized string

- (id) initWithStringGroups:

(NSString *)

str

Initializes the string by deviding the source string into groups of the three characters with the space delimiter character.

Parameters:

str	- source string

Returns:

A newly initialized string

- (id) initWithUnichar:

(unichar)

chr

Initializes the string using the specified character.

Parameters:

chr	- source character

Returns:

A newly initialized string

- (id) initWithUnsignedShort:

(unsigned short)

integer

Initializes a string as the text representation of the decimal unsigned short integer value.

Parameters:

integer

- source integer value

Returns:

A newly initialized string

- (NSString *) insertSeparators:		(NSString *)	separator
leftOver:		(SCUInteger)	over

Returns a string with the added separators after the specified number of characters from left to right.

Parameters:

separator	- added separator
over	- number of characters in each group

Returns:

String with added separators

- (NSString *) insertSeparators:		(NSString *)	separator
rightOver:		(SCUInteger)	over

Returns a string with the added separators after the specified number of characters from right to left.

Parameters:

separator	- added separator
over	- number of characters in each group

Returns:

String with added separators

- (NSString *) insertSpacesFromLeftOver:

(SCUInteger)

over

Returns a string with the added spaces as separator after the specified number of characters from left to right.

Parameters:

over	- number of characters in each group

Returns:

String with added separators

- (NSString *) insertSpacesFromRightOver:

(SCUInteger)

over

Returns a string with the added spaces as separators after the specified number of characters from right to left.

Parameters:

over	- number of characters in each group

Returns:

String with added separators

- (SCULong) integer

Returns an integer value of the receiver's text representation of the decimal integer value.

Returns:

Integer value

- (SCULong) integerWithBase:

(SCIntegerBase)

base

Converts the receiver's string into integer value with the specified base.

Parameters:

base	- integer base

Returns:

Integer value

- (BOOL) isBinaryString

Checks whether the receiver's string is a binary text representation of integer value.

Returns:

YES if the receiver's string is a binary representation, otherwise NO

- (BOOL) isDecimalString

Checks whether the receiver's string is a text representation of the decimal integer value.

Returns:

YES if the string is a text representation, otherwise NO

- (BOOL) isEmpty

Checks for the receiver's string of at least one character other than space and tab.

Returns:

NO if the string contains at least one character other than space and tab, otherwise NO

- (BOOL) isEqualToStrings:		(NSString *)	string
,			...

Returns a boolean value that indicates whether the receiver is equal to any string from the specified nil terminated list.

Parameters:

string	- first string from list
...	- other strings

Returns:

YES if the receiver is equal to any string from list, otherwise NO

- (BOOL) isHexadecimalString

Checks whether the receiver's string is a text representation of hexadecimal integer value.

Returns:

YES if the string is a test representation, otherwise NO

- (BOOL) isIntegerString

Checks whether the receiver's string is a text representation of the decimal integer value.

Returns:

YES if the string is a text representation, otherwise NO

- (BOOL) isIntegerStringWithBase:

(SCIntegerBase)

base

Checks whether the receiver's string converted to integer value with the specified base.

Parameters:

base	- integer base (2, 8, 10 or 16)

Returns:

YES if the receiver's string is converted, otherwise NO

- (BOOL) isOctalString

Checks whether the receiver's string is a text representation of the octal integer value.

Returns:

YES if the string is a text representation, otherwise NO

- (NSString *) leftPartOfString:

(SCUInteger)

characters

Returns a string with the specified count of receiver's first characters.

Parameters:

characters

- required characters count

Returns:

String with the specified characters

- (NSString *) ltrim

Returns a string without a leading spaces and tabs.

Returns:

String without a leading spaces and tabs.

- (NSString *) normalizedString

Returns a normalized receiver's string.

Returns:

Normalized receiver's string

- (SCULong) octalInteger

Returns integer value of the receiver's octal text representation.

Returns:

Integer value

- (BOOL) rangeIsCorrect:

(NSRange)

range

Checks a characters range.

Parameters:

range

- verifiable range

Returns:

YES if range is correct, otherwise NO

- (NSString *) reverse

Returns a reversed string.

Returns:

Reversed string

- (NSString *) rightPartOfString:

(SCUInteger)

characters

Returns a string with the specified count of receiver's last characters.

Parameters:

characters

- required characters count

Returns:

String with the specified characters

- (NSString *) rtrim

Returns a string without a trailing spaces and tabs.

Returns:

String without a trailing spaces and tabs.

- (NSString *) skipLeftPart:

(SCUInteger)

characters

Returns a string without the specified count of receiver's first characters.

Parameters:

characters

- deleted characters count

Returns:

String without the specified characters

- (NSString *) skipRightPart:

(SCUInteger)

characters

Returns a string without the specified count of receiver's last characters.

Parameters:

characters

- deleted characters count

Returns:

String without the specified characters

+ (NSString *) stringExpandedDigital:		(NSString *)	str
length:		(SCUInteger)	length

Returns a string created by padding the specified string on the left of the zero characters to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A created string

+ (NSString *) stringExpandedLeft:		(NSString *)	str
length:		(SCUInteger)	length

Returns a string created by padding the specified string on the left of the spaces to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A created string

+ (NSString *) stringExpandedLeft:		(NSString *)	str
length:		(SCUInteger)	length
character:		(unichar)	chr

Returns a string created by padding the specified string on the left of the specified characters to the specified length.

Parameters:

str	- source string
length	- required string length
chr	- padding character

Returns:

A created string

+ (NSString *) stringExpandedRight:		(NSString *)	str
length:		(SCUInteger)	length

Returns a string created by padding the specified string on the right of the spaces to the specified length.

Parameters:

str	- source string
length	- required string length

Returns:

A created string

+ (NSString *) stringExpandedRight:		(NSString *)	str
length:		(SCUInteger)	length
character:		(unichar)	chr

Returns a string created by padding the specified string on the right of the specified characters to the specified length.

Parameters:

str	- source string
length	- required string length
chr	- padding character

Returns:

A created string

+ (NSString *) stringWithBinaryInteger:

(SCULong)

integer

Returns a string created as a text representation of the binary integer value without digits separators.

Parameters:

integer

- source integer value

Returns:

Created string

+ (NSString *) stringWithBinaryInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity

Returns a string created as a text representation of the binary integer value with the specified capacity and without digits separators.

Parameters:

integer	- source integer value
capacity	- integer capacity

Returns:

Created string

+ (NSString *) stringWithBinaryInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Returns a string created as a text representation of the binary integer value with the specified capacity and flag of using digits separators.

Parameters:

integer	- source integer value
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithBinaryInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Returns a string created as a text representation of the binary integer value with the flag of using digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithBoolean:

(BOOL)

value

Returns a string created as a text representation of the boolean value.

Parameters:

value

- source boolean value

Returns:

Created string

+ (NSString *) stringWithCoder:

(NSCoder *)

coder

Returns a string created by using the specified coder.

Parameters:

coder

- source coder

Returns:

A created string

+ (NSString *) stringWithContentsOfSerializedFile:

(NSString *)

path

Returns a string created by using the contents of serialized file with the specified path.

Parameters:

path	- source serialized file path

Returns:

A created string

+ (NSString *) stringWithDataDictionary:

(NSDictionary *)

dictionary

Returns a string created by using the specified dictionary.

Parameters:

dictionary

- source dictionary

Returns:

A created string

+ (NSString *) stringWithDataDictionaryFromFile:

(NSString *)

path

Returns a string created by using the dictionary from the specified file.

Parameters:

path	- source dictionary file path

Returns:

A created string

+ (NSString *) stringWithDecimalInteger:

(SCULong)

integer

Returns a string created as the text representation of the decimal integer value without the digits separators.

Parameters:

integer

- source integer value

Returns:

Created string

+ (NSString *) stringWithDecimalInteger:		(SCULong)	integer
separator:		(NSString *)	separator

Returns a string created as the text representation of the decimal integer value with the specified digits separators.

Parameters:

integer	- source integer value
separator	- digits separators

Returns:

Created string

+ (NSString *) stringWithDecimalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Returns a string created as the text representation of the decimal integer value with the flag of using the digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

- (NSString *) stringWithDeletedSubstring:

(NSString *)

str

Returns a receiver's string without the specified substring.

Parameters:

str	- deleted substring

Returns:

String without deleted substring

See also:

- stringWithDeletedSubstring:caseInsensitive:

- (NSString *) stringWithDeletedSubstring:		(NSString *)	str
caseInsensitive:		(BOOL)	value

Returns a receiver's string without the specified substring. Case insensitively depends on the value of the specified flag.

Parameters:

str	- deleted substring
value	- YES for case insensitive comparison operations, otherwise NO

Returns:

String without deleted substring

See also:

- stringWithDeletedSubstring:

- (NSString *) stringWithDeletedSubstringFromIndex:

(SCUInteger)

index

Returns a receiver's string without characters after the specified index.

Parameters:

index

- first deleted character index

Returns:

String without deleted characters

- (NSString *) stringWithDeletedSubstringToIndex:

(SCUInteger)

index

Returns a receiver's string without characters before the specified index.

Parameters:

index

- last deleted character index

Returns:

String without deleted characters

- (NSString *) stringWithDeletedSubstringToRange:

(NSRange)

range

Returns a receiver's string without a characters before and in the specified range.

Parameters:

range

- characters range

Returns:

String without deleted characters

- (NSString *) stringWithDeletedSubstringWithRange:

(NSRange)

range

Returns a receiver's string without characters in the specified range.

Parameters:

range

- deleted characters range

Returns:

String without deleted characters

+ (NSString *) stringWithDouble:

(SCDouble)

dbl

Returns a string created as a text representation of the double floar value.

Parameters:

dbl	- source double value

Returns:

Created string

+ (NSString *) stringWithFileStream:

(NSString *)

path

Returns a string created from the stream file with the specified path.

Parameters:

path	- stream file path

Returns:

A created string

Exceptions:

SCStreamException

- stream operation error detected

- (NSString *) stringWithGroups

Devides the receiver's string into groups of the three characters with the space delimiter character.

Returns:

Devided string

- (NSString *) stringWithGroups:

(SCUInteger)

group

Devides the receiver's string into groups of the specified character number with the space delimiter character.

Parameters:

group

- number of characters in each group

Returns:

Devided string

- (NSString *) stringWithGroups:		(SCUInteger)	group
delimiter:		(unichar)	chr

Devides the receiver's string into groups of the specified characters number with the specified delimiter.

Parameters:

group	- number of characters in each group
chr	- delimiter character

Returns:

Devided string

- (NSString *) stringWithGroupsDelimiter:

(unichar)

chr

Devides the receiver's string into groups of three characters with the specified delimiter.

Parameters:

chr	- delimiter character

Returns:

Devided string

+ (NSString *) stringWithHexadecimalInteger:

(SCULong)

integer

Returs a string created as a text representation of the hexadecimal integer value.

Parameters:

integer

- source integer

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity

Returns a string created as a text representation of the hexadecimal integer value with the specified capacity and without using the sigits separators.

Parameters:

integer	- source integer
capacity	- integer capacity

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Returns a string created as a text representation of the hexadecimal integer value with the specified capacity and flag of using the digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	up

Returns a string created as a text representation of the hexadecimal integer value with the specified capacity, digits case and without using the digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
up	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	up
separators:		(BOOL)	separators

Returns a string created as a text representation of the hexadecimal integer value with the specified capacity, digits case and flag of using the digits separators.

Parameters:

integer	- source integer
capacity	- integer capacity
up	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Returns a string created as a text representation of the hexadecimal integer value with the specified flag of using digits separators.

Parameters:

integer	- source integer
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
uppercase:		(BOOL)	up

Returns a string created as a text representation of the hexadecimal integer value with the specified digits case and without the digits separators.

Parameters:

integer	- source integer
up	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

Created string

+ (NSString *) stringWithHexadecimalInteger:		(SCULong)	integer
uppercase:		(BOOL)	up
separators:		(BOOL)	separators

Returns a string created as a text representation of the hexadecimal integer value with the specified digits case and flag of using the digits separators.

Parameters:

integer	- source integer
up	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithID:

(id)

object

Returns a string created by using class instance description.

Parameters:

object

- class instance

Returns:

Created string

- (NSString *) stringWithInsertedString:

(NSString *)

str

Returns a string with added before the receiver's string the specified substring.

Parameters:

str	- added substring

Returns:

String with added substring

- (NSString *) stringWithInsertedString:		(NSString *)	str
index:		(SCUInteger)	index

Returns a string with inserted substring at the specified index.

Parameters:

str	- inserted string
index	- inserting index

Returns:

String with inserted string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base

Returns a string created as text representation of the integer value with the specified base and without digits separators.

Parameters:

integer	- source integer
base	- integer base

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity

Returns a string created as text representation of the integer value with the specified base, capacity and without digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
separators:		(BOOL)	separators

Returns a string created as text representation of the integer value with the specified base, capacity and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	uppercase

Returns a string created as text representation of the integer value with the specified base, capacity, digits case and without using the digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
capacity:		(SCCapacity)	capacity
uppercase:		(BOOL)	uppercase
separators:		(BOOL)	separators

Returns a string created as text representation of the integer value with the specified base, capacity, digits case and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
capacity	- integer capacity
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
separators:		(BOOL)	separators

Returns a string created as text representation of the integer value with the specified base and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
uppercase:		(BOOL)	uppercase

Returns a string created as text representation of the integer value with the specified base, digits case and without digits separators.

Parameters:

integer	- source integer
base	- integer base
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits

Returns:

Created string

+ (NSString *) stringWithInteger:		(SCULong)	integer
base:		(SCIntegerBase)	base
uppercase:		(BOOL)	uppercase
separators:		(BOOL)	separators

Returns a string created as text representation of the integer value with the specified base, digits case and flag of using the digits separators.

Parameters:

integer	- source integer
base	- integer base
uppercase	- YES for uppercase hexadecimal digits, NO for lowercase digits
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithLength:

(SCUInteger)

length

Returns a string created by using the specified number of space characters.

Parameters:

length

- required string length

Returns:

Created string

+ (NSString *) stringWithLength:		(SCUInteger)	length
character:		(unichar)	chr

Returns a string created by using the specified number of characters and character to fill the string.

Parameters:

length	- required string length
chr	- character to fill the string

Returns:

Created string

+ (NSString *) stringWithOctalInteger:

(SCULong)

integer

Returns a string created as a text representation of the octal integer value without digits separators.

Parameters:

integer

- source integer value

Returns:

Created string

+ (NSString *) stringWithOctalInteger:		(SCULong)	integer
separators:		(BOOL)	separators

Returns a string created as a text representation of the octal integer value with flag of using digits separators.

Parameters:

integer	- source integer value
separators	- YES for insert digits groups separators, NO for no separators

Returns:

Created string

+ (NSString *) stringWithPointer:

(void *)

pointer

Returns a string created as text representation of the specified pointer.

Parameters:

pointer

- source pointer

Returns:

Created substring

- (NSString *) stringWithReplacedSubstring:		(NSString *)	substring
string:		(NSString *)	str

Returns a string with replaced the specified substring by another substring.

Parameters:

substring	- replaced substring
str	- inserted substring

Returns:

String with replaced substring

See also:

- stringWithReplacedSubstring:string:caseInsensitive:

- (NSString *) stringWithReplacedSubstring:		(NSString *)	substring
string:		(NSString *)	str
caseInsensitive:		(BOOL)	value

Returns a string with replaced the specified substring by another substring. Case insensitively depends on the value of the specified flag.

Parameters:

substring	- replaced substring
str	- inserted substring
value	- YES for case insensitive comparison operations, otherwise NO

Returns:

String with replaced substring

See also:

- stringWithReplacedSubstring:string:

- (NSString *) stringWithReplacedSubstringFromIndex:		(SCUInteger)	index
string:		(NSString *)	str

Returns a string with replaced characters after the specified index by the specified substring.

Parameters:

index	- index of first replaced character
str	- inserted substring

Returns:

String with replaced substring

- (NSString *) stringWithReplacedSubstringToIndex:		(SCUInteger)	index
string:		(NSString *)	str

Returns a string with replaced characters before the specified index by the specified substring.

Parameters:

index	- index of last replaced character
str	- inserted substring

Returns:

String with replaced substring

- (NSString *) stringWithReplacedSubstringWithRange:		(NSRange)	range
string:		(NSString *)	str

Returns a string with replaced characters range by the specified substring.

Parameters:

range	- replaced characters range
str	- inserted string

Returns:

String with replaced substring

+ (NSString *) stringWithReversedString:

(NSString *)

str

Returns a string created by reversing the source string.

Parameters:

str	- source string

Returns:

Created string

+ (NSString *) stringWithSignedInteger:

(SCInteger)

integer

Returns a string created as the text representation of the decimal signed integer value.

Parameters:

integer

- source integer value

Returns:

Created string

+ (NSString *) stringWithSignedLong:

(SCLong)

longint

Returns a string created as the text representation of the decimal signed 64-bit integer value.

Parameters:

longint

- source integer value

Returns:

Created string

+ (NSString *) stringWithSignedShort:

(short)

integer

Returns a string created as the text representation of the decimal signed short integer value.

Parameters:

integer

- source integer value

Returns:

Created string

+ (NSString *) stringWithStream:

(SCStream *)

stream

Returns a string created from the specified stream.

Parameters:

stream

- stream for reading string

Returns:

A created string

Exceptions:

SCStreamException	- stream operation error detected
SCSystemException	- system error detected

+ (NSString *) stringWithString:		(NSString *)	str
groups:		(SCUInteger)	group

Returns a string created by deviding the source string into groups of the specified character number and the space delimiter character.

Parameters:

str	- source string
group	- number of characters in each group

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	str
groups:		(SCUInteger)	group
delimiter:		(unichar)	chr

Returns a string created by deviding the source string into groups of the specified character number with the specified delimiter character.

Parameters:

str	- source string
group	- number of characters in each group
chr	- delimiter character

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	str
groupsDelimiter:		(unichar)	chr

Returns a string created by deviding the source string into groups of the three characters with the specified delimiter character.

Parameters:

str	- source string
chr	- delimiter character

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	source
separators:		(NSString *)	separator
leftOver:		(SCUInteger)	over

Returns a string created by adding into the source string the specified separators after the specified number of characters from left to right.

Parameters:

source	- source string
separator	- added separator
over	- number of characters in each group

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	source
separators:		(NSString *)	separator
rightOver:		(SCUInteger)	over

Returns a string created by adding into the source string the specified separators after the specified number of characters from right to left.

Parameters:

source	- source string
separator	- added separator
over	- number of characters in each group

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	source
spacesFromLeftOver:		(SCUInteger)	over

Returns a string created by adding into the source string the space separators after the specified number of characters from left to right.

Parameters:

source	- source string
over	- number of characters in each group

Returns:

Created string

+ (NSString *) stringWithString:		(NSString *)	source
spacesFromRightOver:		(SCUInteger)	over

Returns a string created by adding into the source string the space separators after the specified number of characters from right to left.

Parameters:

source	- source string
over	- number of characters in each group

Returns:

Created string

+ (NSString *) stringWithStringGroups:

(NSString *)

str

Returns a string created by deviding the source string into groups of the three characters with the space delimiter character.

Parameters:

str	- source string

Returns:

Created string

+ (NSString *) stringWithUnichar:

(unichar)

chr

Returns a string created by using the specified character.

Parameters:

chr	- source character

Returns:

Created string

+ (NSString *) stringWithUnsignedShort:

(unsigned short)

integer

Returns a string created as the text representation of the decimal unsigned short integer value.

Parameters:

integer

- source integer value

Returns:

Created string

- (SCInteger) substringCount:

(NSString *)

str

Returns a substring occurrences count.

Parameters:

str	- desired substring

Returns:

Substring occurrences count

See also:

- substringCount:caseInsensitive:

- (SCInteger) substringCount:		(NSString *)	str
caseInsensitive:		(BOOL)	value

Returns a substring occurrences count. Case insensitively depends on the value of the specified flag.

Parameters:

str	- desired substring
value	- YES for the case insensitive comparison operations, otherwise NO

Returns:

Substring occurrences count

See also:

- substringCount:

- (BOOL) substringExists:

(NSString *)

str

Checks occurrence in the receiver's string the specified substring.

Parameters:

str	- desired substring

Returns:

YES if substring presents, otherwise NO

See also:

- substringExists:caseInsensitive:

- (BOOL) substringExists:		(NSString *)	str
caseInsensitive:		(BOOL)	value

Checks occurrence in the receiver's string the specified substring. Case insensitively depends on the value of the specified flag.

Parameters:

str	- desired substring
value	- YES for case insensitive comparison operations, otherwise NO

Returns:

YES if substring presents, otherwise NO

See also:

- substringExists:

- (NSString *) trim

Returns a string without a leading and trailing spaces and tabs.

Returns:

String without a leading and trailing spaces and tabs.

- (NSString *) upperFirstLetter

Returns a receiver's string with capital first character.

Returns:

String with capital first character

- (NSString *) word:

(SCUInteger)

wordIndex

Returns a word of the receiver's string at the specified index.

Parameters:

wordIndex

- required word index

Returns:

Required word or emty string

- (SCUInteger) wordsCount

Returns a words count in the receiver's string.

Returns:

Words count

- (BOOL) writeContentsToSerializedFile:

(NSString *)

path

Writes receiver's encoded string into the serialized file with the specified path.

Parameters:

path	- path at which to write the file

Returns:

YES if operation is successfully, otherwise NO

- (void) writeToDataDictionary:

(NSMutableDictionary *)

dictionary

Writes the receiver's string into the specified dictionary.

Parameters:

dictionary

- destination dictionary

- (void) writeToDataDictionaryFile:

(NSString *)

path

Atomically writes the receiver's string into the dictionary file with the specified path.

Parameters:

path	- path at which to write the file

- (void) writeToDataDictionaryFile:		(NSString *)	path
atomically:		(BOOL)	atomically

Writes the receiver's string into the dictionary file with the specified path.

Parameters:

path	- path at which to write the file
atomically	- YES for writing data to an auxiliary file, and then the auxiliary file is renamed to path, NO for writing data directly to path

- (void) writeToFileStream:

(NSString *)

path

Saves the receiver's string instance to the created stream file with the specified path.

Parameters:

path	- stream file path

Exceptions:

SCStreamException

- stream operation error detected

- (void) writeToStream:

(SCStream *)

stream

Saves the receiver's string to the specified stream.

Parameters:

stream

- stream for writing receiver's string

Exceptions:

SCStreamException	- stream operation error detected
SCSystemException	- system error detected

---

The documentation for this category was generated from the following files:

• SCString.h
• SCString.m