Struct HeaderFields 

pub struct HeaderFields { /* private fields */ }

Collection of header fields.

The collection uses Vec<_> internally to store the header fields, so it preserves the field order and allows multiple fields with the same name. This also means that complexity of some operations is O(n). However, this should not pose a problem in practice, as the number of header fields is usually quite small. The number of header fields can be also limited by the header field decoder. It is a trade-off between performance and footprint.

Implementations

impl HeaderFields

pub const fn new() -> HeaderFields

Create a new collection of header fields.

pub fn with_capacity(capacity: usize) -> HeaderFields

Create a new collection of header fields with a given initial capacity.

pub fn add<T>(&mut self, field: T)

where T: Into<HeaderField>,

Add a given header field to the collection.

This is an O(1) operation.

pub fn set<T>(&mut self, field: T)

where T: Into<HeaderField>,

Replace all header fields having the same name (if any).

This is an O(n) operation.

pub fn remove<N>(&mut self, name: &N)

where N: AsRef<[u8]> + ?Sized,

Remove all header fields with a given name.

This is an O(n) operation.

pub fn get<'a, N>(&'a self, name: &'a N) -> FieldIter<'a>

where N: AsRef<[u8]> + ?Sized,

Get header fields with a given name.

This is an O(n) operation.

pub fn last<'a, N>(&'a self, name: &'a N) -> Option<&'a HeaderField>

where N: AsRef<[u8]> + ?Sized,

Get the last header field with a given name.

This is an O(n) operation.

pub fn last_value<'a, N>(&'a self, name: &'a N) -> Option<&'a HeaderFieldValue>

where N: AsRef<[u8]> + ?Sized,

Get value of the last header field with a given name.

This is an O(n) operation.

pub fn all(&self) -> Iter<'_>

Get all header fields.

pub fn is_empty(&self) -> bool

Check if the collection is empty.

pub fn len(&self) -> usize

Get the number of header fields in the collection.

Trait Implementations

impl Clone for HeaderFields

fn clone(&self) -> HeaderFields

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeaderFields

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

Formats the value using the given formatter.

impl Default for HeaderFields

fn default() -> HeaderFields

Returns the “default value” for a type.

impl From<Vec<HeaderField>> for HeaderFields

fn from(fields: Vec<HeaderField>) -> HeaderFields

Converts to this type from the input type.