Struct IdBagU32

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

A collection of allocatable u32 integers.

Implementations

impl IdBagU32

pub fn new() -> Self

Create a new id bag containing u32 integers.

pub const fn with_inner(inner: Arc<Mutex<InnerBagU32>>) -> 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::IdBagU32;

let idbag1 = IdBagU32::new();
let idbag2 = IdBagU32::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<InnerBagU32>>

Return a clone of the internal id collection.

pub fn alloc(&self) -> IdU32

Allocate a new identifier.

use idbag::IdBagU32;

let idbag = IdBagU32::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: u32) -> Option<IdU32>

Allocate a specific id, if available.

use idbag::IdBagU32;

let idbag = IdBagU32::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 IdBagU32

fn default() -> IdBagU32

Returns the “default value” for a type.