Struct Float32x4

pub struct Float32x4(/* private fields */);

A 128-bit SIMD vector with 4 f32 components.

Implementations

impl Float32x4

pub const fn new(v0: f32, v1: f32, v2: f32, v3: f32) -> Self

Create a new vector with the given components.

Parameters

• v0 - the first component of the vector
• v1 - the second component of the vector
• v2 - the third component of the vector
• v3 - the fourth component of the vector

pub const fn splat(value: f32) -> Self

Create a new vector with the given value in all components.

Parameters

• value - the value to set all components to

pub const unsafe fn from_aligned_ptr(ptr: *const f32) -> Self

Load a vector from a pointer to an aligned series of f32 values.

Safety

The pointer must be aligned to 16 bytes, and the pointer must be able to reach at least 4 f32 values.

Parameters

• ptr - the pointer to the slice of f32 values

pub const unsafe fn from_unaligned_ptr(ptr: *const f32) -> Self

Load a vector from a slice of f32 values.

Safety

The pointer must be able to reach at least 4 f32 values.

Parameters

• ptr - the pointer to the slice of f32 values

pub unsafe fn store_aligned(&self, ptr: *mut f32)

Store the vector into a slice of f32 values.

Safety

The the pointer must be able to reach at least 4 f32 values.

impl Float32x4

pub const ALIGN: usize = 16usize

The alignment of the Float32x4 type.

pub fn from_slice(slice: &[f32]) -> Self

Create a new Float32x4 from the elements within the slice, taking care to handle both aligned and unaligned slices – as well as padding slices that contain less than 4 elements with zeros.

Parameters

• slice - the slice of f32 values to create the vector from

pub unsafe fn from_aligned_slice(slice: &[f32]) -> Self

Create a new Float32x4 from the elements within the aligned slice.

Parameters

• slice - the aligned slice of f32 values to create the vector from

Safety

The slice must be aligned to 16 bytes

pub unsafe fn from_aligned_slice_exact(slice: &[f32]) -> Self

Create a new Float32x4 from the elements within the aligned slice.

Parameters

• slice - the aligned slice of f32 values to create the vector from

Safety

The slice must be aligned to 16 bytes, and the length of the slice must be a multiple of 4.

pub unsafe fn from_unaligned_slice_exact(slice: &[f32]) -> Self

Create a new Float32x4 from the elements within the aligned slice.

Parameters

• slice - the aligned slice of f32 values to create the vector from

Safety

The slice must contain a multiple of 4 elements.

pub fn from_unaligned_slice(slice: &[f32]) -> Self

Create a new Float32x4 from the elements within the unaligned slice.

Parameters

• slice - the unaligned slice of f32 values to create the vector from

pub fn iter_slice(slice: &[f32]) -> impl Iterator<Item = Self> + '_

Returns an iterator that yields Float32x4 values from the given slice.

If the slice is not divisible by 4, the remaining elements will be padded with zeros.

Parameters

• slice - the slice of f32 values to create the vector from

pub unsafe fn iter_slice_exact(slice: &[f32]) -> impl Iterator<Item = Self> + '_

Returns an iterator that yields Float32x4 values from the given slice.

Parameters

• slice - the slice of f32 values to create the vector from

Safety

The slice must contain a multiple of 4 elements.

Trait Implementations

impl Default for Float32x4

fn default() -> Self

Create a new Float32x4 with all components set to zero.

impl From<&[f32]> for Float32x4

fn from(slice: &[f32]) -> Self

Create a new Float32x4 from the given slice of f32 values.

Parameters

• slice - the slice of f32 values to create the vector from

impl From<[f32; 4]> for Float32x4

fn from(arr: [f32; 4]) -> Self

Create a new Float32x4 from the given array of f32 values.

Parameters

• arr - the array of f32 values to create the vector from

impl From<Float32x4> for [f32; 4]

fn from(vec: Float32x4) -> Self

Create a new array of f32 values from the given Float32x4.

Parameters

• vec - the Float32x4 to create the array from

impl FromIterator<f32> for Float32x4

fn from_iter<I: IntoIterator<Item = f32>>(iter: I) -> Self

Create a new Float32x4 from the first 4 elements within the iterator.

Parameters

• iter - the iterator of f32 values to create the vector from