Struct Headers

pub struct Headers {
    headers: Vec<Header>,
}

Collection of HTTP headers.

Headers are stored in insertion order and support case-insensitive lookup. Multiple headers with the same name are allowed (e.g., Set-Cookie).

Fields

headers: Vec<Header>

Implementations

impl Headers

pub fn new() -> Self

Create an empty header collection.

pub fn len(&self) -> usize

Number of headers.

pub fn is_empty(&self) -> bool

Check if empty.

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

Add a header (allows duplicates).

Use this when multiple values for the same header are valid (e.g., Set-Cookie).

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

Set a header (replaces existing with same name).

Use this for headers that should have only one value (e.g., Content-Type, Host).

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

Get the first header value by name (case-insensitive).

pub fn get_all(&self, name: &str) -> Vec<&str>

Get all header values by name (case-insensitive).

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

Check if a header exists (case-insensitive).

pub fn remove(&mut self, name: &str) -> usize

Remove all headers with the given name (case-insensitive).

Returns the number of headers removed.

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

Iterate over all headers.

pub fn clear(&mut self)

Clear all headers.

pub fn content_length(&self) -> Option<usize>

Get Content-Length header as usize.

pub fn set_content_length(&mut self, length: usize)

Set Content-Length header.

pub fn content_type(&self) -> Option<&str>

Get Content-Type header.

pub fn set_content_type(&mut self, content_type: impl Into<String>)

Set Content-Type header.

pub fn is_chunked(&self) -> bool

Check if Transfer-Encoding is chunked.

pub fn host(&self) -> Option<&str>

Get Host header.

pub fn set_host(&mut self, host: impl Into<String>)

Set Host header.

pub fn connection(&self) -> Option<&str>

Get Connection header.

pub fn keep_alive(&self) -> bool

Check if connection should be kept alive.

pub fn to_wire_format(&self) -> String

Serialize headers to wire format (for HTTP requests).

Each header is formatted as: Name: Value\r\n

pub fn from_wire_format(data: &str) -> (Self, usize)

Parse headers from wire format.

Expects format: Name: Value\r\n for each header. Stops at empty line (double CRLF).

Trait Implementations

impl Clone for Headers

fn clone(&self) -> Headers

Returns a copy of the value.

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

Performs copy-assignment from source.

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.

impl PartialEq for Headers

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Headers

impl StructuralPartialEq for Headers