Struct treediff::tools::Merger

pub struct Merger<K, V, BF, F> { /* fields omitted */ }

A Delegate which applies differences to a target object.

It wraps the target object and applies all calls by the diff algorithm to it, which changes it in some way.

Custom resolver functions can be provided to arbitrarily alter the way the merge is performed. This allows you, for example, to keep your own meta-data, or to implement custom conflict resolutions.

Examples

Please see the tests for usage examples.

Implementations

impl<K, V, BF, F> Merger<K, V, BF, F>

pub fn into_inner(self) -> V

Consume the merger and return the contained target Value, which is the result of the merge operation.

pub fn filter_mut(&mut self) -> &mut BF

Returns a mutable borrow to the MutableFilter instance

pub fn filter(&self) -> &BF

Returns a borrow to the MutableFilter instance

impl<'a, V, BF, F> Merger<V::Key, V, BF, F> where
    V: Mutable + 'a + Clone,
    F: MutableFilter,
    BF: BorrowMut<F>, 

pub fn with_filter(v: V, f: BF) -> Self

Return a new Merger with the given initial value v and the filter f

Trait Implementations

impl<K, V, BF, F> AsRef<V> for Merger<K, V, BF, F>

fn as_ref(&self) -> &V

Performs the conversion.

impl<'a, K, V, F, BF> Delegate<'a, K, V> for Merger<K, V, BF, F> where
    V: Mutable<Key = K, Item = V> + Clone + 'a,
    K: Clone + Display,
    F: MutableFilter,
    BF: BorrowMut<F>, 

fn push(&mut self, k: &K)

… we recurse into the Value at the given Key.

fn pop(&mut self)

… we have processed all items and leave the object previously pushed.

fn removed<'b>(&mut self, k: &'b K, v: &'a V)

… the Value v at the given Key k should be removed.

fn added<'b>(&mut self, k: &'b K, v: &'a V)

.. the Value v at the given Key k should be added.

fn unchanged<'b>(&mut self, v: &'a V)

The Value v was not changed.

fn modified<'b>(&mut self, old: &'a V, new: &'a V)

… the old Value was modified, and is now the new Value.

impl<'a, V> From<V> for Merger<V::Key, V, DefaultMutableFilter, DefaultMutableFilter> where
    V: Mutable + 'a + Clone, 

fn from(v: V) -> Self

Return a new merger with the given initial value v, and the DefaultMutableFilter.