NSDecimalNumber

NSDecimalNumberとは10進数を表すオブジェクトです。NSNumberを継承しており、四則演算 を行うためのラッパーを提供しています。インスタンス自体は、仮数×10^(指数)として表示可能な数値を表します。それぞれ、仮数は10進数の38桁整数、指数は-128〜127の整数を扱うことができます。

四則演算

加法

" + "の代わりにdecimalNumberByAddingメソッドを使用する。

Adding

  // result = first + second;
  NSDecimalNumber *result = [first decimalNumberByAdding:second];

減法

" - "の代わりにdecimalNumberBySubtractingメソッドを使用する。

Subtracting

  // result = first - second;
  [first decimalNumberBySubtracting:second];

乗法

" ＊ "の代わりにdecimalNumberByMultiplyingByメソッドを使用する。

Multiplying

  // result = first * second;
  [first decimalNumberByMultiplyingBy:second];

除法

" / "の代わりにdecimalNumberByDividingByメソッドを使用する。

Dividing

  // result = first / second;
  [first decimalNumberByDividingBy:second];

その他の演算

累乗を求める

10進数の値を累乗（2乗や3乗など）した結果を返す。
第１引数はNSUInteger型で指定する。

累乗

  // dNum^(power) : dNumのpower乗
  [dNum decimalNumberByRaisingToPower:power];

(例) 2の10乗を求める場合

- (void)doPowerUp {
    NSDecimalNumber *dNum2 = [NSDecimalNumber decimalNumberWithString:@"2"];
    NSDecimalNumber *dNum10 = [dNum1 decimalNumberByRaisingToPower:10];

    NSLog(@"result = %@",[dNum10 description]);  //  result = 1024
}

１０の累乗を乗算した値を求める

decimalNumberByMultiplyingByPowerOf10メソッドを使用する。

(例) 4の10乗に5.6を乗法した値を求める場合

  NSDecimalNumber *dNum4 = [NSDecimalNumber decimalNumberWithString:@"5.6"];

  // result = 5.6 * 10^4;
  NSDecimalNumber *result = [dNum4 decimalNumberByMultiplyingByPowerOf10:4];

値にアクセスする

レシーバのNSDecimalの数値（読み込みのみ）

  NSDecimalNumber *dNum7 = [NSDecimalNumber decimalNumberWithString:@"7"];
  NSDecimal *dnum7 = dNum7.decimalValue;

10進数オブジェクトの近似値のdoubleの数値（読み込みのみ）

   NSDecimalNumber *dNum10 = [NSDecimalNumber DecimalNumberWithString:@"10"];
   double num10 = dNum10.doubleValue;

最大値と最小値

1. maximumDecimalNumber

NSDecimalNumber型が扱うことができる最大値を取得する。

   NSDecimalNumber *maximum = NSDecimalNumber.maximumDecimalNumber;

2. minimumDecimalNumber

NSDecimalNumber型が扱うことができる最小値を取得する。

   NSDecimalNumber *minimum = NSDecimalNumber.maximumDecimalNumber;

3. notANumber

数ではない十進数オブジェクトを作って返す。

NSNumber *aNA = [NSDecimalNumber notANumber];

(例)

  NSDecimalNumber *Num = ....
  [[NSDcimalNumber notANumber] isEqualToNumber:Num];

4. "1"を作る

1の値を持つNSDecimalNumberオブジェクトを作成する。

  NSDecimalNumber *dNum1 = NSDecimalNumber.one;

5. "0"を作る

0の値を持つNSDecimalNumberオブジェクトを作成する。

  NSDecimalNumber *dNum0 = NSDecimalNumber.zero;

NSString列からNSDecimalNumberオブジェクトを作成する

(例)文字列"7"からNSDecimalNumber型を作成する。

  NSDecimalNumber *dNum7 = [NSDecimalNumber decimalNumberWithString:@"7"];