Enum ChunkStep 

#[non_exhaustive]
pub enum ChunkStep {
    Data {
        skip: usize,
        len: usize,
    },
    NeedMore {
        consumed: usize,
    },
    Trailers {
        skip: usize,
        len: usize,
    },
    Done {
        consumed: usize,
    },
}

One step of ChunkedDecoder::decode, with explicit byte accounting so a caller can decode in place in its own buffer. Offsets are relative to the input of that call.

Examples

See ChunkedDecoder.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Data

Skip skip framing bytes, then len bytes are body data; consume both (skip + len) and call again with what follows.

Fields

skip: usize

Framing bytes before the data.

len: usize

Body data bytes.

NeedMore

More input is needed: drop the first consumed bytes (framing that was read), keep the rest, append more, and call again.

Fields

consumed: usize

Framing bytes consumed.

Trailers

Skip skip framing bytes, then len bytes are the trailer section (its field lines and the blank line), already validated; consume both, and the next call reports ChunkStep::Done. Only reported for a section that has at least one field.

The bytes are validated, not filtered: a section may name content-length, transfer-encoding, or host, which the connections drop from their trailer events (RFC 9110 section 6.5.1). A proxy must not relay these bytes as they are; re-emit the fields it keeps with end_body_with_trailers, which refuses the names a trailer may not carry.

Fields

skip: usize

Framing bytes before the section.

len: usize

Bytes of the trailer section, the final CRLF included.

Done

The body is complete after consumed more bytes (the last chunk and an empty trailer section); what follows belongs to the next message.

Fields

consumed: usize

Bytes consumed.

Trait Implementations

impl Clone for ChunkStep

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ChunkStep

impl Debug for ChunkStep

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

Formats the value using the given formatter.

impl Eq for ChunkStep

impl Hash for ChunkStep

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ChunkStep

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ChunkStep