Struct Cookie

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

Cookie header, defined in RFC6265

If the user agent does attach a Cookie header field to an HTTP request, the user agent must send the cookie-string as the value of the header field.

When the user agent generates an HTTP request, the user agent MUST NOT attach more than one Cookie header field.

Example values

• SID=31d4d96e407aad42
• SID=31d4d96e407aad42; lang=en-US

Example

use hyper::header::{Headers, Cookie};

let mut headers = Headers::new();
let mut cookie = Cookie::new();
cookie.append("foo", "bar");

assert_eq!(cookie.get("foo"), Some("bar"));

headers.set(cookie);

Implementations

impl Cookie

pub fn new() -> Cookie

Creates a new Cookie header.

pub fn set<K, V>(&mut self, key: K, value: V)

where K: Into<Cow<'static, str>>, V: Into<Cow<'static, str>>,

Sets a name and value for the Cookie.

Note

This will remove all other instances with the same name, and insert the new value.

pub fn append<K, V>(&mut self, key: K, value: V)

where K: Into<Cow<'static, str>>, V: Into<Cow<'static, str>>,

Append a name and value for the Cookie.

Note

Cookies are allowed to set a name with a a value multiple times. For example:

use hyper::header::Cookie;
let mut cookie = Cookie::new();
cookie.append("foo", "bar");
cookie.append("foo", "quux");
assert_eq!(cookie.to_string(), "foo=bar; foo=quux");

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

Get a value for the name, if it exists.

Note

Only returns the first instance found. To access any other values associated with the name, parse the str representation.

pub fn iter(&self) -> CookieIter<'_>

Iterate cookies.

Iterate cookie (key, value) in insertion order.

use hyper::header::Cookie;
let mut cookie = Cookie::new();
cookie.append("foo", "bar");
cookie.append(String::from("dyn"), String::from("amic"));

let mut keys = Vec::new();
let mut values = Vec::new();
for (k, v) in cookie.iter() {
    keys.push(k);
    values.push(v);
}
assert_eq!(keys, vec!["foo", "dyn"]);
assert_eq!(values, vec!["bar", "amic"]);

Trait Implementations

impl Clone for Cookie

fn clone(&self) -> Cookie

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cookie

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

Formats the value using the given formatter.

impl Display for Cookie

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

Formats the value using the given formatter.

impl Header for Cookie

fn header_name() -> &'static str

Returns the name of the header field this belongs to.

fn parse_header(raw: &Raw) -> Result<Cookie>

Parse a header from a raw stream of bytes.

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

Format a header to outgoing stream.

impl PartialEq for Cookie

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.