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.