W3cubDocs

/Rust

Trait std::ops::BitXor

#[lang = "bitxor"]
pub trait BitXor<RHS = Self> {
    type Output;
    fn bitxor(self, rhs: RHS) -> Self::Output;
}

The bitwise XOR operator ^.

Note that RHS is Self by default, but this is not mandatory.

Examples

An implementation of BitXor that lifts ^ to a wrapper around bool.

use std::ops::BitXor;

#[derive(Debug, PartialEq)]
struct Scalar(bool);

impl BitXor for Scalar {
    type Output = Self;

    // rhs is the "right-hand side" of the expression `a ^ b`
    fn bitxor(self, rhs: Self) -> Self {
        Scalar(self.0 ^ rhs.0)
    }
}

assert_eq!(Scalar(true) ^ Scalar(true), Scalar(false));
assert_eq!(Scalar(true) ^ Scalar(false), Scalar(true));
assert_eq!(Scalar(false) ^ Scalar(true), Scalar(true));
assert_eq!(Scalar(false) ^ Scalar(false), Scalar(false));

An implementation of BitXor trait for a wrapper around Vec<bool>.

use std::ops::BitXor;

#[derive(Debug, PartialEq)]
struct BooleanVector(Vec<bool>);

impl BitXor for BooleanVector {
    type Output = Self;

    fn bitxor(self, BooleanVector(rhs): Self) -> Self {
        let BooleanVector(lhs) = self;
        assert_eq!(lhs.len(), rhs.len());
        BooleanVector(lhs.iter()
                         .zip(rhs.iter())
                         .map(|(x, y)| (*x || *y) && !(*x && *y))
                         .collect())
    }
}

let bv1 = BooleanVector(vec![true, true, false, false]);
let bv2 = BooleanVector(vec![true, false, true, false]);
let expected = BooleanVector(vec![false, true, true, false]);
assert_eq!(bv1 ^ bv2, expected);

Associated Types

The resulting type after applying the ^ operator.

Required Methods

Performs the ^ operation.

Implementors

impl BitXor<bool> for bool [src]

impl BitXor<i128> for i128 [src]

impl BitXor<i16> for i16 [src]

impl BitXor<i32> for i32 [src]

impl BitXor<i64> for i64 [src]

impl BitXor<i8> for i8 [src]

impl BitXor<isize> for isize [src]

impl BitXor<u128> for u128 [src]

impl BitXor<u16> for u16 [src]

impl BitXor<u32> for u32 [src]

impl BitXor<u64> for u64 [src]

impl BitXor<u8> for u8 [src]

impl BitXor<usize> for usize [src]

impl BitXor<Wrapping<i128>> for Wrapping<i128> [src]

impl BitXor<Wrapping<i16>> for Wrapping<i16> [src]

impl BitXor<Wrapping<i32>> for Wrapping<i32> [src]

impl BitXor<Wrapping<i64>> for Wrapping<i64> [src]

impl BitXor<Wrapping<i8>> for Wrapping<i8> [src]

impl BitXor<Wrapping<isize>> for Wrapping<isize> [src]

impl BitXor<Wrapping<u128>> for Wrapping<u128> [src]

impl BitXor<Wrapping<u16>> for Wrapping<u16> [src]

impl BitXor<Wrapping<u32>> for Wrapping<u32> [src]

impl BitXor<Wrapping<u64>> for Wrapping<u64> [src]

impl BitXor<Wrapping<u8>> for Wrapping<u8> [src]

impl BitXor<Wrapping<usize>> for Wrapping<usize> [src]

impl<'a> BitXor<&'a bool> for bool [src]

impl<'a> BitXor<&'a i128> for i128 [src]

impl<'a> BitXor<&'a i16> for i16 [src]

impl<'a> BitXor<&'a i32> for i32 [src]

impl<'a> BitXor<&'a i64> for i64 [src]

impl<'a> BitXor<&'a i8> for i8 [src]

impl<'a> BitXor<&'a isize> for isize [src]

impl<'a> BitXor<&'a u128> for u128 [src]

impl<'a> BitXor<&'a u16> for u16 [src]

impl<'a> BitXor<&'a u32> for u32 [src]

impl<'a> BitXor<&'a u64> for u64 [src]

impl<'a> BitXor<&'a u8> for u8 [src]

impl<'a> BitXor<&'a usize> for usize [src]

impl<'a> BitXor<&'a Wrapping<i128>> for Wrapping<i128> [src]

impl<'a> BitXor<&'a Wrapping<i16>> for Wrapping<i16> [src]

impl<'a> BitXor<&'a Wrapping<i32>> for Wrapping<i32> [src]

impl<'a> BitXor<&'a Wrapping<i64>> for Wrapping<i64> [src]

impl<'a> BitXor<&'a Wrapping<i8>> for Wrapping<i8> [src]

impl<'a> BitXor<&'a Wrapping<isize>> for Wrapping<isize> [src]

impl<'a> BitXor<&'a Wrapping<u128>> for Wrapping<u128> [src]

impl<'a> BitXor<&'a Wrapping<u16>> for Wrapping<u16> [src]

impl<'a> BitXor<&'a Wrapping<u32>> for Wrapping<u32> [src]

impl<'a> BitXor<&'a Wrapping<u64>> for Wrapping<u64> [src]

impl<'a> BitXor<&'a Wrapping<u8>> for Wrapping<u8> [src]

impl<'a> BitXor<&'a Wrapping<usize>> for Wrapping<usize> [src]

impl<'a> BitXor<bool> for &'a bool [src]

impl<'a> BitXor<i128> for &'a i128 [src]

impl<'a> BitXor<i16> for &'a i16 [src]

impl<'a> BitXor<i32> for &'a i32 [src]

impl<'a> BitXor<i64> for &'a i64 [src]

impl<'a> BitXor<i8> for &'a i8 [src]

impl<'a> BitXor<isize> for &'a isize [src]

impl<'a> BitXor<u128> for &'a u128 [src]

impl<'a> BitXor<u16> for &'a u16 [src]

impl<'a> BitXor<u32> for &'a u32 [src]

impl<'a> BitXor<u64> for &'a u64 [src]

impl<'a> BitXor<u8> for &'a u8 [src]

impl<'a> BitXor<usize> for &'a usize [src]

impl<'a> BitXor<Wrapping<i128>> for &'a Wrapping<i128> [src]

impl<'a> BitXor<Wrapping<i16>> for &'a Wrapping<i16> [src]

impl<'a> BitXor<Wrapping<i32>> for &'a Wrapping<i32> [src]

impl<'a> BitXor<Wrapping<i64>> for &'a Wrapping<i64> [src]

impl<'a> BitXor<Wrapping<i8>> for &'a Wrapping<i8> [src]

impl<'a> BitXor<Wrapping<isize>> for &'a Wrapping<isize> [src]

impl<'a> BitXor<Wrapping<u128>> for &'a Wrapping<u128> [src]

impl<'a> BitXor<Wrapping<u16>> for &'a Wrapping<u16> [src]

impl<'a> BitXor<Wrapping<u32>> for &'a Wrapping<u32> [src]

impl<'a> BitXor<Wrapping<u64>> for &'a Wrapping<u64> [src]

impl<'a> BitXor<Wrapping<u8>> for &'a Wrapping<u8> [src]

impl<'a> BitXor<Wrapping<usize>> for &'a Wrapping<usize> [src]

impl<'a, 'b> BitXor<&'a bool> for &'b bool [src]

impl<'a, 'b> BitXor<&'a i128> for &'b i128 [src]

impl<'a, 'b> BitXor<&'a i16> for &'b i16 [src]

impl<'a, 'b> BitXor<&'a i32> for &'b i32 [src]

impl<'a, 'b> BitXor<&'a i64> for &'b i64 [src]

impl<'a, 'b> BitXor<&'a i8> for &'b i8 [src]

impl<'a, 'b> BitXor<&'a isize> for &'b isize [src]

impl<'a, 'b> BitXor<&'a u128> for &'b u128 [src]

impl<'a, 'b> BitXor<&'a u16> for &'b u16 [src]

impl<'a, 'b> BitXor<&'a u32> for &'b u32 [src]

impl<'a, 'b> BitXor<&'a u64> for &'b u64 [src]

impl<'a, 'b> BitXor<&'a u8> for &'b u8 [src]

impl<'a, 'b> BitXor<&'a usize> for &'b usize [src]

impl<'a, 'b> BitXor<&'a Wrapping<i128>> for &'b Wrapping<i128> [src]

impl<'a, 'b> BitXor<&'a Wrapping<i16>> for &'b Wrapping<i16> [src]

impl<'a, 'b> BitXor<&'a Wrapping<i32>> for &'b Wrapping<i32> [src]

impl<'a, 'b> BitXor<&'a Wrapping<i64>> for &'b Wrapping<i64> [src]

impl<'a, 'b> BitXor<&'a Wrapping<i8>> for &'b Wrapping<i8> [src]

impl<'a, 'b> BitXor<&'a Wrapping<isize>> for &'b Wrapping<isize> [src]

impl<'a, 'b> BitXor<&'a Wrapping<u128>> for &'b Wrapping<u128> [src]

impl<'a, 'b> BitXor<&'a Wrapping<u16>> for &'b Wrapping<u16> [src]

impl<'a, 'b> BitXor<&'a Wrapping<u32>> for &'b Wrapping<u32> [src]

impl<'a, 'b> BitXor<&'a Wrapping<u64>> for &'b Wrapping<u64> [src]

impl<'a, 'b> BitXor<&'a Wrapping<u8>> for &'b Wrapping<u8> [src]

impl<'a, 'b> BitXor<&'a Wrapping<usize>> for &'b Wrapping<usize> [src]

impl<'a, 'b, T> BitXor<&'b BTreeSet<T>> for &'a BTreeSet<T> where
    T: Ord + Clone
[src]

Returns the symmetric difference of self and rhs as a new BTreeSet<T>.

Examples

use std::collections::BTreeSet;

let a: BTreeSet<_> = vec![1, 2, 3].into_iter().collect();
let b: BTreeSet<_> = vec![2, 3, 4].into_iter().collect();

let result = &a ^ &b;
let result_vec: Vec<_> = result.into_iter().collect();
assert_eq!(result_vec, [1, 4]);

impl<'a, 'b, T, S> BitXor<&'b HashSet<T, S>> for &'a HashSet<T, S> where
    T: Eq + Hash + Clone,
    S: BuildHasher + Default
[src]

Returns the symmetric difference of self and rhs as a new HashSet<T, S>.

Examples

use std::collections::HashSet;

let a: HashSet<_> = vec![1, 2, 3].into_iter().collect();
let b: HashSet<_> = vec![3, 4, 5].into_iter().collect();

let set = &a ^ &b;

let mut i = 0;
let expected = [1, 2, 4, 5];
for x in &set {
    assert!(expected.contains(x));
    i += 1;
}
assert_eq!(i, expected.len());

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.
https://doc.rust-lang.org/std/ops/trait.BitXor.html