Enum FieldLine 

pub enum FieldLine {
    Indexed {
        is_static: bool,
        index: u64,
    },
    IndexedPostBase {
        index: u64,
    },
    LiteralWithNameRef {
        never_index: bool,
        is_static: bool,
        name_index: u64,
        value: Bytes,
        value_huffman: bool,
    },
    LiteralWithPostBaseNameRef {
        never_index: bool,
        name_index: u64,
        value: Bytes,
        value_huffman: bool,
    },
    LiteralWithLiteralName {
        never_index: bool,
        name: Bytes,
        name_huffman: bool,
        value: Bytes,
        value_huffman: bool,
    },
}

Available on crate features http and std only.

A single field-line representation within an encoded field section (RFC 9204 §4.5.2–§4.5.6).

Indices are unresolved: dynamic references are relative to the section’s Base (or post-Base), as on the wire. huffman flags record whether a string was Huffman-encoded so the representation can be re-emitted faithfully; they do not affect equality of the decoded value.

Variants

Indexed

Indexed field line (RFC 9204 §4.5.2): a full entry by index.

Fields

is_static: bool

Whether the index is into the static table (T=1) or dynamic table (T=0).

index: u64

The static index, or the relative dynamic index (relative to Base).

IndexedPostBase

Indexed field line with post-Base index (RFC 9204 §4.5.3): a dynamic entry at or after Base.

Fields

index: u64

The post-Base index.

LiteralWithNameRef

Literal field line with a name reference (RFC 9204 §4.5.4).

Fields

never_index: bool

Whether an intermediary must forward this line as a literal (N bit).

is_static: bool

Whether the name index is static (T=1) or dynamic (T=0, relative to Base).

name_index: u64

The name’s static index, or relative dynamic index.

value: Bytes

The literal value.

value_huffman: bool

Whether the value was Huffman-encoded on the wire.

LiteralWithPostBaseNameRef

Literal field line with a post-Base name reference (RFC 9204 §4.5.5).

Fields

never_index: bool

Whether an intermediary must forward this line as a literal (N bit).

name_index: u64

The name’s post-Base index.

value: Bytes

The literal value.

value_huffman: bool

Whether the value was Huffman-encoded on the wire.

LiteralWithLiteralName

Literal field line with a literal name (RFC 9204 §4.5.6).

Fields

never_index: bool

Whether an intermediary must forward this line as a literal (N bit).

name: Bytes

The literal name.

name_huffman: bool

Whether the name was Huffman-encoded on the wire.

value: Bytes

The literal value.

value_huffman: bool

Whether the value was Huffman-encoded on the wire.

Implementations

impl FieldLine

pub fn encode<B>(&self, dst: &mut B)

where B: BufMut,

Encode this representation into dst.

pub fn decode( src: &mut &[u8], max_string_len: usize, ) -> Result<FieldLine, PrefixError>

Decode one field-line representation, bounding each decoded string by max_string_len.

pub fn decode_bytes( src: &mut Bytes, max_string_len: usize, ) -> Result<FieldLine, PrefixError>

Decode from owned bytes, slicing plain literals without copying their payloads. Leaves the cursor unchanged on error.

pub fn encoded_len( src: &[u8], max_string_len: usize, ) -> Result<usize, PrefixError>

Probe the complete field-line length without decoding or allocating strings. Incomplete bodies return UnexpectedEnd; impossible string lengths fail early.

Trait Implementations

impl Clone for FieldLine

fn clone(&self) -> FieldLine

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldLine

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

Formats the value using the given formatter.

impl Eq for FieldLine

impl PartialEq for FieldLine

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FieldLine