Function std::intrinsics::simd::simd_cast

source ·
pub unsafe extern "platform-intrinsic" fn simd_cast<T, U>(x: T) -> U
🔬This is a nightly-only experimental API. (core_intrinsics)
Expand description

Numerically cast a vector, elementwise.

T and U must be vectors of integer or floating point primitive types, and must have the same length.

When casting floats to integers, the result is truncated. Out-of-bounds result lead to UB. When casting integers to floats, the result is rounded. Otherwise, truncates or extends the value, maintaining the sign for signed integers.

§Safety

Casting from integer types is always safe. Casting between two float types is also always safe.

Casting floats to integers truncates, following the same rules as to_int_unchecked. Specifically, each element must:

  • Not be NaN
  • Not be infinite
  • Be representable in the return type, after truncating off its fractional part