Struct PayloadParts 

pub struct PayloadParts { /* private fields */ }

Zero-copy payload splitter.

Splits a Bytes payload by a delimiter and provides access to individual parts as slices into the original payload. No allocations occur during splitting.

Supports both eager splitting (via split / split_with_finder) and demand-driven lazy splitting (via new_lazy + ensure).

Implementations

impl PayloadParts

pub fn split(payload: Bytes, delimiter: &[u8]) -> Self

Split a payload by the given delimiter.

Arguments

• payload - The payload to split
• delimiter - The delimiter bytes (e.g., b";;;")

Returns

A PayloadParts instance with zero-copy access to each part.

Performance

• O(n) scan with SIMD-accelerated delimiter search
• Zero heap allocations
• Parts are slices into the original Bytes

pub fn split_with_finder( payload: Bytes, finder: &Finder<'_>, delim_len: usize, ) -> Self

Split a payload using a pre-built Finder.

This avoids rebuilding the SIMD searcher on every call.

Arguments

• payload - The payload to split
• finder - Pre-built delimiter finder
• delim_len - Length of the delimiter in bytes

pub fn new_lazy(payload: Bytes) -> Self

Create a lazy payload splitter that scans delimiters on demand.

No scanning happens until ensure() is called.

pub fn ensure(&mut self, index: usize, finder: &Finder<'_>, delim_len: usize)

Ensure that part index is available by scanning delimiters incrementally.

After this call, self.get(index) returns the correct slice if the part exists, or an empty slice if the payload has fewer parts.

pub fn len(&self) -> usize

Get the number of parts.

pub fn is_empty(&self) -> bool

Check if there are no parts.

pub fn get(&self, index: usize) -> &[u8]

Get a part by index as a byte slice.

Returns an empty slice if the index is out of bounds.

pub fn get_bytes(&self, index: usize) -> Bytes

Get a part by index as a Bytes (zero-copy slice).

Returns an empty Bytes if the index is out of bounds.

pub fn payload(&self) -> &Bytes

Get the original payload.

pub fn iter(&self) -> impl Iterator<Item = &[u8]>

Iterate over all parts as byte slices.

Trait Implementations

impl Debug for PayloadParts

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

Formats the value using the given formatter.