Struct http_req::response::Headers

pub struct Headers(_);

Wrapper around HashMap<String, String> with additional functionality for parsing HTTP headers

Example

use http_req::response::Headers;

let mut headers = Headers::new();
headers.insert("Connection", "Close");

assert_eq!(headers.get("Connection"), Some(&"Close".to_string()))

Methods

impl Headers

pub fn new() -> Headers

Creates an empty Headers.

The headers are initially created with a capacity of 0, so they will not allocate until it is first inserted into.

pub fn with_capacity(capacity: usize) -> Headers

Creates empty Headers with the specified capacity.

The headers will be able to hold at least capacity elements without reallocating. If capacity is 0, the headers will not allocate.

pub fn iter(&self) -> Iter<String, String>

An iterator visiting all key-value pairs in arbitrary order. The iterator element type is (&String, &String).

pub fn get<T: ToString>(&self, k: T) -> Option<&String>

Returns a reference to the value corresponding to the key.

pub fn insert<T: ?Sized, U: ?Sized>(
    &mut self,
    key: &T,
    val: &U
) -> Option<String> where
    T: ToString,
    U: ToString, 

Inserts a key-value pair into the headers.

If the headers did not have this key present, None is returned.

If the headers did have this key present, the value is updated, and the old value is returned. The key is not updated, though; this matters for types that can be == without being identical.

pub fn default_http(uri: &Uri) -> Headers

Creates default headers for a HTTP request

Trait Implementations

impl PartialEq<Headers> for Headers

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Default for Headers

fn default() -> Headers

Returns the "default value" for a type.

impl From<HashMap<String, String, RandomState>> for Headers

fn from(map: HashMap<String, String>) -> Headers

Performs the conversion.

impl From<Headers> for HashMap<String, String>

fn from(map: Headers) -> HashMap<String, String>

Performs the conversion.

impl Clone for Headers

fn clone(&self) -> Headers

Returns a copy 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 FromStr for Headers

type Err = ParseErr

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Headers, ParseErr>

Parses a string s to return a value of this type.