Struct SideTable 

pub struct SideTable<V: 'static> { /* private fields */ }

A pointer-keyed map swept automatically by crate::sidetable::sweep. Construct inside a thread_local! initializer; the optional teardown hook runs for each removed value (release a retained native object, dispose an owned child, …), both on sweep and on plain SideTable::remove, so teardown cannot be bypassed by accident.

Implementations

impl<V> SideTable<V>

pub fn new() -> Self

pub fn with_teardown(teardown: impl Fn(V) + 'static) -> Self

A table whose values need active teardown when their view goes away.

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

pub fn remove(&self, key: usize) -> Option<V>

Remove and tear down the entry (returns None always when a teardown hook exists, because the value is consumed by it; use SideTable::take to skip it).

pub fn take(&self, key: usize) -> Option<V>

Remove without running the teardown hook (the caller takes ownership).

pub fn contains(&self, key: usize) -> bool

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

where V: Clone,

pub fn with<R>(&self, key: usize, f: impl FnOnce(&mut V) -> R) -> Option<R>

Run f on the value in place (returns None if absent).

pub fn for_each(&self, f: impl FnMut(usize, &V))

Run f over every (key, value) (immutable; do not re-enter this table).

Trait Implementations

impl<V> Default for SideTable<V>

fn default() -> Self

Returns the “default value” for a type.