Struct ValueGuard 

pub struct ValueGuard<'a> { /* private fields */ }

A read-only value view retained by an eager tensor record.

The guard borrows the record’s allocation group. It never owns a tensor and cannot be converted into a mutable view.

Examples

use tenferro_ad::{EagerRuntime, EagerTensor, Tensor};
use tenferro_cpu::CpuBackend;

let ctx = EagerRuntime::with_cpu_backend(CpuBackend::new())?;
let value = EagerTensor::from_tensor_in(
    Tensor::from_vec_col_major(vec![2], vec![1.0_f64, 2.0])?,
    ctx,
)?;
let view = value.value()?;
assert_eq!(view.shape(), &[2]);

Implementations

impl<'a> ValueGuard<'a>

pub fn dtype(&self) -> DType

Return the scalar dtype of the retained value.

pub fn shape(&self) -> &[usize]

Return the logical shape of the retained value.

pub fn as_tensor_view(&self) -> &TensorView<'_>

Borrow the dtype-erased tensor view.

pub fn as_slice<T: TensorScalar>(&self) -> Result<&'a [T]>

Borrow compact host bytes through the tensor’s explicit scalar type.

Backend-resident values return the backend’s typed host-access error; this method does not download storage implicitly.

Errors

Returns tenferro_tensor::ValidationError::DTypeMismatch when T does not match the view dtype, tenferro_tensor::ValidationError::NonContiguousViewAsSlice for a non-contiguous view, or tenferro_tensor::Error::HostAccess when backend storage cannot be mapped as a host slice.

Trait Implementations

impl<'a> Debug for ValueGuard<'a>

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

Formats the value using the given formatter.