Struct awaitable_bool::AwaitableBool

pub struct AwaitableBool { /* private fields */ }

A bool whose value changes can be waited on.

Internally, it uses AtomicBool and tokio::sync::Notify.

Because of that, most methods only need a shared reference (& as opposed to &mut) to self, so sharing between tasks or threads should be cheap and easy. This struct doesn’t implement Clone, so place it in an Arc (no lock protecting it needed) if cloning is needed.

Implementations

impl AwaitableBool

pub fn new<IntoAtomicBool: Into<AtomicBool>>(value: IntoAtomicBool) -> Self

Creates a new AwaitableBool.

Examples

use awaitable_bool::AwaitableBool;

let awaitable_true = AwaitableBool::new(true);
let awaitable_false = AwaitableBool::new(false);

pub fn set_true(&self)

Set the AwaitableBool to true (with Release ordering if not already true and Acquire ordering if it is).

This wakes all tasks waiting for [wait_true]. It also wakes those waiting for [wait] if the value wasn’t already true.

pub fn set_false(&self)

Set the AwaitableBool to false (with Release ordering if not already false and Acquire ordering if it is).

This wakes all tasks waiting for [wait_false]. It also wakes those waiting for [wait] if the value wasn’t already false.

pub fn toggle(&self)

Set the AwaitableBool to the inverse of its current value (i.e. false if true or true if false) (with AcqRel ordering).

This wakes all tasks waiting for [wait]. It also wakes those waiting for [wait_true] if the value was just changed from false to true, or those waiting for [wait_false] if the value was just changed from true to false.

pub fn is_true(&self) -> bool

Check if the AwaitableBool’s value is currently true (with Acquire ordering).

pub fn is_false(&self) -> bool

Check if the AwaitableBool’s value is currently false (with Acquire ordering).

pub async fn wait(&self)

Wait for this AwaitableBool’s value to change.

Use [load] after to know what it changed to.

pub async fn wait_true(&self)

Wait for this AwaitableBool’s value to become true.

pub async fn wait_false(&self)

Wait for this AwaitableBool’s value to become false.

pub fn into_inner(self) -> AtomicBool

Consume this AwaitableBool to get the contained AtomicBool.

AtomicBool also has an into_inner method to get its contained bool.

Trait Implementations

impl Debug for AwaitableBool

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

Formats the value using the given formatter.

impl Default for AwaitableBool

fn default() -> AwaitableBool

Returns the “default value” for a type.

impl<T: Into<AtomicBool>> From<T> for AwaitableBool

fn from(value: T) -> Self

Converts to this type from the input type.