[−][src]Struct saphir::header::Headers
A map of header fields on requests and responses.
Methods
impl Headers
[src]
pub fn new() -> Headers
[src]
Creates a new, empty headers map.
pub fn with_capacity(len: usize) -> Headers
[src]
Creates a new Headers
struct with space reserved for len
headers.
pub fn set<H>(&mut self, value: H) where
H: Header,
[src]
H: Header,
Set a header field to the corresponding value.
The field is determined by the type of the value being set.
pub fn get<H>(&self) -> Option<&H> where
H: Header,
[src]
H: Header,
Get a reference to the header field's value, if it exists.
pub fn get_mut<H>(&mut self) -> Option<&mut H> where
H: Header,
[src]
H: Header,
Get a mutable reference to the header field's value, if it exists.
pub fn has<H>(&self) -> bool where
H: Header,
[src]
H: Header,
Returns a boolean of whether a certain header is in the map.
Example:
headers.set(ContentType::json()); assert!(headers.has::<ContentType>());
pub fn remove<H>(&mut self) -> Option<H> where
H: Header,
[src]
H: Header,
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
.
ⓘImportant traits for HeadersItems<'a>pub fn iter(&self) -> HeadersItems
[src]
Returns an iterator over the header fields.
pub fn len(&self) -> usize
[src]
Returns the number of headers in the map.
pub fn clear(&mut self)
[src]
Remove all headers from the map.
pub 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");
pub fn set_raw<K, V>(&mut self, name: K, value: V) where
K: Into<Cow<'static, str>>,
V: Into<Raw>,
[src]
K: Into<Cow<'static, str>>,
V: Into<Raw>,
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']]);
pub fn append_raw<K, V>(&mut self, name: K, value: V) where
K: Into<Cow<'static, str>>,
V: Into<Raw>,
[src]
K: Into<Cow<'static, str>>,
V: Into<Raw>,
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());
pub fn append_raw_str<V>(&mut self, name: &str, value: V) where
V: Into<Raw>,
[src]
V: Into<Raw>,
Alternative to append_raw that avoids an allocation if name already exists as a key.
pub fn remove_raw(&mut self, name: &str)
[src]
Remove a header by name.
Trait Implementations
impl Clone for Headers
[src]
impl Debug for Headers
[src]
impl Default for Headers
[src]
impl Display for Headers
[src]
impl<'a> Extend<(&'a str, Bytes)> for Headers
[src]
impl<'a> Extend<HeaderView<'a>> for Headers
[src]
fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = HeaderView<'a>>,
[src]
I: IntoIterator<Item = HeaderView<'a>>,
impl<'a> From<&'a HeaderMap<HeaderValue>> for Headers
[src]
fn from(header_map: &'a HeaderMap<HeaderValue>) -> Headers
[src]
impl<'a> From<&'a Headers> for HeaderMap<HeaderValue>
[src]
fn from(headers: &'a Headers) -> HeaderMap<HeaderValue>
[src]
impl From<HeaderMap<HeaderValue>> for Headers
[src]
fn from(header_map: HeaderMap<HeaderValue>) -> Headers
[src]
impl From<Headers> for HeaderMap<HeaderValue>
[src]
fn from(headers: Headers) -> HeaderMap<HeaderValue>
[src]
impl<'a> FromIterator<HeaderView<'a>> for Headers
[src]
fn from_iter<I>(iter: I) -> Headers where
I: IntoIterator<Item = HeaderView<'a>>,
[src]
I: IntoIterator<Item = HeaderView<'a>>,
impl PartialEq<Headers> for Headers
[src]
Auto Trait Implementations
impl !RefUnwindSafe for Headers
impl Send for Headers
impl !Sync for Headers
impl Unpin for Headers
impl !UnwindSafe for Headers
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,