pub struct RacyLock<T, F = fn() -> T> { /* private fields */ }Expand description
Thread-safe, non-blocking, lazily evaluated lock with the same interface
as std::sync::LazyLock.
Concurrent threads will race to set the value atomically, and memory allocated by losing threads will be dropped immediately after they fail to set the pointer.
The underlying implementation is based on once_cell::race::OnceBox which relies on
core::sync::atomic::AtomicPtr to ensure that the data race results in a single successful
write to the relevant pointer, namely the first write.
See https://github.com/matklad/once_cell/blob/v1.19.0/src/race.rs#L294.
Performs lazy evaluation and can be used for statics.
Implementations§
Source§impl<T, F> RacyLock<T, F>where
F: Fn() -> T,
impl<T, F> RacyLock<T, F>where
F: Fn() -> T,
Sourcepub const fn new(f: F) -> RacyLock<T, F>
pub const fn new(f: F) -> RacyLock<T, F>
Creates a new lazy, racy value with the given initializing function.
Sourcepub fn force(this: &RacyLock<T, F>) -> &T
pub fn force(this: &RacyLock<T, F>) -> &T
Forces the evaluation of the locked value and returns a reference to
the result. This is equivalent to the Self::deref.
There is no blocking involved in this operation. Instead, concurrent threads will race to set the underlying pointer. Memory allocated by losing threads will be dropped immediately after they fail to set the pointer.
This function’s interface is designed around std::sync::LazyLock::force but
the implementation is derived from once_cell::race::OnceBox::get_or_try_init.
Trait Implementations§
impl<T, F> Send for RacyLock<T, F>
impl<T, F> Sync for RacyLock<T, F>
Auto Trait Implementations§
impl<T, F = fn() -> T> !Freeze for RacyLock<T, F>
impl<T, F> RefUnwindSafe for RacyLock<T, F>where
F: RefUnwindSafe,
impl<T, F> Unpin for RacyLock<T, F>where
F: Unpin,
impl<T, F> UnwindSafe for RacyLock<T, F>where
F: UnwindSafe,
T: RefUnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<D> OwoColorize for D
impl<D> OwoColorize for D
Source§fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>where
C: Color,
fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>where
C: Color,
Set the foreground color generically Read more
Source§fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>where
C: Color,
fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>where
C: Color,
Set the background color generically. Read more
Source§fn black(&self) -> FgColorDisplay<'_, Black, Self>
fn black(&self) -> FgColorDisplay<'_, Black, Self>
Change the foreground color to black
Source§fn on_black(&self) -> BgColorDisplay<'_, Black, Self>
fn on_black(&self) -> BgColorDisplay<'_, Black, Self>
Change the background color to black
Source§fn red(&self) -> FgColorDisplay<'_, Red, Self>
fn red(&self) -> FgColorDisplay<'_, Red, Self>
Change the foreground color to red
Source§fn on_red(&self) -> BgColorDisplay<'_, Red, Self>
fn on_red(&self) -> BgColorDisplay<'_, Red, Self>
Change the background color to red
Source§fn green(&self) -> FgColorDisplay<'_, Green, Self>
fn green(&self) -> FgColorDisplay<'_, Green, Self>
Change the foreground color to green
Source§fn on_green(&self) -> BgColorDisplay<'_, Green, Self>
fn on_green(&self) -> BgColorDisplay<'_, Green, Self>
Change the background color to green
Source§fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>
fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>
Change the foreground color to yellow
Source§fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>
fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>
Change the background color to yellow
Source§fn blue(&self) -> FgColorDisplay<'_, Blue, Self>
fn blue(&self) -> FgColorDisplay<'_, Blue, Self>
Change the foreground color to blue
Source§fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>
fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>
Change the background color to blue
Source§fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>
fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>
Change the foreground color to magenta
Source§fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>
fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>
Change the background color to magenta
Source§fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>
fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>
Change the foreground color to purple
Source§fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>
fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>
Change the background color to purple
Source§fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>
fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>
Change the foreground color to cyan
Source§fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>
fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>
Change the background color to cyan
Source§fn white(&self) -> FgColorDisplay<'_, White, Self>
fn white(&self) -> FgColorDisplay<'_, White, Self>
Change the foreground color to white
Source§fn on_white(&self) -> BgColorDisplay<'_, White, Self>
fn on_white(&self) -> BgColorDisplay<'_, White, Self>
Change the background color to white
Source§fn default_color(&self) -> FgColorDisplay<'_, Default, Self>
fn default_color(&self) -> FgColorDisplay<'_, Default, Self>
Change the foreground color to the terminal default
Source§fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>
fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>
Change the background color to the terminal default
Source§fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>
fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>
Change the foreground color to bright black
Source§fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>
fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>
Change the background color to bright black
Source§fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>
fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>
Change the foreground color to bright red
Source§fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>
fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>
Change the background color to bright red
Source§fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>
fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>
Change the foreground color to bright green
Source§fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>
fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>
Change the background color to bright green
Source§fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>
fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>
Change the foreground color to bright yellow
Source§fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>
fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>
Change the background color to bright yellow
Source§fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>
fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>
Change the foreground color to bright blue
Source§fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>
fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>
Change the background color to bright blue
Source§fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
Change the foreground color to bright magenta
Source§fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
Change the background color to bright magenta
Source§fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
Change the foreground color to bright purple
Source§fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
Change the background color to bright purple
Source§fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>
fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>
Change the foreground color to bright cyan
Source§fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>
fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>
Change the background color to bright cyan
Source§fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>
fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>
Change the foreground color to bright white
Source§fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>
fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>
Change the background color to bright white
Source§fn bold(&self) -> BoldDisplay<'_, Self>
fn bold(&self) -> BoldDisplay<'_, Self>
Make the text bold
Source§fn dimmed(&self) -> DimDisplay<'_, Self>
fn dimmed(&self) -> DimDisplay<'_, Self>
Make the text dim
Source§fn italic(&self) -> ItalicDisplay<'_, Self>
fn italic(&self) -> ItalicDisplay<'_, Self>
Make the text italicized
Source§fn underline(&self) -> UnderlineDisplay<'_, Self>
fn underline(&self) -> UnderlineDisplay<'_, Self>
Make the text underlined
Source§fn blink(&self) -> BlinkDisplay<'_, Self>
fn blink(&self) -> BlinkDisplay<'_, Self>
Make the text blink
Source§fn blink_fast(&self) -> BlinkFastDisplay<'_, Self>
fn blink_fast(&self) -> BlinkFastDisplay<'_, Self>
Make the text blink (but fast!)
Source§fn reversed(&self) -> ReversedDisplay<'_, Self>
fn reversed(&self) -> ReversedDisplay<'_, Self>
Swap the foreground and background colors
Hide the text
Source§fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>
fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>
Cross out the text
Source§fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
Set the foreground color at runtime. Only use if you do not know which color will be used at
compile-time. If the color is constant, use either
OwoColorize::fg or
a color-specific method, such as OwoColorize::green, Read moreSource§fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
Set the background color at runtime. Only use if you do not know what color to use at
compile-time. If the color is constant, use either
OwoColorize::bg or
a color-specific method, such as OwoColorize::on_yellow, Read moreSource§fn fg_rgb<const R: u8, const G: u8, const B: u8>(
&self,
) -> FgColorDisplay<'_, CustomColor<R, G, B>, Self>
fn fg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> FgColorDisplay<'_, CustomColor<R, G, B>, Self>
Set the foreground color to a specific RGB value.
Source§fn bg_rgb<const R: u8, const G: u8, const B: u8>(
&self,
) -> BgColorDisplay<'_, CustomColor<R, G, B>, Self>
fn bg_rgb<const R: u8, const G: u8, const B: u8>( &self, ) -> BgColorDisplay<'_, CustomColor<R, G, B>, Self>
Set the background color to a specific RGB value.
Source§fn truecolor(&self, r: u8, g: u8, b: u8) -> FgDynColorDisplay<'_, Rgb, Self>
fn truecolor(&self, r: u8, g: u8, b: u8) -> FgDynColorDisplay<'_, Rgb, Self>
Sets the foreground color to an RGB value.
Source§fn on_truecolor(&self, r: u8, g: u8, b: u8) -> BgDynColorDisplay<'_, Rgb, Self>
fn on_truecolor(&self, r: u8, g: u8, b: u8) -> BgDynColorDisplay<'_, Rgb, Self>
Sets the background color to an RGB value.
Source§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<P, T> SmtStorage for P
impl<P, T> SmtStorage for P
Source§fn get_root(&self) -> Result<Option<Word>, StorageError>
fn get_root(&self) -> Result<Option<Word>, StorageError>
Retrieves the current root hash of the Sparse Merkle Tree.
Returns
Ok(None) if no root has been set or an empty SMT is represented. Read moreSource§fn set_root(&self, root: Word) -> Result<(), StorageError>
fn set_root(&self, root: Word) -> Result<(), StorageError>
Sets or updates the root hash of the Sparse Merkle Tree. Read more
Source§fn leaf_count(&self) -> Result<usize, StorageError>
fn leaf_count(&self) -> Result<usize, StorageError>
Retrieves the total number of leaf nodes currently stored. Read more
Source§fn entry_count(&self) -> Result<usize, StorageError>
fn entry_count(&self) -> Result<usize, StorageError>
Retrieves the total number of unique key-value entries across all leaf nodes. Read more
Source§fn insert_value(
&self,
index: u64,
key: Word,
value: Word,
) -> Result<Option<Word>, StorageError>
fn insert_value( &self, index: u64, key: Word, value: Word, ) -> Result<Option<Word>, StorageError>
Inserts a key-value pair into the SMT leaf at the specified logical
index. Read moreSource§fn remove_value(
&self,
index: u64,
key: Word,
) -> Result<Option<Word>, StorageError>
fn remove_value( &self, index: u64, key: Word, ) -> Result<Option<Word>, StorageError>
Removes a key-value pair from the SMT leaf at the specified logical
index. Read moreSource§fn get_leaf(&self, index: u64) -> Result<Option<SmtLeaf>, StorageError>
fn get_leaf(&self, index: u64) -> Result<Option<SmtLeaf>, StorageError>
Retrieves a single SMT leaf node by its logical
index.
Returns Ok(None) if no leaf exists at the given index.Source§fn set_leaves(&self, leaves: BTreeMap<u64, SmtLeaf>) -> Result<(), StorageError>
fn set_leaves(&self, leaves: BTreeMap<u64, SmtLeaf>) -> Result<(), StorageError>
Sets or updates multiple SMT leaf nodes in storage. Read more
Source§fn remove_leaf(&self, index: u64) -> Result<Option<SmtLeaf>, StorageError>
fn remove_leaf(&self, index: u64) -> Result<Option<SmtLeaf>, StorageError>
Removes a single SMT leaf node entirely from storage by its logical
index. Read moreSource§fn get_leaves(
&self,
indices: &[u64],
) -> Result<Vec<Option<SmtLeaf>>, StorageError>
fn get_leaves( &self, indices: &[u64], ) -> Result<Vec<Option<SmtLeaf>>, StorageError>
Retrieves multiple SMT leaf nodes by their logical
indices. Read moreSource§fn has_leaves(&self) -> Result<bool, StorageError>
fn has_leaves(&self) -> Result<bool, StorageError>
Returns true if the storage has any leaves. Read more
Source§fn get_subtree(&self, index: NodeIndex) -> Result<Option<Subtree>, StorageError>
fn get_subtree(&self, index: NodeIndex) -> Result<Option<Subtree>, StorageError>
Retrieves a single SMT Subtree by its root
NodeIndex. Read moreSource§fn get_subtrees(
&self,
indices: &[NodeIndex],
) -> Result<Vec<Option<Subtree>>, StorageError>
fn get_subtrees( &self, indices: &[NodeIndex], ) -> Result<Vec<Option<Subtree>>, StorageError>
Retrieves multiple Subtrees by their root
NodeIndex values. Read moreSource§fn set_subtree(&self, subtree: &Subtree) -> Result<(), StorageError>
fn set_subtree(&self, subtree: &Subtree) -> Result<(), StorageError>
Sets or updates a single SMT Subtree in storage, identified by its root
NodeIndex. Read moreSource§fn set_subtrees(&self, subtrees: Vec<Subtree>) -> Result<(), StorageError>
fn set_subtrees(&self, subtrees: Vec<Subtree>) -> Result<(), StorageError>
Sets or updates multiple SMT Subtrees in storage. Read more
Source§fn remove_subtree(&self, index: NodeIndex) -> Result<(), StorageError>
fn remove_subtree(&self, index: NodeIndex) -> Result<(), StorageError>
Removes a single SMT Subtree from storage, identified by its root
NodeIndex. Read moreSource§fn get_inner_node(
&self,
index: NodeIndex,
) -> Result<Option<InnerNode>, StorageError>
fn get_inner_node( &self, index: NodeIndex, ) -> Result<Option<InnerNode>, StorageError>
Retrieves a single inner node from within a Subtree. Read more
Source§fn set_inner_node(
&self,
index: NodeIndex,
node: InnerNode,
) -> Result<Option<InnerNode>, StorageError>
fn set_inner_node( &self, index: NodeIndex, node: InnerNode, ) -> Result<Option<InnerNode>, StorageError>
Sets or updates a single inner node (non-leaf node) within a Subtree. Read more
Source§fn remove_inner_node(
&self,
index: NodeIndex,
) -> Result<Option<InnerNode>, StorageError>
fn remove_inner_node( &self, index: NodeIndex, ) -> Result<Option<InnerNode>, StorageError>
Removes a single inner node (non-leaf node) from within a Subtree. Read more
Source§fn apply(&self, updates: StorageUpdates) -> Result<(), StorageError>
fn apply(&self, updates: StorageUpdates) -> Result<(), StorageError>
Applies a batch of
StorageUpdates atomically to the storage backend. Read moreSource§fn iter_leaves(
&self,
) -> Result<Box<dyn Iterator<Item = (u64, SmtLeaf)> + '_>, StorageError>
fn iter_leaves( &self, ) -> Result<Box<dyn Iterator<Item = (u64, SmtLeaf)> + '_>, StorageError>
Returns an iterator over all (logical_index, SmtLeaf) pairs currently in storage. Read more