Instance Method インスタンスメソッド

isTotallyOrdered(belowOrEqualTo:)

Returns a Boolean value indicating whether this instance should precede or tie positions with the given value in an ascending sort. このインスタンスがある昇順ソートにおいて、与えられた値より前にくるまたは同じ位置かどうかを指し示すブール値を返します。

Declaration 宣言

func isTotallyOrdered(belowOrEqualTo other: Self) -> Bool

Parameters パラメータ

other

A floating-point value to compare to this value. この値と比較される浮動小数点値。

Return Value 戻り値

true if this value is ordered below or the same as other in a total ordering of the floating-point type; otherwise, false. true、この値が浮動小数点型の全順序においてotherと同じまたは下に順序付けられるならば;そうでなければ、false

Discussion 解説

This relation is a refinement of the less-than-or-equal-to operator (<=) that provides a total order on all values of the type, including signed zeros and NaNs. この関係は、より少ないか等しい演算子(<=の改良版です、それは、符号付きゼロとNaNを含む、その型のすべての値に関する全順序を提供します。

The following example uses isTotallyOrdered(belowOrEqualTo:) to sort an array of floating-point values, including some that are NaN: 以下の例は、isTotallyOrdered(belowOrEqualTo:)を使って、NaNである何かを含んでいる、浮動小数点値の配列をソートします:


var numbers = [2.5, 21.25, 3.0, .nan, -9.5]
numbers.sort { !$1.isTotallyOrdered(belowOrEqualTo: $0) }
print(numbers)
// Prints "[-9.5, 2.5, 3.0, 21.25, nan]"

The isTotallyOrdered(belowOrEqualTo:) method implements the total order relation as defined by the IEEE 754 specification. isTotallyOrdered(belowOrEqualTo:)メソッドは、全順序関係をIEEE 754仕様によって定義されるとおりに実装します。