Standard class NSNumber functionality extending category. More...

#import <SCNumber.h>

Inheritance diagram for NSNumber(SCNumber):

Creating Numbers
(NSNumber *)	+ numberWithNumber:

(NSNumber *)	+ numberWithByte:

(NSNumber *)	+ numberWithUnsignedByte:

(NSNumber *)	+ numberWithUnichar:

(NSNumber *)	+ numberWithBinaryString:

(NSNumber *)	+ numberWithOctalString:

(NSNumber *)	+ numberWithDecimalString:

(NSNumber *)	+ numberWithHexadecimalString:

(NSNumber *)	+ numberWithString:

(NSNumber *)	+ numberWithBoolString:

(NSNumber *)	+ numberWithFloatString:

(NSNumber *)	+ numberWithDoubleString:

(NSNumber *)	+ numberWithBinaryCharString:

(NSNumber *)	+ numberWithOctalCharString:

(NSNumber *)	+ numberWithDecimalCharString:

(NSNumber *)	+ numberWithHexadecimalCharString:

(NSNumber *)	+ numberWithCharString:

(NSNumber *)	+ numberWithBoolCharString:

(NSNumber *)	+ numberWithFloatCharString:

(NSNumber *)	+ numberWithDoubleCharString:

Initializing Numbers
(id)	- initWithNumber:

(id)	- initWithByte:

(id)	- initWithUnsignedByte:

(id)	- initWithUnichar:

(id)	- initWithBinaryString:

(id)	- initWithOctalString:

(id)	- initWithDecimalString:

(id)	- initWithHexadecimalString:

(id)	- initWithString:

(id)	- initWithBoolString:

(id)	- initWithFloatString:

(id)	- initWithDoubleString:

(id)	- initWithBinaryCharString:

(id)	- initWithOctalCharString:

(id)	- initWithDecimalCharString:

(id)	- initWithHexadecimalCharString:

(id)	- initWithCharString:

(id)	- initWithBoolCharString:

(id)	- initWithFloatCharString:

(id)	- initWithDoubleCharString:

Serialized Files Support
(NSNumber *)	+ numberWithCoder:

(NSNumber *)	+ numberWithContentsOfSerializedFile:

(id)	- initWithContentsOfSerializedFile:

(BOOL)	- writeContentsToSerializedFile:

Data Dictionaries Support
(NSNumber *)	+ numberWithDataDictionary:

(NSNumber *)	+ numberWithDataDictionaryFromFile:

(id)	- initWithDataDictionary:

(id)	- initWithDataDictionaryFromFile:

(void)	- writeToDataDictionary:

(void)	- writeToDataDictionaryFile:atomically:

(void)	- writeToDataDictionaryFile:

(NSDictionary *)	- dataDictionary

Streams Support
(NSNumber *)	+ numberWithStream:

(NSNumber *)	+ numberWithFileStream:

(id)	- initWithStream:

(id)	- initWithFileStream:

(void)	- writeToStream:

(void)	- writeToFileStream:

(void)	- appendToFileStream:

Collections Support
(id< SCCollectioning >)	- copyObject

(SCComparisonResult)	- compareWithObject:

Instance Properties
SCByte	byteValue

SCUByte	unsignedByteValue

unichar	unicharValue

NSString *	binaryString

NSString *	octalString

NSString *	decimalString

NSString *	string

NSString *	hexadecimalString

NSString *	boolString

NSString *	floatString

NSString *	doubleString

Number Type Detection
(SCStandardType)	- type

Comparing Numbers
(BOOL)	- isEqualToByte:

(BOOL)	- isEqualToUnsignedByte:

(BOOL)	- isEqualToShort:

(BOOL)	- isEqualToUnsignedShort:

(BOOL)	- isEqualToInteger:

(BOOL)	- isEqualToUnsignedInteger:

(BOOL)	- isEqualToLongLong:

(BOOL)	- isEqualToUnsignedLongLong:

(BOOL)	- isEqualToChar:

(BOOL)	- isEqualToUnichar:

(BOOL)	- isEqualToBool:

(BOOL)	- isEqualToFloat:

(BOOL)	- isEqualToDouble:

Comparing Numbers and Strings
(BOOL)	- isEqualToBinaryString:

(BOOL)	- isEqualToOctalString:

(BOOL)	- isEqualToDecimalString:

(BOOL)	- isEqualToHexadecimalString:

(BOOL)	- isEqualToString:

(BOOL)	- isEqualToBoolString:

(BOOL)	- isEqualToFloatString:

(BOOL)	- isEqualToDoubleString:

(BOOL)	- isEqualToBinaryCharString:

(BOOL)	- isEqualToOctalCharString:

(BOOL)	- isEqualToDecimalCharString:

(BOOL)	- isEqualToHexadecimalCharString:

(BOOL)	- isEqualToCharString:

(BOOL)	- isEqualToBoolCharString:

(BOOL)	- isEqualToFloatCharString:

(BOOL)	- isEqualToDoubleCharString:

Additional Inherited Members
Instance Methods inherited from <SCCoding>
Instance Methods inherited from <SCDictionaring>
Instance Methods inherited from <SCCollectioning>

Detailed Description

Standard class NSNumber functionality extending category.

Since: version 1.1.3

Declares the additional properties and methods for add into the standard class NSNumber the additional functionality such as dictionaries, collections and streams support and so on.@ Category methods can be throwing the following exceptions:

Method Documentation

- (void) appendToFileStream: (NSString *) path

Appends the receiving number to the file stream with the specified path.

Parameters

path	- the path to the destination file stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

Reimplemented from <SCStreaming>.

- (SCComparisonResult) compareWithObject: (id<SCCollectioning>) object

Returns the result of comparison the receiving string with a given another number.

Parameters

object - the second number for comparison

Returns

Comparison result:

SCComparisonEqual - numbers are equal
SCComparisonLess - the receiving number is less than the specified number
SCComparisonGreater - the receiving number is greater than the second number
SCComparisonNotAllowed - instances cannot be compared

Reimplemented from <SCCollectioning>.

- (id< SCCollectioning >) copyObject

Returns a copy of the receiving number.

Returns: A copy of the receiving number

Reimplemented from <SCCollectioning>.

- (NSDictionary *) dataDictionary

Returns the dictionary with the receiving number.

Returns: A dictionary which contains the receiving number

Reimplemented from <SCDictionaring>.

- (id) initWithBinaryCharString: (const char *) string

Initializes a number using a given character string with the binary representation of the integer value.

Parameters

string - the character string with the binary representation of the integer value

Returns: A newly initialized number

- (id) initWithBinaryString: (NSString *) string

Initializes a number using a given string with the binary representation of the integer value.

Parameters

string - the string with the binary representation of the integer value

Returns: A newly initialized number

- (id) initWithBoolCharString: (const char *) string

Initializes a number using a given character string with the text representation of the boolean value.

Parameters

string - the character string with the text representation of the boolean value

Returns: A newly initialized number

- (id) initWithBoolString: (NSString *) string

Initializes a number using a given string with the text representation of the boolean value.

Parameters

string - the string with the text representation of the boolean value

Returns: A newly initialized number

- (id) initWithByte: (SCByte) byte

Initializes a number using the specified 8-bit signed integer value.

Parameters

byte	- the source value

Returns: A newly initialized number

- (id) initWithCharString: (const char *) string

Initializes a number using a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: A newly initialized number

See also: - initWithDecimalCharString:

- (id) initWithContentsOfSerializedFile: (NSString *) path

Initializes a number created by using the data from the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns: A newly initialized string

Reimplemented from <SCCoding>.

- (id) initWithDataDictionary: (NSDictionary *) dictionary

Initializes a number using the data from the specified data dictionary.

Parameters

dictionary - the source data dictionary

Returns: A newly initialized number

Exceptions

SCNumberException - unsupported number type detected

Reimplemented from <SCDictionaring>.

- (id) initWithDataDictionaryFromFile: (NSString *) path

Initializes a number using the data from the dictionary file with the specified path.

Parameters

path	- the path to the source dictionary file

Returns: A newly initialized number

Exceptions

SCNumberException - unsupported number type detected

Reimplemented from <SCDictionaring>.

- (id) initWithDecimalCharString: (const char *) string

Initializes a number using a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: A newly initialized number

See also: - initWithCharString:

- (id) initWithDecimalString: (NSString *) string

Initializes a number using a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: A newly initialized number

See also: - initWithString:

- (id) initWithDoubleCharString: (const char *) string

Initializes a number using a given character string with the text representation of the double value.

Parameters

string - the character string with the text representation of the double value

Returns: A newly initialized number

- (id) initWithDoubleString: (NSString *) string

Initializes a number using a given string with the text representation of the double value.

Parameters

string - the string with the text representation of the double value

Returns: A newly initialized number

- (id) initWithFileStream: (NSString *) path

Initializes a string using the data from the file stream with the specified path.

Parameters

path	- the path to the source file stream

Returns: A newly initialized number

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

Reimplemented from <SCStreaming>.

- (id) initWithFloatCharString: (const char *) string

Initializes a number using a given character string with the text representation of the float value.

Parameters

string - the character string with the text representation of the float value

Returns: A newly initialized number

- (id) initWithFloatString: (NSString *) string

Initializes a number using a given string with the text representation of the float value.

Parameters

string - the string with the text representation of the float value

Returns: A newly initialized number

- (id) initWithHexadecimalCharString: (const char *) string

Initializes a number using a given character string with the hexadecimal representation of the integer value.

Parameters

string - the character string with the hexadecimal representation of the integer value

Returns: A newly initialized number

- (id) initWithHexadecimalString: (NSString *) string

Initializes a number using a given string with the hexadecimal representation of the integer value.

Parameters

string - the string with the hexadecimal representation of the integer value

Returns: A newly initialized number

- (id) initWithNumber: (NSNumber *) number

Returns a number initialized by copying the data from another given number.

Parameters

number - the number from which to copy data

Returns: A newly initialized number

- (id) initWithOctalCharString: (const char *) string

Initializes a number using a given character string with the octal representation of the integer value.

Parameters

string - the character string with the octal representation of the integer value

Returns: A newly initialized number

- (id) initWithOctalString: (NSString *) string

Initializes a number using a given string with the octal representation of the integer value.

Parameters

string - the string with the binary representation of the integer value

Returns: A newly initialized number

- (id) initWithStream: (SCStream *) stream

Initializes a number using the data from the specified stream.

Parameters

stream - the source stream

Returns: A newly initialized number

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

Reimplemented from <SCStreaming>.

- (id) initWithString: (NSString *) string

Initializes a number using a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: A newly initialized number

See also: - initWithDecimalString:

- (id) initWithUnichar: (unichar) chr

Initializes a number using the specified character.

Parameters

chr	- the source character

Returns: A newly initialized number

- (id) initWithUnsignedByte: (SCUByte) byte

Initializes a number using the specified 8-bit unsigned integer value.

Parameters

byte	- the source value

Returns: A newly initialized number

- (BOOL) isEqualToBinaryCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the binary representation of the integer value.

Parameters

string - the character string with the binary representation of the integer value

Returns: YES if the receiving number is equal to a string with the binary representation, otherwise NO

- (BOOL) isEqualToBinaryString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the binary representation of the integer value.

Parameters

string - the string with the binary representation of the integer value

Returns: YES if the receiving number is equal to a string with the binary representation, otherwise NO

- (BOOL) isEqualToBool: (BOOL) value

Returns a boolean value that indicates whether the receiving number is equal to a given boolean value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToBoolCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the text representation of the boolean value.

Parameters

string - the character string with the text representation of the boolean value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToBoolString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the text representation of the boolean value.

Parameters

string - the string with the text representation of the boolean value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToByte: (SCByte) value

Returns a boolean value that indicates whether the receiving number is equal to a given 8-bit signed integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToChar: (char) value

Returns a boolean value that indicates whether the receiving number is equal to a given character.

Parameters

value - the character to compare with the receiving number

Returns: YES if the receiving number is equal to a given character, otherwise NO

See also: - isEqualToUnichar:

- (BOOL) isEqualToCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the decimal representation, otherwise NO

See also: - isEqualToDecimalCharString:

- (BOOL) isEqualToDecimalCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the decimal representation, otherwise NO

See also: - isEqualToCharString:

- (BOOL) isEqualToDecimalString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the decimal representation, otherwise NO

See also: - isEqualToString:

- (BOOL) isEqualToDouble: (SCDouble) value

Returns a boolean value that indicates whether the receiving number is equal to a given double value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToDoubleCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the text representation of the double value.

Parameters

string - the character string with the text representation of the double value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToDoubleString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the text representation of the double value.

Parameters

string - the string with the text representation of the double value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToFloat: (SCFloat) value

Returns a boolean value that indicates whether the receiving number is equal to a given float value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToFloatCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the text representation of the float value.

Parameters

string - the character string with the text representation of the float value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToFloatString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the text representation of the float value.

Parameters

string - the string with the text representation of the float value

Returns: YES if the receiving number is equal to a string with the text representation, otherwise NO

- (BOOL) isEqualToHexadecimalCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the hexadecimal representation of the integer value.

Parameters

string - the character string with the hexadecimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the hexadecimal representation, otherwise NO

- (BOOL) isEqualToHexadecimalString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the hexadecimal representation of the integer value.

Parameters

string - the string with the hexadecimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the hexadecimal representation, otherwise NO

- (BOOL) isEqualToInteger: (SCInteger) value

Returns a boolean value that indicates whether the receiving number is equal to a given 32-bit signed integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToLongLong: (SCLong) value

Returns a boolean value that indicates whether the receiving number is equal to a given 64-bit signed integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToOctalCharString: (const char *) string

Returns a boolean value that indicates whether the receiving number is equal to a given character string with the octal representation of the integer value.

Parameters

string - the character string with the octal representation of the integer value

Returns: YES if the receiving number is equal to a string with the octal representation, otherwise NO

- (BOOL) isEqualToOctalString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the octal representation of the integer value.

Parameters

string - the string with the octal representation of the integer value

Returns: YES if the receiving number is equal to a string with the octal representation, otherwise NO

- (BOOL) isEqualToShort: (SCShort) value

Returns a boolean value that indicates whether the receiving number is equal to a given 16-bit signed integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToString: (NSString *) string

Returns a boolean value that indicates whether the receiving number is equal to a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: YES if the receiving number is equal to a string with the decimal representation, otherwise NO

See also: - isEqualToDecimalString:

- (BOOL) isEqualToUnichar: (unichar) value

Returns a boolean value that indicates whether the receiving number is equal to a given character.

Parameters

value - the character to compare with the receiving number

Returns: YES if the receiving number is equal to a given character, otherwise NO

See also: - isEqualToChar:

- (BOOL) isEqualToUnsignedByte: (SCUByte) value

Returns a boolean value that indicates whether the receiving number is equal to a given 8-bit unsigned integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToUnsignedInteger: (SCUInteger) value

Returns a boolean value that indicates whether the receiving number is equal to a given 32-bit unsigned integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToUnsignedLongLong: (SCULong) value

Returns a boolean value that indicates whether the receiving number is equal to a given 64-bit unsigned integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

- (BOOL) isEqualToUnsignedShort: (SCUShort) value

Returns a boolean value that indicates whether the receiving number is equal to a given 16-bit unsigned integer value.

Parameters

value - the value to compare with the receiving number

Returns: YES if the receiving number is equal to a given value, otherwise NO

+ (NSNumber *) numberWithBinaryCharString: (const char *) string

Returns a number created by using a given character string with the binary representation of the integer value.

Parameters

string - the character string with the binary representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithBinaryString: (NSString *) string

Returns a number created by using a given string with the binary representation of the integer value.

Parameters

string - the string with the binary representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithBoolCharString: (const char *) string

Returns a number created by using a given character string with the text representation of the boolean value.

Parameters

string - the character string with the text representation of the boolean value

Returns: A created number

+ (NSNumber *) numberWithBoolString: (NSString *) string

Returns a number created by using a given string with the text representation of the boolean value.

Parameters

string - the strig with the text representation of the boolean value

Returns: A created number

+ (NSNumber *) numberWithByte: (SCByte) byte

Returns a number created by using the specified 8-bit signed integer value.

Parameters

byte	- the source value

Returns: A created number

+ (NSNumber *) numberWithCharString: (const char *) string

Returns a number created by using a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: A created number

See also: + numberWithDecimalCharString:

+ (NSNumber *) numberWithCoder: (NSCoder *) coder

Returns a number created by using the data from the specified coder.

Parameters

coder - the source coder

Returns: A created number

+ (NSNumber *) numberWithContentsOfSerializedFile: (NSString *) path

Returns a number created by using the data from the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns: A created number

+ (NSNumber *) numberWithDataDictionary: (NSDictionary *) dictionary

Returns a number created by using the data from the specified data dictionary.

Parameters

dictionary - the source data dictionary

Returns: A created number

Exceptions

SCNumberException - unsupported number type detected

+ (NSNumber *) numberWithDataDictionaryFromFile: (NSString *) path

Returns a number created by using the data from the dictionary file with the specified path.

Parameters

path	- the path to the source dictionary file

Returns: A created number

Exceptions

SCNumberException - unsupported number type detected

+ (NSNumber *) numberWithDecimalCharString: (const char *) string

Returns a number created by using a given character string with the decimal representation of the integer value.

Parameters

string - the character string with the decimal representation of the integer value

Returns: A created number

See also: + numberWithCharString:

+ (NSNumber *) numberWithDecimalString: (NSString *) string

Returns a number created by using a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: A created number

See also: + numberWithString:

+ (NSNumber *) numberWithDoubleCharString: (const char *) string

Returns a number created by using a given character string with the text representation of the double value.

Parameters

string - the character string with the text representation of the double value

Returns: A created number

+ (NSNumber *) numberWithDoubleString: (NSString *) string

Returns a number created by using a given string with the text representation of the double value.

Parameters

string - the string with the text representation of the double value

Returns: A created number

+ (NSNumber *) numberWithFileStream: (NSString *) path

Returns a number created by using the data from the file stream with the specified path.

Parameters

path	- the path to the source file stream

Returns: A created number

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

+ (NSNumber *) numberWithFloatCharString: (const char *) string

Returns a number created by using a given character string with the text representation of the float value.

Parameters

string - the character string with the text representation of the float value

Returns: A created number

+ (NSNumber *) numberWithFloatString: (NSString *) string

Returns a number created by using a given string with the text representation of the float value.

Parameters

string - the string with the text representation of the float value

Returns: A created number

+ (NSNumber *) numberWithHexadecimalCharString: (const char *) string

Returns a number created by using a given character string with the hexadecimal representation of the integer value.

Parameters

string - the character string with the hexadecimal representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithHexadecimalString: (NSString *) string

Returns a number created by using a given string with the hexadecimal representation of the integer value.

Parameters

string - the string with the hexadecimal representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithNumber: (NSNumber *) number

Returns a number created by using the specified existing number.

Parameters

number - the source number.

Returns: A created number

+ (NSNumber *) numberWithOctalCharString: (const char *) string

Returns a number created by using a given character string with the octal representation of the integer value.

Parameters

string - the character string with the binary representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithOctalString: (NSString *) string

Returns a number created by using a given string with the octal representation of the integer value.

Parameters

string - the string with the octal representation of the integer value

Returns: A created number

+ (NSNumber *) numberWithStream: (SCStream *) stream

Returns a number created by using the data from the specified stream.

Parameters

stream - the source stream

Returns: A created number

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

+ (NSNumber *) numberWithString: (NSString *) string

Returns a number created by using a given string with the decimal representation of the integer value.

Parameters

string - the string with the decimal representation of the integer value

Returns: A created number

See also: + numberWithDecimalString:

+ (NSNumber *) numberWithUnichar: (unichar) chr

Returns a number created by using the specified character.

Parameters

chr	- the source character

Returns: A created number

+ (NSNumber *) numberWithUnsignedByte: (SCUByte) byte

Returns a number created by using the specified 8-bit unsigned integer value.

Parameters

byte	- the source value

Returns: A created number

- (SCStandardType) type

Returns a type of the receiving number.

Returns: A type of the receiving number

- (BOOL) writeContentsToSerializedFile: (NSString *) path

Writes the receiving number to the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns: YES if the operation is successfully, otherwise NO

Reimplemented from <SCCoding>.

- (void) writeToDataDictionary: (NSMutableDictionary *) dictionary

Writes the receiving number into the specified data dictionary.

Parameters

dictionary - the dictionary to store the receiving number

Reimplemented from <SCDictionaring>.

- (void) writeToDataDictionaryFile: (NSString *) path

Writes the receiving number into the data dictinary file with the specified path.

Parameters

path	- the path to the data dictionary file

Reimplemented from <SCDictionaring>.

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

Writes the receiving number into the data dictinary file with the specified path.

Parameters

path	- the path to the data dictionary file
atomically	- YES for using the intermediate file and NO for direct writing operation

Reimplemented from <SCDictionaring>.

- (void) writeToFileStream: (NSString *) path

Writes the receiving number to the file stream with the specified path.

Parameters

path	- the path to the destination file stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

Reimplemented from <SCStreaming>.

- (void) writeToStream: (SCStream *) stream

Writes the receiving number to the specified stream.

Parameters

stream - the destination stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected
SCNumberException	- unsupported number type detected

Reimplemented from <SCStreaming>.

Property Documentation

- (NSString *) binaryString

readnonatomicassign

The string with the binary representation of the receiving number

- (NSString *) boolString

readnonatomicretain

The string with the text representation of the receiving number as a boolean value

- (SCByte) byteValue

readnonatomicassign

The number value expressed as a 8-bit signed integer value

- (NSString *) decimalString

readnonatomicretain

The string with the decimal representation of the receiving number

See also: string

- (NSString *) doubleString

readnonatomicretain

The string with the text representation of the receiving number as a double value

- (NSString *) floatString

readnonatomicretain

The string with the text representation of the receiving number as a float value

- (NSString *) hexadecimalString

readnonatomicretain

The string with the hexadecimal representation of the receiving number

- (NSString *) octalString

readnonatomicretain

The string with the octal representation of the receiving number

- (NSString *) string

readnonatomicretain

The string with the decimal representation of the receiving number

See also: decimalString

- (unichar) unicharValue

readnonatomicassign

The number value expressed as a character

- (SCUByte) unsignedByteValue

readnonatomicassign

The number value expressed as a 8-bit unsigned integer value

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

SCNumber.h
SCNumber.m

Creating Numbers

Initializing Numbers

Serialized Files Support

Data Dictionaries Support

Streams Support

Collections Support

Instance Properties

Number Type Detection

Comparing Numbers

Comparing Numbers and Strings

Additional Inherited Members

Detailed Description

Method Documentation

Property Documentation