Struct Segments 

pub struct Segments(/* private fields */);

Ordered byte segments that make up one virtqueue payload.

This is the high-level counterpart to the descriptor-oriented BufferChain.

Implementations

impl Segments

pub fn new(segments: impl IntoIterator<Item = Bytes>) -> Self

Build a segmented payload from ordered byte segments.

pub fn single(segment: Bytes) -> Self

Build a single-segment payload.

pub fn len(&self) -> usize

Total payload length across all segments.

pub fn is_empty(&self) -> bool

Whether the payload contains zero bytes.

pub fn segment_count(&self) -> usize

Number of byte segments.

pub fn as_slice(&self) -> &[Bytes]

Borrow all segments.

pub fn iter(&self) -> impl Iterator<Item = &Bytes>

Iterate over segments.

pub fn as_buf(&self) -> SegmentsBuf<'_>

Borrow this payload as a Buf cursor.

pub fn to_bytes(&self) -> Bytes

Return this payload as contiguous bytes.

This is O(1) for zero or one segment, and allocates/copies for multiple segments.

pub fn into_bytes(self) -> Bytes

Consume this payload and return contiguous bytes.

This is O(1) for zero or one segment, and allocates/copies for multiple segments.

Trait Implementations

impl Clone for Segments

fn clone(&self) -> Segments

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Segments

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

Formats the value using the given formatter.

impl Default for Segments

fn default() -> Segments

Returns the “default value” for a type.