パラメータ
- P - 精度。有効範囲: [ 1 : 76 ]。数値が持てる10進の桁数 (小数部を含む) を決定します。デフォルトの精度は 10 です。
- S - スケール。有効範囲: [ 0 : P ]。小数部が持てる10進の桁数を決定します。
- P が [ 1 : 9 ] の場合 - Decimal32(S)
- P が [ 10 : 18 ] の場合 - Decimal64(S)
- P が [ 19 : 38 ] の場合 - Decimal128(S)
- P が [ 39 : 76 ] の場合 - Decimal256(S)
Decimal の値の範囲
- Decimal(P, S) - (-1 * 10^(P - S), 1 * 10^(P - S))
- Decimal32(S) - (-1 * 10^(9 - S), 1 * 10^(9 - S))
- Decimal64(S) - (-1 * 10^(18 - S), 1 * 10^(18 - S))
- Decimal128(S) - (-1 * 10^(38 - S), 1 * 10^(38 - S))
- Decimal256(S) - (-1 * 10^(76 - S), 1 * 10^(76 - S))
内部表現
内部的には、データはそれぞれのビット幅に応じた通常の符号付き整数として表現されます。メモリに格納できる実際の値の範囲は、上で示した範囲よりわずかに広くなっていますが、これは文字列から変換する場合にのみチェックされます。 現在の CPU は 128 ビット整数および 256 ビット整数をネイティブにサポートしていないため、Decimal128 と Decimal256 の演算はエミュレートされます。そのため、Decimal128 と Decimal256 は Decimal32/Decimal64 よりも大幅に低速です。演算と結果型
Decimal に対する二項演算の結果型は、引数の順序に関係なく、より広い型になります。Decimal64(S1) <op> Decimal32(S2) -> Decimal64(S)Decimal128(S1) <op> Decimal32(S2) -> Decimal128(S)Decimal128(S1) <op> Decimal64(S2) -> Decimal128(S)Decimal256(S1) <op> Decimal<32|64|128>(S2) -> Decimal256(S)
- 加算、減算: S = max(S1, S2)。
- 乗算: S = S1 + S2。
- 除算: S = S1。
オーバーフローチェック
Decimal の計算中には、整数オーバーフローが発生することがあります。小数部の桁数が多すぎる場合、その超過分は切り捨てられます (丸めは行われません) 。整数部の桁数が多すぎる場合は、例外が発生します。decimal_check_overflow 設定を使ってチェックを無効にするのが適切です。チェックを無効にした状態でオーバーフローが発生すると、結果は不正確になります:
decimal_check_overflow が有効な場合 (デフォルト) 、小数点以下の桁数が異なる値同士の比較は正確に行われます。これは、共通の小数点以下の桁数に揃えた際に値が型に収まらない場合でも同様です: