Skip to main content

OwnedMap

Struct OwnedMap 

Source
pub struct OwnedMap<K, V> { /* private fields */ }
Expand description

An ordinary mutable ordered map with exact node ownership. Unlike BudgetedMap, insertion has no allowance and cannot be used as an admitted producer by itself. An enclosing controlled producer must reserve entry_bytes() before allocating each new entry and retain that lease until the map is dropped. Separately allocated key/value payloads require their own reservations.

Implementations§

Source§

impl<K, V> OwnedMap<K, V>

Source

pub fn new() -> Self

Source

pub const fn entry_bytes() -> usize

Exact allocation layout of one node, including its key, value, links and padding. Allocator bookkeeping is outside the payload allowance.

Source

pub fn allocated_bytes(&self) -> usize

Source

pub fn len(&self) -> usize

Source

pub fn is_empty(&self) -> bool

Source

pub fn iter(&self) -> BudgetedMapIter<'_, K, V> ⓘ

Source

pub fn keys(&self) -> impl ExactSizeIterator<Item = &K> + FusedIterator

Source

pub fn values(&self) -> impl ExactSizeIterator<Item = &V> + FusedIterator

Source§

impl<K: Ord, V> OwnedMap<K, V>

Source

pub fn get<Q: Ord + ?Sized>(&self, key: &Q) -> Option<&V>
where K: Borrow<Q>,

Source

pub fn get_mut<Q: Ord + ?Sized>(&mut self, key: &Q) -> Option<&mut V>
where K: Borrow<Q>,

Source

pub fn contains_key<Q: Ord + ?Sized>(&self, key: &Q) -> bool
where K: Borrow<Q>,

Source

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

A collision replaces only the value, preserving the original key and node allocation.

Source

pub fn append(&mut self, other: Self)

Move entries from other without allocating replacement nodes. Collisions retain this map’s original key and node, replacing only the value.

Source

pub fn remove<Q: Ord + ?Sized>(&mut self, key: &Q) -> Option<V>
where K: Borrow<Q>,

Source

pub fn remove_entry<Q: Ord + ?Sized>(&mut self, key: &Q) -> Option<(K, V)>
where K: Borrow<Q>,

Source

pub fn first_from<Q: Ord + ?Sized>(&self, start: Bound<&Q>) -> Option<(&K, &V)>
where K: Borrow<Q>,

Borrow the first entry at or after a lower bound in logarithmic time without scratch allocation.

Trait Implementations§

Source§

impl<K: Ord + Clone, V: Clone> Clone for OwnedMap<K, V>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<K: Debug, V: Debug> Debug for OwnedMap<K, V>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<K, V> Default for OwnedMap<K, V>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<K: Eq, V: Eq> Eq for OwnedMap<K, V>

Source§

impl<K: Ord, V> FromIterator<(K, V)> for OwnedMap<K, V>

Source§

fn from_iter<T: IntoIterator<Item = (K, V)>>(iter: T) -> Self

Creates a value from an iterator. Read more
Source§

impl<K: Ord + Borrow<Q>, V, Q: Ord + ?Sized> Index<&Q> for OwnedMap<K, V>

Source§

type Output = V

The returned type after indexing.
Source§

fn index(&self, key: &Q) -> &V

Performs the indexing (container[index]) operation. Read more
Source§

impl<'a, K, V> IntoIterator for &'a OwnedMap<K, V>

Source§

type Item = (&'a K, &'a V)

The type of the elements being iterated over.
Source§

type IntoIter = BudgetedMapIter<'a, K, V>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl<K, V> IntoIterator for OwnedMap<K, V>

Source§

type Item = (K, V)

The type of the elements being iterated over.
Source§

type IntoIter = OwnedMapIntoIter<K, V>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl<K: PartialEq, V: PartialEq> PartialEq for OwnedMap<K, V>

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

§

impl<K, V> Freeze for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: Freeze,

§

impl<K, V> RefUnwindSafe for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: RefUnwindSafe,

§

impl<K, V> Send for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: Send,

§

impl<K, V> Sync for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: Sync,

§

impl<K, V> Unpin for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: Unpin,

§

impl<K, V> UnsafeUnpin for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: UnsafeUnpin,

§

impl<K, V> UnwindSafe for OwnedMap<K, V>
where Option<OwnedNode<K, V>>: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.