Struct ZTensorReader 

pub struct ZTensorReader<R: Read + Seek> {
    pub reader: R,
    pub manifest: Manifest,
}

Reader for zTensor v1.1 files.

Fields

reader: R

manifest: Manifest

Implementations

impl ZTensorReader<BufReader<File>>

pub fn open(path: impl AsRef<Path>) -> Result<Self, ZTensorError>

Opens a zTensor file from path.

impl ZTensorReader<Cursor<Mmap>>

pub fn open_mmap(path: impl AsRef<Path>) -> Result<Self, ZTensorError>

Opens a zTensor file using memory mapping.

pub fn get_object_slice(&self, name: &str) -> Result<&[u8], ZTensorError>

Gets a zero-copy reference to an object’s data.

This is only available for:

• Memory-mapped readers
• Dense objects
• Raw encoding (not compressed)

pub fn get_object_slice_as<T: Pod>( &self, name: &str, ) -> Result<&[T], ZTensorError>

Gets a typed zero-copy reference to an object’s data.

impl<R: Read + Seek> ZTensorReader<R>

pub fn new(reader: R) -> Result<Self, ZTensorError>

Creates a new reader and parses the manifest.

Parsing algorithm per spec §4:

1. Read Footer: EOF - 16
2. Verify Magic: last 8 bytes == ZTEN1000
3. Read Size: first 8 bytes as u64 LE
4. Safety Check: abort if > 1GB
5. Read Manifest: EOF - 16 - manifest_size
6. Decode CBOR

pub fn list_objects(&self) -> &BTreeMap<String, Object>

Lists all objects in the file.

pub fn get_object(&self, name: &str) -> Option<&Object>

Gets metadata for an object by name.

pub fn read_component( &mut self, component: &Component, ) -> Result<Vec<u8>, ZTensorError>

Reads raw component data.

pub fn read_object( &mut self, name: &str, verify_checksum: bool, ) -> Result<Vec<u8>, ZTensorError>

Reads raw byte data of a dense object.

pub fn read_objects( &mut self, names: &[&str], verify_checksum: bool, ) -> Result<Vec<Vec<u8>>, ZTensorError>

Reads multiple objects in batch.

pub fn read_object_as<T: Pod>( &mut self, name: &str, ) -> Result<Vec<T>, ZTensorError>

Reads object data as a typed vector.

pub fn read_coo_object<T: Pod>( &mut self, name: &str, ) -> Result<CooTensor<T>, ZTensorError>

Reads a COO sparse object.

pub fn read_csr_object<T: Pod>( &mut self, name: &str, ) -> Result<CsrTensor<T>, ZTensorError>

Reads a CSR sparse object.