Struct Uninit 

pub struct Uninit<B> { /* private fields */ }

Available on crate feature std only.

A read-target view of a buffer’s writable spare [buf_len, capacity): reading into it appends to the underlying (the view’s offset 0 is the underlying’s buf_len). Created by IoBufMut::uninit; recover the buffer with into_inner.

Implementations

impl<B> Uninit<B>

pub fn into_inner(self) -> B

Recover the underlying buffer, with whatever was read into the spare now part of its initialized region.

Trait Implementations

impl<B: Debug> Debug for Uninit<B>

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

Formats the value using the given formatter.

impl<B: IoBuf> IoBuf for Uninit<B>

fn as_init(&self) -> &[u8]

The initialized (readable / already-written) bytes.

fn buf_len(&self) -> usize

Number of initialized bytes (as_init().len()).

fn buf_ptr(&self) -> *const u8

Raw const pointer to the start of the initialized region: for handing an address to a kernel/FFI sink (io_uring SEND_ZC, a TLS BIO). Most code should prefer as_init.

fn slice(self, range: impl RangeBounds<usize>) -> Slice<Self>

where Self: Sized,

Restrict this buffer to the sub-range [begin, end), consuming it.

impl<B: IoBufMut> IoBufMut for Uninit<B>

fn as_uninit(&mut self) -> &mut [MaybeUninit<u8>]

The full backing storage as possibly-uninitialized bytes: the initialized prefix [0, buf_len) plus the writable spare [buf_len, capacity).

fn buf_capacity(&mut self) -> usize

Total capacity (as_uninit().len()).

fn buf_mut_ptr(&mut self) -> *mut u8

Raw mutable pointer to the start of the backing storage: for a kernel/FFI read target (io_uring recv). Most code should prefer spare_mut.

fn spare_mut(&mut self) -> &mut [MaybeUninit<u8>]

The writable spare tail [buf_len, capacity) — the read destination.

fn as_mut_slice(&mut self) -> &mut [u8]

The initialized region [0, buf_len) as a mutable slice, for an in-place transform (e.g. decrypting a TLS record inside the very buffer it arrived in, no copy).

fn uninit(self) -> Uninit<Self>

where Self: Sized,

A read-target view of just the writable spare [buf_len, capacity).

impl<B: SetLen + IoBuf> SetLen for Uninit<B>

unsafe fn set_len(&mut self, len: usize)

Set the initialized length to len.