//! [`Uint`] bitwise xor operations. use super::Uint; use crate::{Limb, Wrapping}; use core::ops::{BitXor, BitXorAssign}; use subtle::{Choice, CtOption}; impl Uint { /// Computes bitwise `a ^ b`. #[inline(always)] pub const fn bitxor(&self, rhs: &Self) -> Self { let mut limbs = [Limb::ZERO; LIMBS]; let mut i = 0; while i < LIMBS { limbs[i] = self.limbs[i].bitxor(rhs.limbs[i]); i += 1; } Self { limbs } } /// Perform wrapping bitwise `XOR``. /// /// There's no way wrapping could ever happen. /// This function exists so that all operations are accounted for in the wrapping operations pub const fn wrapping_xor(&self, rhs: &Self) -> Self { self.bitxor(rhs) } /// Perform checked bitwise `XOR`, returning a [`CtOption`] which `is_some` always pub fn checked_xor(&self, rhs: &Self) -> CtOption { let result = self.bitxor(rhs); CtOption::new(result, Choice::from(1)) } } impl BitXor for Uint { type Output = Self; fn bitxor(self, rhs: Self) -> Uint { self.bitxor(&rhs) } } impl BitXor<&Uint> for Uint { type Output = Uint; #[allow(clippy::needless_borrow)] fn bitxor(self, rhs: &Uint) -> Uint { (&self).bitxor(rhs) } } impl BitXor> for &Uint { type Output = Uint; fn bitxor(self, rhs: Uint) -> Uint { self.bitxor(&rhs) } } impl BitXor<&Uint> for &Uint { type Output = Uint; fn bitxor(self, rhs: &Uint) -> Uint { self.bitxor(rhs) } } impl BitXorAssign for Uint { fn bitxor_assign(&mut self, other: Self) { *self = *self ^ other; } } impl BitXorAssign<&Uint> for Uint { fn bitxor_assign(&mut self, other: &Self) { *self = *self ^ other; } } impl BitXor for Wrapping> { type Output = Self; fn bitxor(self, rhs: Self) -> Wrapping> { Wrapping(self.0.bitxor(&rhs.0)) } } impl BitXor<&Wrapping>> for Wrapping> { type Output = Wrapping>; fn bitxor(self, rhs: &Wrapping>) -> Wrapping> { Wrapping(self.0.bitxor(&rhs.0)) } } impl BitXor>> for &Wrapping> { type Output = Wrapping>; fn bitxor(self, rhs: Wrapping>) -> Wrapping> { Wrapping(self.0.bitxor(&rhs.0)) } } impl BitXor<&Wrapping>> for &Wrapping> { type Output = Wrapping>; fn bitxor(self, rhs: &Wrapping>) -> Wrapping> { Wrapping(self.0.bitxor(&rhs.0)) } } impl BitXorAssign for Wrapping> { fn bitxor_assign(&mut self, other: Self) { *self = *self ^ other; } } impl BitXorAssign<&Wrapping>> for Wrapping> { fn bitxor_assign(&mut self, other: &Self) { *self = *self ^ other; } } #[cfg(test)] mod tests { use crate::U128; #[test] fn checked_xor_ok() { let result = U128::ZERO.checked_xor(&U128::ONE); assert_eq!(result.unwrap(), U128::ONE); } #[test] fn overlapping_xor_ok() { let result = U128::ZERO.wrapping_xor(&U128::ONE); assert_eq!(result, U128::ONE); } }