Skip to main content

## maximum_number_nsz_f16

# Function maximum_number_nsz_f16

Source

    pub const fn maximum_number_nsz_f16(x: f16, y: f16) -> f16

🔬This is a nightly-only experimental API. (`core_intrinsics`)
Expand description

Returns the maximum of two `f16` values, ignoring NaN.

This behaves like IEEE 754-2019 maximumNumber, except that it does not order signed zeros deterministically. In particular: If one of the arguments is NaN (quiet or signaling), then the other argument is returned. If both arguments are NaN, returns NaN. If the inputs compare equal (such as for the case of `+0.0` and `-0.0`), either input may be returned non-deterministically.

Note that, unlike most intrinsics, this is safe to call; it does not require an `unsafe` block. Therefore, implementations must not require the user to uphold any safety invariants.

The stabilized version of this intrinsic is `f16::max`.