Trait half::slice::HalfBitsSliceExt

pub trait HalfBitsSliceExt: SealedHalfBitsSlice {
    // Required methods
    fn reinterpret_cast<H>(&self) -> &[H]
       where H: SealedHalf;
    fn reinterpret_cast_mut<H>(&mut self) -> &mut [H]
       where H: SealedHalf;
}

Extensions to [u16] slices to support reinterpret operations.

This trait is sealed and cannot be implemented outside of this crate.

Required Methods

fn reinterpret_cast<H>(&self) -> &[H]

where H: SealedHalf,

Reinterprets a slice of u16 bits as a slice of [f16] or bf16 numbers.

H is the type to cast to, and must be either the [f16] or bf16 type.

This is a zero-copy operation. The reinterpreted slice has the same lifetime and memory location as self.

Examples

let int_buffer = [f16::from_f32(1.).to_bits(), f16::from_f32(2.).to_bits(), f16::from_f32(3.).to_bits()];
let float_buffer: &[f16] = int_buffer.reinterpret_cast();

assert_eq!(float_buffer, [f16::from_f32(1.), f16::from_f32(2.), f16::from_f32(3.)]);

// You may have to specify the cast type directly if the compiler can't infer the type.
// The following is also valid in Rust.
let typed_buffer = int_buffer.reinterpret_cast::<f16>();

fn reinterpret_cast_mut<H>(&mut self) -> &mut [H]

where H: SealedHalf,

Reinterprets a mutable slice of u16 bits as a mutable slice of [f16] or bf16 numbers.

H is the type to cast to, and must be either the [f16] or bf16 type.

This is a zero-copy operation. The transmuted slice has the same lifetime as the original, which prevents mutating self as long as the returned &mut [f16] is borrowed.

Examples

let mut int_buffer = [f16::from_f32(1.).to_bits(), f16::from_f32(2.).to_bits(), f16::from_f32(3.).to_bits()];

{
    let float_buffer: &mut [f16] = int_buffer.reinterpret_cast_mut();

    assert_eq!(float_buffer, [f16::from_f32(1.), f16::from_f32(2.), f16::from_f32(3.)]);

    // Mutating the f16 slice will mutating the original
    float_buffer[0] = f16::from_f32(0.);
}

// Note that we need to drop float_buffer before using int_buffer again or we will get a borrow error.
assert_eq!(int_buffer, [f16::from_f32(0.).to_bits(), f16::from_f32(2.).to_bits(), f16::from_f32(3.).to_bits()]);

// You may have to specify the cast type directly if the compiler can't infer the type.
// The following is also valid in Rust.
let typed_buffer = int_buffer.reinterpret_cast_mut::<f16>();

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl HalfBitsSliceExt for [u16]

fn reinterpret_cast<H>(&self) -> &[H]

where H: SealedHalf,

fn reinterpret_cast_mut<H>(&mut self) -> &mut [H]

where H: SealedHalf,

Implementors