Struct Buffer 

pub struct Buffer { /* private fields */ }

GPU memory in unified (shared) storage: the CPU reads and writes it in place.

Buffers come from the device’s caching allocator and return to it when dropped. Hazard tracking is disabled at the Metal level (as in MLX); nuvec orders accesses itself. CPU access is refused while submitted GPU work uses the buffer, and GPU writes require &mut Buffer, so the CPU and the GPU never race on it.

Implementations

impl Buffer

pub fn len(&self) -> usize

Size in bytes.

pub fn is_empty(&self) -> bool

Whether the buffer holds no bytes.

pub fn in_use(&self) -> bool

Whether submitted GPU work still uses the buffer.

pub fn contents(&self) -> Result<&[u8]>

The bytes, if no submitted GPU work uses the buffer.

pub fn contents_mut(&mut self) -> Result<&mut [u8]>

The bytes, mutably, if no submitted GPU work uses the buffer.

Trait Implementations

impl Debug for Buffer

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

Formats the value using the given formatter.

impl Drop for Buffer

fn drop(&mut self)

Returns the memory to the allocator’s cache, unless GPU work still uses it (then it is released when the GPU finishes, never reused early).

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for Buffer

impl Sync for Buffer