Trait hacspec_lib::prelude::BitXor

1.0.0 · source · []
pub trait BitXor<Rhs = Self> {
    type Output;

    fn bitxor(self, rhs: Rhs) -> Self::Output;
}
Expand description

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::Output {
        Self(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, Self(rhs): Self) -> Self::Output {
        let Self(lhs) = self;
        assert_eq!(lhs.len(), rhs.len());
        Self(
            lhs.iter()
                .zip(rhs.iter())
                .map(|(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);

Required Associated Types

The resulting type after applying the ^ operator.

Required Methods

Performs the ^ operation.

Examples
assert_eq!(true ^ false, true);
assert_eq!(true ^ true, false);
assert_eq!(5u8 ^ 1u8, 4);
assert_eq!(5u8 ^ 2u8, 7);

Implementors

Bit-wise xor operation on the coefficients.

Bit-wise xor operation on the coefficients.

Bit-wise xor operation on the coefficients.

Bit-wise xor operation on the coefficients.

impl BitXor<State> for State

impl BitXor<Block> for Block

impl BitXor<State> for State

impl BitXor<Row> for Row

impl BitXor<B0> for B0

impl BitXor<B0> for B1

impl BitXor<B1> for B0

impl BitXor<B1> for B1

impl<Ur: Unsigned> BitXor<Ur> for UTerm

impl<Ul: Unsigned, Bl: Bit, Ur: Unsigned> BitXor<Ur> for UInt<Ul, Bl> where
    UInt<Ul, Bl>: PrivateXor<Ur>,
    PrivateXorOut<UInt<Ul, Bl>, Ur>: Trim, 

impl BitXor<Block> for Block

impl BitXor<Word> for Word

impl BitXor<Nonce> for Nonce

impl BitXor<SBox> for SBox

impl BitXor<RCon> for RCon

impl BitXor<Key128> for Key128

impl BitXor<Key256> for Key256

impl BitXor<Block> for Block

impl BitXor<Key> for Key

impl BitXor<Tag> for Tag

impl BitXor<Scalar> for Scalar

impl BitXor<Scalar> for Scalar

impl BitXor<Scalar> for Scalar

impl BitXor<Block> for Block

impl BitXor<Digest> for Digest

impl BitXor<Hash> for Hash