Struct Map

pub struct Map<'a> { /* private fields */ }

A map used for holding query string paramenters or headers

Implementations

impl<'a> Map<'a>

pub const fn new() -> Self

Construct a new empty Map

pub fn len(&self) -> usize

Get the number of elements in this Map

pub fn is_empty(&self) -> bool

Return true if this Map is empty

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

Get the value of an element of this Map, or None if it doesn’t contain key

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

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

Insert a new element in this Map

If the key is already present, the value overwrites the existing value:

let mut map = rusty_s3::Map::new();
map.insert("k", "a");
assert_eq!(map.get("k"), Some("a"));
map.insert("k", "b");
assert_eq!(map.get("k"), Some("b"));

Panics

In case of out of bound inner index access

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

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

Insert a new element in this Map

If the key is already present, the value is appended to the existing value:

let mut map = rusty_s3::Map::new();
map.append("k", "a");
assert_eq!(map.get("k"), Some("a"));
map.append("k", "b");
assert_eq!(map.get("k"), Some("a, b"));

Panics

In case of out of bound inner index access

pub fn remove(&mut self, key: &str) -> Option<(Cow<'a, str>, Cow<'a, str>)>

Remove an element from this Map and return it

pub fn iter(&self) -> impl Iterator<Item = (&str, &str)> + Clone

Return an Iterator over this map

The elements are always sorted in alphabetical order based on the key.

Trait Implementations

impl<'a> Clone for Map<'a>

fn clone(&self) -> Map<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Map<'_>

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

Formats the value using the given formatter.

impl Default for Map<'_>

fn default() -> Self

Returns the “default value” for a type.