Struct IdBagU64

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

A collection of allocatable u64 integers.

Implementations

impl IdBagU64

pub fn new() -> Self

Create a new id bag containing u64 integers.

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

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

Return a clone of the internal id collection.

pub fn alloc(&self) -> IdU64

Allocate a new identifier.

use idbag::IdBagU64;

let idbag = IdBagU64::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: u64) -> Option<IdU64>

Allocate a specific id, if available.

use idbag::IdBagU64;

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

fn default() -> IdBagU64

Returns the “default value” for a type.