Struct IdBagUsize

pub struct IdBagUsize(/* private fields */);

A collection of allocatable usize integers.

Implementations

impl IdBagUsize

pub fn new() -> Self

Create a new id bag containing usize integers.

pub const fn with_inner(inner: Arc<Mutex<InnerBagUsize>>) -> Self

Create a new id generator using a pre-existing set.

This is useful when multiple IdBag instances should share the same inner context. The practical implication of this is that the IdBag’s that share the same inner context will not yield overlapping identifier values.

use idbag::IdBagUsize;

let idbag1 = IdBagUsize::new();
let idbag2 = IdBagUsize::with_inner(idbag1.clone_inner());

let id1 = idbag1.alloc();
assert_eq!(id1.val(), 1);

let id2 = idbag2.alloc();
assert_eq!(id2.val(), 2);

pub fn clone_inner(&self) -> Arc<Mutex<InnerBagUsize>>

Return a clone of the internal id collection.

pub fn alloc(&self) -> IdUsize

Allocate a new identifier.

use idbag::IdBagUsize;

let idbag = IdBagUsize::new();

let id = idbag.alloc();
assert_eq!(id.val(), 1);

let id = idbag.alloc();
assert_eq!(id.val(), 2);

Desgin flaws

This function will hang if all the id’s have been exhausted.

pub fn alloc_id(&self, id: usize) -> Option<IdUsize>

Allocate a specific id, if available.

use idbag::IdBagUsize;

let idbag = IdBagUsize::new();

let Some(id) = idbag.alloc_id(42) else {
  panic!("Unexpectedly unable to allocate id 42");
};
assert_eq!(id.val(), 42);

let id = idbag.alloc_id(42);
assert_eq!(id, None);

Trait Implementations

impl Default for IdBagUsize

fn default() -> IdBagUsize

Returns the “default value” for a type.