pub struct UnionFind { /* private fields */ }
Expand description

A union-find data structure. The data structure can allocate Ids, indicating eclasses, and can merge eclasses together.

Implementations§

source§

impl UnionFind

source

pub fn new() -> Self

Create a new UnionFind.

source

pub fn with_capacity(cap: usize) -> Self

Create a new UnionFind with the given capacity.

source

pub fn add(&mut self, id: Id)

Add an Id to the UnionFind, with its own equivalence class initially. All Ids must be added before being queried or unioned.

source

pub fn find(&self, node: Id) -> Id

Find the canonical Id of a given Id.

source

pub fn find_and_update(&mut self, node: Id) -> Id

Find the canonical Id of a given Id, updating the data structure in the process so that future queries for this Id (and others in its chain up to the root of the equivalence class) will be faster.

source

pub fn union(&mut self, a: Id, b: Id)

Merge the equivalence classes of the two Ids.

source

pub fn equiv_id_mut(&mut self, a: Id, b: Id) -> bool

Determine if two Ids are equivalent, after canonicalizing. Update union-find data structure during our canonicalization to make future lookups faster.

source

pub fn hash_id_mut<H: Hasher>(&mut self, hash: &mut H, id: Id)

Hash an Id after canonicalizing it. Update union-find data structure to make future lookups/hashing faster.

Trait Implementations§

source§

impl Clone for UnionFind

source§

fn clone(&self) -> UnionFind

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for UnionFind

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

const: unstable · source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

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

const: unstable · 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 Twhere T: Clone,

§

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 Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
const: unstable · source§

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

Performs the conversion.