Struct hyper::header::Headers
[−]
[src]
pub struct Headers { /* fields omitted */ }
A map of header fields on requests and responses.
Methods
impl Headers
[src]
fn new() -> Headers
[src]
Creates a new, empty headers map.
fn with_capacity(len: usize) -> Headers
[src]
Creates a new Headers
struct with space reserved for len
headers.
fn set<H: Header>(&mut self, value: H)
[src]
Set a header field to the corresponding value.
The field is determined by the type of the value being set.
fn get<H: Header>(&self) -> Option<&H>
[src]
Get a reference to the header field's value, if it exists.
fn get_mut<H: Header>(&mut self) -> Option<&mut H>
[src]
Get a mutable reference to the header field's value, if it exists.
fn has<H: Header>(&self) -> bool
[src]
Returns a boolean of whether a certain header is in the map.
Example:
headers.set(ContentType::json()); assert!(headers.has::<ContentType>());
fn remove<H: Header>(&mut self) -> Option<H>
[src]
Removes a header from the map, if one existed. Returns the header, if one has been removed and could be parsed.
Note that this function may return None
even though a header was removed. If you want to
know whether a header exists, rather rely on has
.
fn iter(&self) -> HeadersItems
[src]
Returns an iterator over the header fields.
fn len(&self) -> usize
[src]
Returns the number of headers in the map.
fn clear(&mut self)
[src]
Remove all headers from the map.
fn get_raw(&self, name: &str) -> Option<&Raw>
[src]
Access the raw value of a header.
Prefer to use the typed getters instead.
Example:
let raw = headers.get_raw("content-type").unwrap(); assert_eq!(raw, "text/plain");
fn set_raw<K: Into<Cow<'static, str>>, V: Into<Raw>>(
&mut self,
name: K,
value: V
)
[src]
&mut self,
name: K,
value: V
)
Set the raw value of a header, bypassing any typed headers.
Example:
headers.set_raw("content-length", b"1".as_ref()); headers.set_raw("content-length", "2"); headers.set_raw("content-length", "3".to_string()); headers.set_raw("content-length", vec![vec![b'4']]);
fn append_raw<K: Into<Cow<'static, str>>, V: Into<Raw>>(
&mut self,
name: K,
value: V
)
[src]
&mut self,
name: K,
value: V
)
Append a value to raw value of this header.
If a header already contains a value, this will add another line to it.
If a header does not exist for this name, a new one will be created with the value.
Example:
headers.append_raw("x-foo", b"bar".to_vec()); headers.append_raw("x-foo", b"quux".to_vec());
fn remove_raw(&mut self, name: &str)
[src]
Remove a header by name.
Trait Implementations
impl Clone for Headers
[src]
fn clone(&self) -> Headers
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Default for Headers
[src]
impl PartialEq for Headers
[src]
fn eq(&self, other: &Headers) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
This method tests for !=
.
impl Display for Headers
[src]
fn fmt(&self, f: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl Debug for Headers
[src]
impl<'a> Extend<HeaderView<'a>> for Headers
[src]
fn extend<I: IntoIterator<Item = HeaderView<'a>>>(&mut self, iter: I)
[src]
Extends a collection with the contents of an iterator. Read more
impl<'a> Extend<(&'a str, Bytes)> for Headers
[src]
fn extend<I: IntoIterator<Item = (&'a str, Bytes)>>(&mut self, iter: I)
[src]
Extends a collection with the contents of an iterator. Read more
impl<'a> FromIterator<HeaderView<'a>> for Headers
[src]
fn from_iter<I: IntoIterator<Item = HeaderView<'a>>>(iter: I) -> Headers
[src]
Creates a value from an iterator. Read more