Struct Headers 

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

HTTP headers, matched case-insensitively and kept in order.

Debug output redacts the values of credential headers (see is_sensitive_header), so requests and responses can be logged.

Implementations

impl Headers

pub fn new() -> Self

No headers.

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

Append a header.

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

Append a header whose value is a secret, which Debug output redacts whatever the header’s name.

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

Remove every value of name, ignoring case.

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

The first value of name, ignoring case.

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

Iterate over (name, value) pairs.

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

How long the server asks the client to wait before retrying: the name header (usually retry-after) or retry-after-ms, parsed with parse_retry_after relative to the current time.

Unlike passing SystemTime::now() yourself, this also works on wasm32-unknown-unknown.

Trait Implementations

impl Clone for Headers

fn clone(&self) -> Self

Returns a duplicate 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() -> Self

Returns the “default value” for a type.

impl Eq for Headers

impl<K: Into<String>, V: Into<String>> FromIterator<(K, V)> for Headers

fn from_iter<I: IntoIterator<Item = (K, V)>>(iter: I) -> Self

Creates a value from an iterator.

impl PartialEq for Headers

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Headers