Struct HostWriteGuard 

pub struct HostWriteGuard<'a, T> { /* private fields */ }

Closure-scoped write-only mapping of a backend allocation.

Examples

use tenferro_tensor::{HostAccessError, HostWriteGuard};

let mut written = Vec::new();
{
    let mut guard = HostWriteGuard::new(2, |source: &[u32]| {
        written.extend_from_slice(source);
        Ok::<(), HostAccessError>(())
    });
    guard.copy_from_slice(&[4, 5]).unwrap();
}
assert_eq!(written, [4, 5]);

Implementations

impl<'a, T> HostWriteGuard<'a, T>

pub fn new<F>(len: usize, copy: F) -> Self

where F: FnMut(&[T]) -> Result<(), HostAccessError> + 'a, T: 'a,

Wrap a backend-native write guard without exposing its concrete type.

Examples

use tenferro_tensor::{HostAccessError, HostWriteGuard};

let guard = HostWriteGuard::new(0, |_source: &[f32]| Ok::<(), HostAccessError>(()));
assert!(guard.is_empty());

Errors

Construction is infallible. A callback failure such as HostAccessError::BackendFailure is returned later by Self::copy_from_slice.

pub fn len(&self) -> usize

Number of elements covered by this write-only mapping.

Examples

use tenferro_tensor::{HostAccessError, HostWriteGuard};

let guard = HostWriteGuard::new(2, |_source: &[f32]| Ok::<(), HostAccessError>(()));
assert_eq!(guard.len(), 2);

pub fn is_empty(&self) -> bool

Returns true when this mapping covers no elements.

Examples

use tenferro_tensor::{HostAccessError, HostWriteGuard};

let guard = HostWriteGuard::new(0, |_source: &[f32]| Ok::<(), HostAccessError>(()));
assert!(guard.is_empty());

pub fn copy_from_slice(&mut self, source: &[T]) -> Result<(), HostAccessError>

Replace the full mapped allocation contents.

Examples

use tenferro_tensor::{HostAccessError, HostWriteGuard};

let mut guard = HostWriteGuard::new(1, |_source: &[f32]| Ok::<(), HostAccessError>(()));
guard.copy_from_slice(&[1.0]).unwrap();

Errors

Returns HostAccessError::LengthMismatch when source does not cover the complete mapping, or the typed backend error returned by the owning write guard.

Trait Implementations

impl<T> Debug for HostWriteGuard<'_, T>

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.