Type Method

maximum(_:_:)

Returns the greater of the two given values.

Declaration

static func maximum(_ x: Double, _ y: Double) -> Double

Parameters

x

A floating-point value.

y

Another floating-point value.

Return Value

The greater of x and y, or whichever is a number if the other is NaN.

Discussion

This method returns the maximum of two values, preserving order and eliminating NaN when possible. For two values x and y, the result of maximum(x, y) is x if x > y, y if x <= y, 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.

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

The maximum method implements the maxNum operation defined by the IEEE 754 specification.

See Also

Comparing Values

Floating-Point Operators for Double

Perform arithmetic and bitwise operations or compare values.

func isEqual(to: Double) -> Bool

Returns a Boolean value indicating whether this instance is equal to the given value.

func isLess(than: Double) -> Bool

Returns a Boolean value indicating whether this instance is less than the given value.

func isLessThanOrEqualTo(Double) -> Bool

Returns a Boolean value indicating whether this instance is less than or equal to the given value.

func isTotallyOrdered(belowOrEqualTo: Double) -> Bool

Returns a Boolean value indicating whether this instance should precede or tie positions with the given value in an ascending sort.

static func minimum(Double, Double) -> Double

Returns the lesser of the two given values.

static func minimumMagnitude(Double, Double) -> Double

Returns the value with lesser magnitude.

static func maximumMagnitude(Double, Double) -> Double

Returns the value with greater magnitude.