Struct reqwest::header::OccupiedEntry
source · [−]pub struct OccupiedEntry<'a, T> { /* private fields */ }
Expand description
A view into a single occupied location in a HeaderMap
.
This struct is returned as part of the Entry
enum.
Implementations
sourceimpl<'a, T> OccupiedEntry<'a, T>
impl<'a, T> OccupiedEntry<'a, T>
sourcepub fn key(&self) -> &HeaderName
pub fn key(&self) -> &HeaderName
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") {
assert_eq!("host", e.key());
}
sourcepub fn get(&self) -> &T
pub fn get(&self) -> &T
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") {
assert_eq!(e.get(), &"hello.world");
e.append("hello.earth".parse().unwrap());
assert_eq!(e.get(), &"hello.world");
}
sourcepub fn get_mut(&mut self) -> &mut T
pub fn get_mut(&mut self) -> &mut T
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") {
e.get_mut().push_str("-2");
assert_eq!(e.get(), &"hello.world-2");
}
sourcepub fn into_mut(self) -> &'a mut T
pub fn into_mut(self) -> &'a mut T
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") {
e.into_mut().push_str("-2");
}
assert_eq!("hello.world-2", map["host"]);
sourcepub fn insert(&mut self, value: T) -> T
pub fn insert(&mut self, value: T) -> T
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") {
let mut prev = e.insert("earth".parse().unwrap());
assert_eq!("hello.world", prev);
}
assert_eq!("earth", map["host"]);
sourcepub fn insert_mult(&mut self, value: T) -> ValueDrain<'_, T>ⓘNotable traits for ValueDrain<'a, T>impl<'a, T> Iterator for ValueDrain<'a, T> type Item = T;
pub fn insert_mult(&mut self, value: T) -> ValueDrain<'_, T>ⓘNotable traits for ValueDrain<'a, T>impl<'a, T> Iterator for ValueDrain<'a, T> type Item = 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") {
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"]);
sourcepub fn append(&mut self, value: T)
pub fn append(&mut self, value: T)
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") {
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());
sourcepub fn remove(self) -> T
pub fn remove(self) -> T
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") {
let mut prev = e.remove();
assert_eq!("world", prev);
}
assert!(!map.contains_key("host"));
sourcepub fn remove_entry(self) -> (HeaderName, T)
pub fn remove_entry(self) -> (HeaderName, T)
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") {
let (key, mut prev) = e.remove_entry();
assert_eq!("host", key.as_str());
assert_eq!("world", prev);
}
assert!(!map.contains_key("host"));
sourcepub fn remove_entry_mult(self) -> (HeaderName, ValueDrain<'a, T>)
pub fn remove_entry_mult(self) -> (HeaderName, ValueDrain<'a, T>)
Remove the entry from the map.
The key and all values associated with the entry are removed and returned.
sourcepub fn iter(&self) -> ValueIter<'_, T>ⓘNotable traits for ValueIter<'a, T>impl<'a, T> Iterator for ValueIter<'a, T> where
T: 'a, type Item = &'a T;
pub fn iter(&self) -> ValueIter<'_, T>ⓘNotable traits for ValueIter<'a, T>impl<'a, T> Iterator for ValueIter<'a, T> where
T: 'a, type Item = &'a T;
T: 'a, type Item = &'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") {
let mut iter = e.iter();
assert_eq!(&"world", iter.next().unwrap());
assert_eq!(&"earth", iter.next().unwrap());
assert!(iter.next().is_none());
}
sourcepub fn iter_mut(&mut self) -> ValueIterMut<'_, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
pub fn iter_mut(&mut self) -> ValueIterMut<'_, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
T: 'a, type Item = &'a mut 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") {
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
sourceimpl<'a, T> Debug for OccupiedEntry<'a, T> where
T: Debug,
impl<'a, T> Debug for OccupiedEntry<'a, T> where
T: Debug,
sourceimpl<'a, T> IntoIterator for OccupiedEntry<'a, T>
impl<'a, T> IntoIterator for OccupiedEntry<'a, T>
type IntoIter = ValueIterMut<'a, T>
type IntoIter = ValueIterMut<'a, T>
Which kind of iterator are we turning this into?
sourcefn into_iter(self) -> ValueIterMut<'a, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
fn into_iter(self) -> ValueIterMut<'a, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
T: 'a, type Item = &'a mut T;
Creates an iterator from a value. Read more
sourceimpl<'a, 'b, T> IntoIterator for &'b mut OccupiedEntry<'a, T> where
'b: 'a,
impl<'a, 'b, T> IntoIterator for &'b mut OccupiedEntry<'a, T> where
'b: 'a,
type IntoIter = ValueIterMut<'a, T>
type IntoIter = ValueIterMut<'a, T>
Which kind of iterator are we turning this into?
sourcefn into_iter(self) -> ValueIterMut<'a, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
fn into_iter(self) -> ValueIterMut<'a, T>ⓘNotable traits for ValueIterMut<'a, T>impl<'a, T> Iterator for ValueIterMut<'a, T> where
T: 'a, type Item = &'a mut T;
T: 'a, type Item = &'a mut T;
Creates an iterator from a value. Read more
sourceimpl<'a, 'b, T> IntoIterator for &'b OccupiedEntry<'a, T> where
'b: 'a,
impl<'a, 'b, T> IntoIterator for &'b OccupiedEntry<'a, T> where
'b: 'a,
Auto Trait Implementations
impl<'a, T> RefUnwindSafe for OccupiedEntry<'a, T> where
T: RefUnwindSafe,
impl<'a, T> Send for OccupiedEntry<'a, T> where
T: Send,
impl<'a, T> Sync for OccupiedEntry<'a, T> where
T: Sync,
impl<'a, T> Unpin for OccupiedEntry<'a, T>
impl<'a, T> !UnwindSafe for OccupiedEntry<'a, T>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more