Function 関数

NSDecimalAdd(_:_:_:_:)

Adds two decimal values. ２つの10進数値を足し算します。

Declaration 宣言 

func NSDecimalAdd(_ result: UnsafeMutablePointer<Decimal>, 
                _ leftOperand: UnsafePointer<Decimal>, 
                _ rightOperand: UnsafePointer<Decimal>, 
                _ roundingMode: NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError

Discussion 議論

Adds leftOperand to rightOperand and stores the sum in result. Decimal instances can represent a number with up to 38 significant digits. If a number is more precise than that, it must be rounded off. roundingMode determines how to round it off. There are four possible rounding modes: leftOperandをrightOperandに加えて、合計をresultに格納します。Decimalインスタンスは、ある数を38の有効桁まで表せます。ある数がそれより大きい精度を持つならば、それは丸められなければなりません。roundingModeは、どのようにそれを丸めるかを決定します。４つの可能な丸めモードがあります：

The return value indicates whether any machine limitations were encountered in the addition. If none were encountered, the function returns NSCalculationNoError. Otherwise it may return one of the following values: NSCalculationLossOfPrecision, NSCalculationOverflow or NSCalculationUnderflow. For descriptions of all these error conditions, see exceptionDuringOperation(_:error:leftOperand:rightOperand:) in NSDecimalNumberBehaviors. 戻り値は、何らかのマシン限界が加算において出くわされたかどうかを指し示します。何も出くわさなかったならば、関数はNSCalculationNoErrorを返します。そうでなければそれは以下の値の１つを返すでしょう：NSCalculationLossOfPrecision、NSCalculationOverflowまたはNSCalculationUnderflow。これらのエラー状態のすべての説明として、exceptionDuringOperation(_:error:leftOperand:rightOperand:)をNSDecimalNumberBehaviorsで見てください。

For more information, see Number and Value Programming Topics. 詳細は、Number and Value Programming Topicsを見てください。

See Also 参照

Performing Arithmetic Using References 参照を使って算術を実行する

func NSDecimalCompact(UnsafeMutablePointer<Decimal>)
Compacts the decimal structure for efficiency. 効率のために10進構造体をコンパクトにします。
func NSDecimalSubtract(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, UnsafePointer<Decimal>, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Subtracts one decimal value from another. ある10進数値を別のものから引きます。
func NSDecimalDivide(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, UnsafePointer<Decimal>, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Divides one decimal value by another. ある10進数値を別のもので割ります。
func NSDecimalMultiply(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, UnsafePointer<Decimal>, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Multiplies two decimal numbers together. ２つの10進数を互いに掛け合わせます。
func NSDecimalMultiplyByPowerOf10(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, Int16, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Multiplies a decimal by the specified power of 10. 指定された10の累乗を、ある10進数に掛けます。
func NSDecimalRound(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, Int, NSDecimalNumber.RoundingMode)
Rounds off the decimal value. 10進法値を丸めます。
func NSDecimalPower(UnsafeMutablePointer<Decimal>, UnsafePointer<Decimal>, Int, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Raises the decimal value to the specified power. 10進法値を指定累乗します。
func NSDecimalNormalize(UnsafeMutablePointer<Decimal>, UnsafeMutablePointer<Decimal>, NSDecimalNumber.RoundingMode) -> NSDecimalNumber.CalculationError
Normalizes the internal format of two decimal numbers to simplify later operations. ２つの10進法数の内部形式を正規化して、後の演算を簡単にします。
typealias Decimal.RoundingMode
An alias for an enumeration that specifies possible rounding modes. 可能な丸めモードを指定する列挙のためのエイリアス。
enum NSDecimalNumber.RoundingMode
These constants specify rounding behaviors. これらの定数は、丸め挙動を指定します。
typealias Decimal.CalculationError
An alias for a type that specifies possible calculation errors. 起こりうる計算エラーを指定する型のためのエイリアス。
enum NSDecimalNumber.CalculationError
Calculation error constants used to describe an error in exceptionDuringOperation(_:error:leftOperand:rightOperand:). exceptionDuringOperation(_:error:leftOperand:rightOperand:)におけるエラーを解説するのに使われる計算エラー定数。