Struct async_change_tracker::ChangeTracker

pub struct ChangeTracker<T> { /* private fields */ }

Tracks changes to data. Notifies listeners via a futures::Stream.

The data to be tracked is type T. The value of type T is wrapped in a private field. The AsRef trait is implemented so &T can be obtained by calling as_ref(). Read and write access can be gained by calling the modify method.

Subsribe to changes by calling get_changes.

See the module-level documentation for more information and a usage example.

Implementations

impl<T> ChangeTracker<T>

where T: Clone,

pub fn new(value: T) -> Self

Create a new ChangeTracker which takes ownership of the data of type T.

pub fn get_changes(&self, capacity: usize) -> Receiver<(T, T)>

Returns a futures::Stream that emits a message when a change occurs

The capacity of the underlying channel is specified with the capacity argument.

To remove a listener, drop the Receiver.

pub fn modify<F>(&mut self, f: F)

where F: FnOnce(&mut T),

Modify the data value, notifying listeners upon change.

Trait Implementations

impl<T> AsRef<T> for ChangeTracker<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Clone for ChangeTracker<T>

where T: Clone,

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.