Trait Merge

pub trait Merge: Sized {
    // Required method
    fn merge_ref(&mut self, other: Self) -> Result<(), Error>;

    // Provided method
    fn merge(self, other: Self) -> Result<Self, Error> { ... }
}

A value that may be merged.

This trait defines the interface by which 2 values are merged together.

There are 2 ways to merge values together only differing in whether they take ownership of the value.

• Merge::merge
• Merge::merge_ref

Both of these methods must perform merging in the same way. Any deviation in the 2 implementations is considered undefined behavior and will lead to bugs.

Merge::merge is provided by default as long as you provide the implementation for Merge::merge_ref. Generally there should be no reason to have to implement both of the above.

Required Methods

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

Merge self with other without taking ownership of self.

Example

let mut a = vec![1, 3, 4];
let b = vec![7, 2, 0];

a.merge_ref(b).unwrap();

assert_eq!(a, &[1, 3, 4, 7, 2, 0]);

Provided Methods

fn merge(self, other: Self) -> Result<Self, Error>

Merge self with other.

Example

let a = vec![1, 3, 4];
let b = vec![7, 2, 0];

let c = a.merge(b).unwrap();

assert_eq!(c, &[1, 3, 4, 7, 2, 0]);

Implementation

The default implementation of this method calls out to Merge::merge_ref. Don’t implemenent this unless you can do something better.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Merge for &str

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for &[u8]

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for IpAddr

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for SocketAddr

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for bool

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for char

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for f32

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for f64

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for i8

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for i16

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for i32

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for i64

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for isize

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for u8

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for u16

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for u32

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for u64

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for ()

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, (): Self) -> Result<(), Error>

impl Merge for usize

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Box<str>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Box<CStr>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Box<OsStr>

Available on crate feature std only.

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Box<Path>

Available on crate feature std only.

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for CString

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for String

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Ipv4Addr

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Ipv6Addr

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for SocketAddrV4

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for SocketAddrV6

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<i8>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<i16>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<i32>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<i64>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<isize>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<u8>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<u16>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<u32>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<u64>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Saturating<usize>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<i8>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<i16>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<i32>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<i64>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<isize>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<u8>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<u16>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<u32>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<u64>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Wrapping<usize>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for Duration

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for OsString

Available on crate feature std only.

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for PathBuf

Available on crate feature std only.

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for SystemTime

Available on crate feature std only.

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroI8

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroI16

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroI32

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroI64

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroIsize

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroU8

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroU16

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroU32

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroU64

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl Merge for NonZeroUsize

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<K, V> Merge for BTreeMap<K, V>

where K: Ord + Display, V: Merge,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<K, V, S> Merge for HashMap<K, V, S>

where K: Eq + Hash + Display, V: Merge, S: BuildHasher,

Available on crate feature std only.

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for Cow<'_, T>

where T: ?Sized + ToOwned, T::Owned: Merge,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for Option<T>

where T: Merge,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for Box<[T]>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T> Merge for Box<T>

where T: Merge,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for BTreeSet<T>

where T: Ord,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for LinkedList<T>

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for Vec<T>

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for Cell<T>

where T: Merge,

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

impl<T> Merge for PhantomData<T>

fn merge_ref(&mut self, _: Self) -> Result<(), Error>

impl<T> Merge for Range<T>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T> Merge for RangeFrom<T>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T> Merge for RangeInclusive<T>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T> Merge for RangeTo<T>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T, E> Merge for Result<T, E>

fn merge(self, _other: Self) -> Result<Self, Error>

fn merge_ref(&mut self, _other: Self) -> Result<(), Error>

impl<T, S> Merge for HashSet<T, S>

where T: Eq + Hash, S: BuildHasher,

Available on crate feature std only.

fn merge_ref(&mut self, other: Self) -> Result<(), Error>

Implementors

impl Merge for Lines

impl<T> Merge for NoMerge<T>

impl<T, const DEFAULT: isize> Merge for Overridable<T, DEFAULT>