docs for to_int_unchecked should mention the safe version

[Lokathor]

The docs for to_int_unchecked should mention that round is the safe version of the function.

[programmerjake]

uuh, round isn't the safe version of to_int_unchecked:
https://play.rust-lang.org/?version=stable&mode=debug&edition=2021&gist=a68ddebbf0e80e37bf027ff5d2738350

[src/main.rs:2] unsafe { 1.7f32.to_int_unchecked() } = 1
[src/main.rs:3] 1.7f32.round() = 2.0
[src/main.rs:4] 1.7f32 as i32 = 1

[Lokathor]

ah, so it's a truncate

[workingjubilee]

Yes, roughly following cvttps2dq for the obvious cast of Simd::<f32, N>::to_int_unchecked::<i32>(self) -> Simd<i32, N>. Simd::cast::<i32>(self) will exhibit the correct safe behavior most of the time. It is completely reasonable for us to mention the safe function.