Trait ByteSliceExt

pub trait ByteSliceExt {
    // Required method
    fn read_at<D: AsMut<[u8]> + ?Sized>(
        &self,
        offset: usize,
        destination: &mut D,
    ) -> usize;
}

Utility methods for working with byte slices/buffers.

Required Methods

fn read_at<D: AsMut<[u8]> + ?Sized>( &self, offset: usize, destination: &mut D, ) -> usize

Copies the contents of self into the byte-slice destination.

The copy starts at position offset into the source and copies as many bytes as possible until either we don’t have more bytes to copy or destination doesn’t have more space to hold them.

Returns

The amount of bytes written.

Examples

use glommio::{io::DmaFile, ByteSliceExt, LocalExecutor};

let ex = LocalExecutor::default();
ex.run(async {
    let file = DmaFile::create("test.txt").await.unwrap();
    let buf = file.alloc_dma_buffer(4096);
    let mut vec = vec![0; 64];
    let n = buf.read_at(0, &mut vec);
    assert_eq!(n, 64); // read 64 bytes, the size of the buffer

    let n = buf.read_at(4090, &mut vec);
    assert_eq!(n, 6); // read 6 bytes, as there are only 6 bytes left from this offset
    file.close().await.unwrap();
});

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<T: AsRef<[u8]> + ?Sized> ByteSliceExt for T