Struct net::url::Values

pub struct Values(pub HashMap<String, Vec<String>>);

Values maps a string key to a list of values. It is typically used for query parameters and form values. Unlike in the http.Header map, the keys in a Values map are case-sensitive.

Example

use net::url::Values;

fn main() {
    let mut v = Values::default();

    v.set("name".to_string(), "Ava");
    v.add("friend", "Jess");
    v.add("friend", "Sarah");
    v.add("friend", "Zoe");

    // v.Encode() == "name=Ava&friend=Jess&friend=Sarah&friend=Zoe"
    assert_eq!(v.get("name").unwrap(), "Ava");
    assert_eq!(v.get("friend").unwrap(), "Jess");

    let friends: Vec<String> = vec!["Jess", "Sarah", "Zoe"]
        .iter()
        .map(|v| v.to_string())
        .collect();
    assert_eq!(v.0["friend"], friends);
}

Implementations

impl Values

pub fn add<K, V>(&mut self, key: K, value: V) where
    K: ToString,
    V: ToString, 

add adds the value to key. It appends to any existing values associated with key.

pub fn del(&mut self, key: &str)

del deletes the values associated with key.

pub fn encode(&self) -> String

encode encodes the values into "URL encoded" form ("bar=baz&foo=quux") sorted by key.

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

get gets the first value associated with the given key. If there are no values associated with the key, get returns None. To access multiple values, use the map directly.

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

set sets the key to value. It replaces any existing values.

Trait Implementations

impl Debug for Values

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

Formats the value using the given formatter.

impl Default for Values

fn default() -> Values

Returns the "default value" for a type.