Type Method 型メソッド

maximumMagnitude(_:_:)

Returns the value with greater magnitude. より大きい規模を持つ値を返します。

Declaration 宣言 

static func maximumMagnitude(_ x: Float, _ y: Float) -> Float

Parameters パラメータ

x

A floating-point value. ある浮動小数点値。

y

Another floating-point value. もう１つの浮動小数点値。

Return Value 戻り値

Whichever of x or y has greater magnitude, or whichever is a number if the other is NaN. xとyのどちらがより大きい規模を持つか、または他方がNaNならば数である方。

Discussion 解説

This method returns the value with greater magnitude of the two given values, preserving order and eliminating NaN when possible. For two values x and y, the result of maximumMagnitude(x, y) is x if x.magnitude > y.magnitude, y if x.magnitude <= y.magnitude, or whichever of x or y is a number if the other is a quiet NaN. If both x and y are NaN, or either x or y is a signaling NaN, the result is NaN. このメソッドは、２つの与えられた値のうちより大きい規模を持つ値を返します、可能な場合は桁数の保全およびNaNの排除をします。２つの値xとyに対して、maximumMagnitude(x, y)の結果は、x.magnitude > y.magnitudeならばx、x.magnitude <= y.magnitudeならばy、または他のものがクワイエットNaNならばxかyどちらか数である方です。xとyの両方がNaN、またはxまたはyのどちらかがシグナルNaNならば、結果はNaNです。 


Double.maximumMagnitude(10.0, -25.0)
// -25.0
Double.maximumMagnitude(10.0, .nan)
// 10.0
Double.maximumMagnitude(.nan, -25.0)
// -25.0
Double.maximumMagnitude(.nan, .nan)
// nan

The maximumMagnitude method implements the maxNumMag operation defined by the IEEE 754 specification. maximumMagnitudeメソッドは、IEEE 754仕様によって定義されるmaxNumMag演算を実装します。

See Also 参照

Comparing Values 値の比較

Floating-Point Operators for Float Float用の浮動小数点演算
Perform arithmetic and bitwise operations or compare values. 算術およびビット単位の演算を実行します、または値を比較します。
func isEqual(to: Float) -> Bool
Returns a Boolean value indicating whether this instance is equal to the given value. このインスタンスが与えられた値と等しいかどうかを指し示すブール値を返します。
func isLess(than: Float) -> Bool
Returns a Boolean value indicating whether this instance is less than the given value. このインスタンスが与えられた値より小さいかどうかを指し示すブール値を返します。
func isLessThanOrEqualTo(Float) -> Bool
Returns a Boolean value indicating whether this instance is less than or equal to the given value. このインスタンスが与えられた値より小さいまたは等しいかどうかを指し示すブール値を返します。
func isTotallyOrdered(belowOrEqualTo: Float) -> Bool
Returns a Boolean value indicating whether this instance should precede or tie positions with the given value in an ascending sort. このインスタンスがある昇順ソートにおいて、与えられた値より前にくるまたは同じ位置かどうかを指し示すブール値を返します。
static func maximum(Float, Float) -> Float
Returns the greater of the two given values. ２つの与えられた値の大きい方を返します。
static func minimum(Float, Float) -> Float
Returns the lesser of the two given values. ２つの与えられた値のより小さい方を返します。
static func minimumMagnitude(Float, Float) -> Float
Returns the value with lesser magnitude. より小さい規模を持つ値を返します。