W3cubDocs

/Rust

Trait std::ops::BitAnd

pub trait BitAnd<RHS = Self> {
    type Output;
    fn bitand(self, rhs: RHS) -> Self::Output;
}

The BitAnd trait is used to specify the functionality of &.

Examples

In this example, the & operator is lifted to a trivial Scalar type.

use std::ops::BitAnd;

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

impl BitAnd for Scalar {
    type Output = Self;

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

fn main() {
    assert_eq!(Scalar(true) & Scalar(true), Scalar(true));
    assert_eq!(Scalar(true) & Scalar(false), Scalar(false));
    assert_eq!(Scalar(false) & Scalar(true), Scalar(false));
    assert_eq!(Scalar(false) & Scalar(false), Scalar(false));
}

In this example, the BitAnd trait is implemented for a BooleanVector struct.

use std::ops::BitAnd;

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

impl BitAnd for BooleanVector {
    type Output = Self;

    fn bitand(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).collect())
    }
}

fn main() {
    let bv1 = BooleanVector(vec![true, true, false, false]);
    let bv2 = BooleanVector(vec![true, false, true, false]);
    let expected = BooleanVector(vec![true, false, false, false]);
    assert_eq!(bv1 & bv2, expected);
}

Associated Types

The resulting type after applying the & operator

Required Methods

The method for the & operator

Implementors

© 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.BitAnd.html