Struct Headers 

pub struct Headers { /* private fields */ }

HTTP headers collection.

Header names are normalized to lowercase at insertion time for case-insensitive matching. Lookups avoid allocation when the lookup key is already lowercase.

Implementations

impl Headers

pub fn new() -> Self

Create empty headers.

pub fn get(&self, name: &str) -> Option<&[u8]>

Get a header value by name (case-insensitive).

Avoids heap allocation when the lookup key is already lowercase.

pub fn insert(&mut self, name: impl Into<String>, value: impl Into<Vec<u8>>)

Insert a header.

The header name is normalized to lowercase.

pub fn insert_from_slice(&mut self, name: &str, value: &[u8])

Insert a header from borrowed slices with minimal allocation.

This is an optimized fast path for parsing that:

• Avoids double allocation for header names
• Lowercases in a single pass when needed
• Only allocates for the value copy

pub fn insert_lowercase(&mut self, name: String, value: Vec<u8>)

Insert a header with an already-lowercase name.

Safety Note

This method assumes the name is already lowercase. If it contains uppercase characters, lookups may fail. Use insert or insert_from_slice for untrusted input.

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

Iterate over all headers as (name, value) pairs.

pub fn len(&self) -> usize

Returns the number of headers.

pub fn is_empty(&self) -> bool

Returns true if there are no headers.

pub fn remove(&mut self, name: &str) -> Option<Vec<u8>>

Remove a header by name (case-insensitive).

Returns the removed value, if any.

pub fn contains(&self, name: &str) -> bool

Check if a header exists (case-insensitive).

Trait Implementations

impl Debug for Headers

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

Formats the value using the given formatter.

impl Default for Headers

fn default() -> Headers

Returns the “default value” for a type.