Struct crdts::pncounter::PNCounter

pub struct PNCounter<A: Ord + Clone + Encodable + Decodable> {
    // some fields omitted
}

PNCounter allows the counter to be both incremented and decremented by representing the increments (P) and the decrements (N) in separate internal G-Counters.

Merge is implemented by merging the internal P and N counters. The value of the counter is P minus N.

Examples

use crdts::PNCounter;
let mut a = PNCounter::new();
a.increment("A".to_string());
a.increment("A".to_string());
a.decrement("A".to_string());
a.increment("A".to_string());
assert_eq!(a.value(), 2);

Methods

impl<A: Ord + Clone + Encodable + Decodable> PNCounter<A>

fn new() -> PNCounter<A>

Produces a new PNCounter.

fn increment(&mut self, actor: A)

Increments a particular actor's counter.

fn decrement(&mut self, actor: A)

Decrements a particular actor's counter.

fn value(&self) -> i64

Returns the current value of this counter (P-N).

fn merge(&mut self, other: PNCounter<A>)

Merge another pncounter into this one, without regard to dominance.

Examples

use crdts::PNCounter;
let (mut a, mut b, mut c) = (PNCounter::new(), PNCounter::new(), PNCounter::new());
a.increment("A".to_string());
b.increment("B".to_string());
b.increment("B".to_string());
b.decrement("A".to_string());
c.increment("B".to_string());
c.increment("B".to_string());
a.merge(b);
assert_eq!(a, c);

Trait Implementations

impl<A: Ord + Clone + Encodable + Decodable> Ord for PNCounter<A>

fn cmp(&self, other: &PNCounter<A>) -> Ordering

This method returns an Ordering between self and other.

impl<A: Ord + Clone + Encodable + Decodable> PartialOrd for PNCounter<A>

fn partial_cmp(&self, other: &PNCounter<A>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<A: Ord + Clone + Encodable + Decodable> PartialEq for PNCounter<A>

fn eq(&self, other: &PNCounter<A>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

Derived Implementations

impl<A: Decodable + Ord + Clone + Encodable + Decodable> Decodable for PNCounter<A>

fn decode<__DA: Decoder>(__arg_0: &mut __DA) -> Result<PNCounter<A>, __DA::Error>

impl<A: Encodable + Ord + Clone + Encodable + Decodable> Encodable for PNCounter<A>

fn encode<__SA: Encoder>(&self, __arg_0: &mut __SA) -> Result<(), __SA::Error>

impl<A: Hash + Ord + Clone + Encodable + Decodable> Hash for PNCounter<A>

fn hash<__HA: Hasher>(&self, __arg_0: &mut __HA)

Feeds this value into the state given, updating the hasher as necessary.

fn hash_slice<H>(data: &[Self], state: &mut H) where H: Hasher

Feeds a slice of this type into the state provided.

impl<A: Clone + Ord + Clone + Encodable + Decodable> Clone for PNCounter<A>

fn clone(&self) -> PNCounter<A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Eq + Ord + Clone + Encodable + Decodable> Eq for PNCounter<A>

impl<A: Debug + Ord + Clone + Encodable + Decodable> Debug for PNCounter<A>

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.