Class

NSNumber

An object wrapper for primitive scalar numeric values. 原始的なスカラー数値に対するオブジェクトラッパー。

Declaration 宣言

@interface NSNumber : NSValue

Overview 概要

NSNumber is a subclass of NSValue that offers a value as any C scalar (numeric) type. It defines a set of methods specifically for setting and accessing the value as a signed or unsigned char, short int, int, long int, long long int, float, or double or as a BOOL. (Note that number objects do not necessarily preserve the type they are created with.) It also defines a compare: method to determine the ordering of two NSNumber objects. NSNumberは、NSValueのサブクラスです、それは値を何らかのCスカラー（数値）型として提示します。それは一揃いのメソッドを定義します、とりわけ値への設定およびアクセスを、符号付きまたは符号無しのchar、short int、int、long int、long long int、float、またはdoubleとしてもしくはBOOLとして行うために。（数のオブジェクトは必ずしもそれらが作成されたところの型を保護する必要はないことに注意してください。）それはまたcompare:メソッドを定義して、２つのNSNumberオブジェクトの順番付けを決定します。

NSNumber is “toll-free bridged” with its Core Foundation counterparts: CFNumberRef for integer and floating point values, and CFBooleanRef for Boolean values. See Toll-Free Bridging for more information on toll-free bridging. NSNumberは、それのCore Foundation相当物と「トールフリーブリッジ」されます：整数および浮動小数点値に対してCFNumberRef、そしてブール値に対してCFBooleanRef。トールフリーブリッジに関する更なる情報としてtoll-free bridgingを見てください。

Value Conversions 値変換

NSNumber provides readonly properties that return the object’s stored value converted to a particular Boolean, integer, unsigned integer, or floating point C scalar type. Because numeric types have different storage capabilities, attempting to initialize with a value of one type and access the value of another type may produce an erroneous result—for example, initializing with a double value exceeding FLT_MAX and accessing its floatValue, or initializing with an negative integer value and accessing its unsignedIntegerValue. In some cases, attempting to initialize with a value of a type and access the value of another type may result in loss of precision—for example, initializing with a double value with many significant digits and accessing its floatValue, or initializing with a large integer value and accessing its charValue. NSNumberは、いくつかの読出し専用プロパティを提供します、それらはある特定のブール値、整数、符号無し整数、または浮動小数点Cスカラー型に変換された、オブジェクトのもつ格納値を返します。数値型それらが異なるストレージ容量を持ちうることから、ある型の値で初期化して別の型の値にアクセスを試みることは、間違った結果を生成するかもしれません — 例えば、double値で初期化してFLT_MAXを越えることおよびそれのfloatValueにアクセスすること、または負整数で初期化してそれのunsignedIntegerValueにアクセスすること。いくつかの場合には、ある型の値で初期化して別の型の値にアクセスを試みることは正確さを失う結果になるかもしれません — 例えば、多くの有効桁をもつdouble値で初期化してそれのfloatValueにアクセスする、または大きな整数で初期化してそれのcharValueにアクセスする。

An NSNumber object initialized with a value of a particular type accessing the converted value of a different kind of type, such as unsigned int and float, will convert its stored value to that converted type in the following ways: ある特定の型の値で初期化されるNSNumberオブジェクトに、異なる種類の型の変換値、例えばunsigned intおよびfloatでアクセスすると、それの格納値をその変換値へと以下の方法で変換します：

Table 1 NSNumber from Boolean Value Conversions 表 1 Boolean値からNSNumberに変換

`Value 値`	`boolValue`	`integerValue`	`unsignedIntegerValue`	`floatValue`
`NO`	`NO`	`0`	`0`	`0.0`
`YES`	`YES`	`1`	`1`	`1.0`

Table 2 NSNumber from Integer Value Conversions 表 2 整数値からNSNumberに変換

`Value 値`	`boolValue`	`integerValue`	`unsignedIntegerValue`	`floatValue`
`0`	`NO`	`0`	`0`	`0.0`
`1`	`YES`	`1`	`1`	`1.0`
`-1`	`YES`	`-1`	invalid, erroneous result 無効、誤った結果	`-1.0`

Table 3 NSNumber from Unsigned Integer Value Conversions 表 3 符号なし整数値からNSNumberに変換

`Value 値`	`boolValue`	`integerValue`	`unsignedIntegerValue`	`floatValue`
`0`	`NO`	`0`	`0`	`0.0`
`1`	`YES`	`1`	`1`	`1.0`

Table 4 NSNumber from Floating Point Value Conversions 表 4 浮動小数点値からNSNumberに変換

`Value 値`	`boolValue`	`integerValue`	`unsignedIntegerValue`	`floatValue`
`0.0`	`NO`	`0`	`0`	`0.0`
`1.0`	`YES`	`1`	`1`	`1.0`
`-1.0`	`YES`	`-1`	invalid, erroneous result 無効、誤った結果	`-1.0`

Subclassing Notes サブクラス作成の注意

As with any class cluster, subclasses of NSNumber must override the primitive methods of its superclass, NSValue. In addition, there are two requirements around the data type your subclass represents: 何らかのクラスクラスタでのように、NSNumberのサブクラスはそれのスーパークラス、NSValueの根本的メソッドをオーバーライドしなければなりません。加えて、あなたのサブクラスが表すデータ型を取り巻く２つの要件があります：

Your implementation of objCType must return one of “c”, “C”, “s”, “S”, “i”, “I”, “l”, “L”, “q”, “Q”, “f”, and “d”. This is required for the other methods of NSNumber to behave correctly. あなたのobjCTypeの実装は、 “c”、“C”、“s”、“S”、“i”、“I”、“l”、“L”、“q”、“Q”、“f”、そして“d” の１つを返さなければなりません。これは、NSNumberの他のメソッドに振る舞いを正しくするよう要求します。
Your subclass must override the accessor method that corresponds to the declared type—for example, if your implementation of objCType returns “i”, you must override intValue.

Topics 話題

Creating an NSNumber Object NSNumberオブジェクトを作成する

+ numberWithBool:

Creates and returns an NSNumber object containing a given value, treating it as a BOOL. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをBOOLだとみなしています。

+ numberWithChar:

Creates and returns an NSNumber object containing a given value, treating it as a signed char. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それを符号付きcharだとみなしています。

+ numberWithDouble:

Creates and returns an NSNumber object containing a given value, treating it as a double. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをdoubleだとみなしています。

+ numberWithFloat:

Creates and returns an NSNumber object containing a given value, treating it as a float. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをfloatだとみなしています。

+ numberWithInt:

Creates and returns an NSNumber object containing a given value, treating it as a signed int. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それを符号付きintだとみなしています。

+ numberWithInteger:

Creates and returns an NSNumber object containing a given value, treating it as an NSInteger. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをNSIntegerだとみなしています。

+ numberWithLong:

Creates and returns an NSNumber object containing a given value, treating it as a signed long. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それを符号付きlongだとみなしています。

+ numberWithLongLong:

Creates and returns an NSNumber object containing a given value, treating it as a signed long long. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それを符号付きlong longだとみなしています。

+ numberWithShort:

Creates and returns an NSNumber object containing value, treating it as a signed short. あるNSNumberオブジェクトを作成して返します、valueを含んでいます、それを符号付きshortだとみなしています。

+ numberWithUnsignedChar:

Creates and returns an NSNumber object containing a given value, treating it as an unsigned char. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをunsigned charだとみなしています。

+ numberWithUnsignedInt:

Creates and returns an NSNumber object containing a given value, treating it as an unsigned int. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをunsigned intだとみなしています。

+ numberWithUnsignedInteger:

Creates and returns an NSNumber object containing a given value, treating it as an NSUInteger. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをNSUIntegerだとみなしています。

+ numberWithUnsignedLong:

Creates and returns an NSNumber object containing a given value, treating it as an unsigned long. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをunsigned longだとみなしています。

+ numberWithUnsignedLongLong:

Creates and returns an NSNumber object containing a given value, treating it as an unsigned long long. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをunsigned long longだとみなしています。

+ numberWithUnsignedShort:

Creates and returns an NSNumber object containing a given value, treating it as an unsigned short. あるNSNumberオブジェクトを作成して返します、ある与えられた値を含んでいます、それをunsigned shortだとみなしています。

Initializing an NSNumber Object NSNumberオブジェクトを初期化する

- initWithBool:

Returns an NSNumber object initialized to contain a given value, treated as a BOOL. NSNumberオブジェクトを返します、与えられた値を、BOOLとみなして含むよう初期化されます。

- initWithChar:

Returns an NSNumber object initialized to contain a given value, treated as a signed char. NSNumberオブジェクトを返します、与えられた値を、符号付きcharとみなして含むよう初期化されます。

- initWithDouble:

Returns an NSNumber object initialized to contain value, treated as a double. NSNumberオブジェクトを返します、valueを、doubleとみなして含むよう初期化されます。

- initWithFloat:

Returns an NSNumber object initialized to contain a given value, treated as a float. NSNumberオブジェクトを返します、与えられた値を、floatとみなして含むよう初期化されます。

- initWithInt:

Returns an NSNumber object initialized to contain a given value, treated as a signed int. NSNumberオブジェクトを返します、与えられた値を、符号付きintとみなして含むよう初期化されます。

- initWithInteger:

Returns an NSNumber object initialized to contain a given value, treated as an NSInteger. NSNumberオブジェクトを返します、与えられた値を、NSIntegerとみなして含むよう初期化されます。

- initWithLong:

Returns an NSNumber object initialized to contain a given value, treated as a signed long. NSNumberオブジェクトを返します、与えられた値を、符号付きlongだとみなして含むように初期化されます。

- initWithLongLong:

Returns an NSNumber object initialized to contain value, treated as a signed long long. NSNumberオブジェクトを返します、valueを、符号付きlong longとみなして含むよう初期化されます。

- initWithShort:

Returns an NSNumber object initialized to contain a given value, treated as a signed short. NSNumberオブジェクトを返します、与えられた値を、符号付きshortとみなして含むよう初期化されます。

- initWithUnsignedChar:

Returns an NSNumber object initialized to contain a given value, treated as an unsigned char. NSNumberオブジェクトを返します、与えられた値を、unsigned charとみなして含むよう初期化されます。

- initWithUnsignedInt:

Returns an NSNumber object initialized to contain a given value, treated as an unsigned int. NSNumberオブジェクトを返します、与えられた値を、unsigned intとみなして含むよう初期化されます。

- initWithUnsignedInteger:

Returns an NSNumber object initialized to contain a given value, treated as an NSUInteger. NSNumberオブジェクトを返します、与えられた値を、NSUIntegerとみなして含むよう初期化されます。

- initWithUnsignedLong:

Returns an NSNumber object initialized to contain a given value, treated as an unsigned long. NSNumberオブジェクトを返します、与えられた値を、unsigned longとみなして含むよう初期化されます。

- initWithUnsignedLongLong:

Returns an NSNumber object initialized to contain a given value, treated as an unsigned long long. NSNumberオブジェクトを返します、与えられた値を、unsigned long longとみなして含むよう初期化されます。

- initWithUnsignedShort:

Returns an NSNumber object initialized to contain a given value, treated as an unsigned short. NSNumberオブジェクトを返します、与えられた値を、unsigned shortとみなして含むよう初期化されます。

Accessing Numeric Values 数値にアクセスする

boolValue

The number object's value expressed as a Boolean value. 数オブジェクトのもつ値、ブール値として表されます。

charValue

The number object's value expressed as a char. 数オブジェクトのもつ値、charとして表されます。

decimalValue

The number object's value expressed as an NSDecimal structure. 数オブジェクトのもつ値、NSDecimal構造体として表されます。

doubleValue

The number object's value expressed as a double, converted as necessary. 数オブジェクトのもつ値、doubleとして表されます、必要に応じて変換されます。

floatValue

The number object's value expressed as a float, converted as necessary. 数オブジェクトのもつ値、floatとして表されます、必要に応じて変換されます。

intValue

The number object's value expressed as an int, converted as necessary. 数オブジェクトのもつ値、intとして表されます、必要に応じて変換されます。

integerValue

The number object's value expressed as an NSInteger object, converted as necessary. 数オブジェクトのもつ値、NSIntegerとして表されます、必要に応じて変換されます。

longLongValue

The number object’s value expressed as a long long, converted as necessary. 数オブジェクトのもつ値、long longとして表されます、必要に応じて変換されます。

longValue

The number object's value expressed as a long, converted as necessary. 数オブジェクトのもつ値、longとして表されます、必要に応じて変換されます。

shortValue

The number object's value expressed as a short, converted as necessary. 数オブジェクトのもつ値、shortとして表されます、必要に応じて変換されます。

unsignedCharValue

The number object's value expressed as an unsigned char, converted as necessary. 数オブジェクトのもつ値、charとして表されます、必要に応じて変換されます。

unsignedIntegerValue

The number object's value expressed as an NSUInteger object, converted as necessary. 数オブジェクトのもつ値、NSUIntegerとして表されます、必要に応じて変換されます。

unsignedIntValue

The number object's value expressed as an unsigned int, converted as necessary. 数オブジェクトのもつ値、intとして表されます、必要に応じて変換されます。

unsignedLongLongValue

The number object’s value expressed as an unsigned long long, converted as necessary. 数オブジェクトのもつ値、符号無しlong longとして表されます、必要に応じて変換されます。

unsignedLongValue

The number object's value expressed as an unsigned long, converted as necessary. 数オブジェクトのもつ値、符号無しlongとして表されます、必要に応じて変換されます。

unsignedShortValue

The number object's value expressed as an unsigned short, converted as necessary. 数オブジェクトのもつ値、符号無しshortとして表されます、必要に応じて変換されます。

Retrieving String Representations 文字列表現を回収する

- descriptionWithLocale:

Returns a string that represents the contents of the number object for a given locale. ある文字列を返します、数オブジェクトの内容をある与えられたロケールに対して表します。

stringValue

The number object's value expressed as a human-readable string. 数オブジェクトのもつ値、人間の読みやすい文字列として表されます。

Comparing NSNumber Objects NSNumberオブジェクトの比較

- compare:

Returns an NSComparisonResult value that indicates whether the number object’s value is greater than, equal to, or less than a given number. あるNSComparisonResult値を返します、それは数オブジェクトのもつ値がある与えられた数より大きい、等しい、またはより小さいかを指し示します。

- isEqualToNumber:

Returns a Boolean value that indicates whether the number object’s value and a given number are equal. あるブール値を返します、それは数オブジェクトのもつ値とある与えられた数が等しいかどうかを指し示します。

Accessing Type Information 型情報にアクセスする

objCType

Returns a C string containing the Objective-C type of the data contained in the number object. あるC文字列を返します、その数オブジェクトの中に含まれたデータのObjective-C型を含んでいます。

Number Validation 数の検証

NSDecimalIsNotANumber

Returns a Boolean that indicates whether a given decimal contains a valid number. 与えられた10進数が有効な数を含んでいるかどうかを指し示すブール値を返します。

Initializers イニシャライザ

- initWithCoder:

Relationships 関係

Inherits From 継承元

NSValue