Struct http::header::OccupiedEntry[][src]

pub struct OccupiedEntry<'a, T: 'a> { /* fields omitted */ }

A view into a single occupied location in a HeaderMap.

This struct is returned as part of the Entry enum.

Methods

impl<'a, T> OccupiedEntry<'a, T>
[src]

Returns a reference to the entry's key.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());

if let Entry::Occupied(e) = map.entry("host").unwrap() {
    assert_eq!("host", e.key());
}

Get a reference to the first value in the entry.

Values are stored in insertion order.

Panics

get panics if there are no values associated with the entry.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "hello.world".parse().unwrap());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    assert_eq!(e.get(), &"hello.world");

    e.append("hello.earth".parse().unwrap());

    assert_eq!(e.get(), &"hello.world");
}

Get a mutable reference to the first value in the entry.

Values are stored in insertion order.

Panics

get_mut panics if there are no values associated with the entry.

Examples

let mut map = HeaderMap::default();
map.insert(HOST, "hello.world".to_string());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    e.get_mut().push_str("-2");
    assert_eq!(e.get(), &"hello.world-2");
}

Converts the OccupiedEntry into a mutable reference to the first value.

The lifetime of the returned reference is bound to the original map.

Panics

into_mut panics if there are no values associated with the entry.

Examples

let mut map = HeaderMap::default();
map.insert(HOST, "hello.world".to_string());
map.append(HOST, "hello.earth".to_string());

if let Entry::Occupied(e) = map.entry("host").unwrap() {
    e.into_mut().push_str("-2");
}

assert_eq!("hello.world-2", map["host"]);

Sets the value of the entry.

All previous values associated with the entry are removed and the first one is returned. See insert_mult for an API that returns all values.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "hello.world".parse().unwrap());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    let mut prev = e.insert("earth".parse().unwrap());
    assert_eq!("hello.world", prev);
}

assert_eq!("earth", map["host"]);

Important traits for ValueDrain<'a, T>

Sets the value of the entry.

This function does the same as insert except it returns an iterator that yields all values previously associated with the key.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());
map.append(HOST, "world2".parse().unwrap());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    let mut prev = e.insert_mult("earth".parse().unwrap());
    assert_eq!("world", prev.next().unwrap());
    assert_eq!("world2", prev.next().unwrap());
    assert!(prev.next().is_none());
}

assert_eq!("earth", map["host"]);

Insert the value into the entry.

The new value is appended to the end of the entry's value list. All previous values associated with the entry are retained.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    e.append("earth".parse().unwrap());
}

let values = map.get_all("host");
let mut i = values.iter();
assert_eq!("world", *i.next().unwrap());
assert_eq!("earth", *i.next().unwrap());

Remove the entry from the map.

All values associated with the entry are removed and the first one is returned. See remove_entry_mult for an API that returns all values.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());

if let Entry::Occupied(e) = map.entry("host").unwrap() {
    let mut prev = e.remove();
    assert_eq!("world", prev);
}

assert!(!map.contains_key("host"));

Remove the entry from the map.

The key and all values associated with the entry are removed and the first one is returned. See remove_entry_mult for an API that returns all values.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());

if let Entry::Occupied(e) = map.entry("host").unwrap() {
    let (key, mut prev) = e.remove_entry();
    assert_eq!("host", key.as_str());
    assert_eq!("world", prev);
}

assert!(!map.contains_key("host"));

Remove the entry from the map.

The key and all values associated with the entry are removed and returned.

Important traits for ValueIter<'a, T>

Returns an iterator visiting all values associated with the entry.

Values are iterated in insertion order.

Examples

let mut map = HeaderMap::new();
map.insert(HOST, "world".parse().unwrap());
map.append(HOST, "earth".parse().unwrap());

if let Entry::Occupied(e) = map.entry("host").unwrap() {
    let mut iter = e.iter();
    assert_eq!(&"world", iter.next().unwrap());
    assert_eq!(&"earth", iter.next().unwrap());
    assert!(iter.next().is_none());
}

Important traits for ValueIterMut<'a, T>

Returns an iterator mutably visiting all values associated with the entry.

Values are iterated in insertion order.

Examples

let mut map = HeaderMap::default();
map.insert(HOST, "world".to_string());
map.append(HOST, "earth".to_string());

if let Entry::Occupied(mut e) = map.entry("host").unwrap() {
    for e in e.iter_mut() {
        e.push_str("-boop");
    }
}

let mut values = map.get_all("host");
let mut i = values.iter();
assert_eq!(&"world-boop", i.next().unwrap());
assert_eq!(&"earth-boop", i.next().unwrap());

Trait Implementations

impl<'a, T: Debug + 'a> Debug for OccupiedEntry<'a, T>
[src]

Formats the value using the given formatter. Read more

impl<'a, T> IntoIterator for OccupiedEntry<'a, T>
[src]

The type of the elements being iterated over.

Which kind of iterator are we turning this into?

Important traits for ValueIterMut<'a, T>

Creates an iterator from a value. Read more

impl<'a, 'b: 'a, T> IntoIterator for &'b OccupiedEntry<'a, T>
[src]

The type of the elements being iterated over.

Which kind of iterator are we turning this into?

Important traits for ValueIter<'a, T>

Creates an iterator from a value. Read more

impl<'a, 'b: 'a, T> IntoIterator for &'b mut OccupiedEntry<'a, T>
[src]

The type of the elements being iterated over.

Which kind of iterator are we turning this into?

Important traits for ValueIterMut<'a, T>

Creates an iterator from a value. Read more

Auto Trait Implementations

impl<'a, T> Send for OccupiedEntry<'a, T> where
    T: Send

impl<'a, T> Sync for OccupiedEntry<'a, T> where
    T: Sync