Struct Header 

pub struct Header(/* private fields */);

HTTP headers — a multi-valued map with case-insensitive canonical keys.

Keys are stored in canonical form (“Content-Type”, not “content-type”). Mirrors Go’s http.Header.

Implementations

impl Header

pub fn new() -> Self

pub fn canonical_key(s: &str) -> String

Canonical form of a header key: “content-type” → “Content-Type”.

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

Return the first value for the given key, if any.

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

Set the key to a single value, replacing any existing values.

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

Add a value to the key without replacing existing values.

pub fn del(&mut self, key: &str)

Remove all values for the given key.

pub fn values(&self, key: &str) -> &[String]

All values for the given key.

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

Iterate over all (key, values) pairs.

pub fn is_empty(&self) -> bool

true if the header map contains no entries.

pub fn write_to(&self, w: &mut impl Write) -> Result<()>

Serialize the headers to wire format (each “Key: value\r\n” line). Does not write the terminal blank line.

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Header

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

Formats the value using the given formatter.

impl Default for Header

fn default() -> Header

Returns the “default value” for a type.

impl PartialEq for Header

fn eq(&self, other: &Header) -> 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 StructuralPartialEq for Header