Struct hexe_core::board::bitboard::Bitboard
[−]
[src]
pub struct Bitboard(pub u64);
A mapping of sixty-four bits to squares of a chess board.
Examples
Iteration
Because Bitboard
implements Iterator
, its bits can be traversed over
with a for
loop. This also works in reverse with .rev()
.
for square in Bitboard::FULL { /* ... */ }
Bit Operation Composition
Board components (Square
, File
, and Rank
) can be used first in
an operation chain to construct a bitboard.
This syntax should not be misused to create obscure operations that are hard to follow.
let f = File::B; let r = Rank::Seven; let s = Square::new(f, r); assert_eq!(f & r, Bitboard::from(s)); assert_eq!(f | r, r | f); assert_eq!(s & (f ^ r), Bitboard::EMPTY);
Methods
impl Bitboard
[src]
Bit set operations.
pub const FULL: Bitboard
FULL: Bitboard = Bitboard(!0)
An instance with all bits set to 1.
pub const EMPTY: Bitboard
EMPTY: Bitboard = Bitboard(0)
An instance with all bits set to 0.
pub fn contains<T: Contained<Self>>(self, other: T) -> bool
[src]
Returns whether self
contains other
.
pub fn intersects<T: Into<Self>>(self, other: T) -> bool
[src]
Returns whether self
intersects with other
.
pub fn len(&self) -> usize
[src]
Returns the number of bits set in self
.
pub fn is_empty(&self) -> bool
[src]
Returns whether self
is empty.
pub fn has_multiple(&self) -> bool
[src]
Returns whether self
has multiple bits set.
pub fn into_bit(self) -> Option<Square>
[src]
Converts self
into its single bit.
pub fn lsb(&self) -> Option<Square>
[src]
Returns the least significant bit of self
.
pub fn msb(&self) -> Option<Square>
[src]
Returns the most significant bit of self
.
pub unsafe fn lsb_unchecked(&self) -> Square
[src]
Returns the least significant bit of self
without checking
whether self
is empty.
pub unsafe fn msb_unchecked(&self) -> Square
[src]
Returns the least significant bit of self
without checking
whether self
is empty.
pub fn remove_lsb(&mut self)
[src]
Removes the least significant bit from self
.
pub fn remove_msb(&mut self)
[src]
Removes the most significant bit from self
.
pub fn pop_lsb(&mut self) -> Option<Square>
[src]
Removes the least significant bit from self
and returns it.
pub fn pop_msb(&mut self) -> Option<Square>
[src]
Removes the most significant bit from self
and returns it.
impl Bitboard
[src]
pub const WHITE: Bitboard
WHITE: Bitboard = Bitboard(!<Self>::BLACK.0)
White board squares.
pub const BLACK: Bitboard
BLACK: Bitboard = Bitboard(12273903644374837845)
Black board squares.
ⓘImportant traits for Bitboardpub fn between(start: Square, end: Square) -> Bitboard
[src]
Returns a Bitboard
containing squares between start
and end
.
ⓘImportant traits for Bitboardpub fn line(start: Square, end: Square) -> Bitboard
[src]
Returns a Bitboard
line spanning the entire board from edge to edge,
intersecting start
and end
.
pub fn contains_empty_rank(self) -> bool
[src]
Returns whether self
has an empty rank.
pub fn path_is_empty(self, right: Right) -> bool
[src]
Returns whether the path for right
is empty within self
.
ⓘImportant traits for CarryRipplerpub fn carry_rippler(self) -> CarryRippler
[src]
Returns an iterator over the subsets of self
.
ⓘImportant traits for Bitboardpub fn pawn_attacks(self, color: Color) -> Bitboard
[src]
Generates pawn attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn knight_attacks(self) -> Bitboard
[src]
Generates knight attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn bishop_attacks(self, empty: Bitboard) -> Bitboard
[src]
Generates bishop attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn rook_attacks(self, empty: Bitboard) -> Bitboard
[src]
Generates rook attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn king_attacks(self) -> Bitboard
[src]
Generates king attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn queen_attacks(self, empty: Bitboard) -> Bitboard
[src]
Generates queen attacks for each of the bits of self
.
ⓘImportant traits for Bitboardpub fn advance(self, color: Color) -> Bitboard
[src]
Returns self
advanced by one rank for color
.
ⓘImportant traits for Bitboardpub fn retreat(self, color: Color) -> Bitboard
[src]
Returns self
retreated by one rank for color
.
ⓘImportant traits for Bitboardpub fn shift(self, direction: Direction) -> Bitboard
[src]
Returns self
shifted in a direction.
ⓘImportant traits for Bitboardpub fn fill(self, direction: Direction, empty: Bitboard) -> Bitboard
[src]
Returns self
filled in a direction, blocked off by non-empty squares.
pub fn map_str<T, F: FnOnce(&mut str) -> T>(&self, f: F) -> T
[src]
Returns the result of applying a function to a mutable string
representation of self
.
Trait Implementations
impl From<Bitboard> for CarryRippler
[src]
ⓘImportant traits for CarryRipplerfn from(bitboard: Bitboard) -> CarryRippler
[src]
Performs the conversion.
impl Copy for Bitboard
[src]
impl Clone for Bitboard
[src]
ⓘImportant traits for Bitboardfn clone(&self) -> Bitboard
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Default for Bitboard
[src]
ⓘImportant traits for Bitboardfn default() -> Bitboard
[src]
Returns the "default value" for a type. Read more
impl Hash for Bitboard
[src]
fn hash<__H: Hasher>(&self, __arg_0: &mut __H)
[src]
Feeds this value into the given [Hasher
]. Read more
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl PartialEq for Bitboard
[src]
fn eq(&self, __arg_0: &Bitboard) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &Bitboard) -> bool
[src]
This method tests for !=
.
impl Eq for Bitboard
[src]
impl Binary for Bitboard
[src]
impl Octal for Bitboard
[src]
impl LowerHex for Bitboard
[src]
impl UpperHex for Bitboard
[src]
impl Debug for Bitboard
[src]
fn fmt(&self, f: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl Display for Bitboard
[src]
fn fmt(&self, f: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl<T> Shl<T> for Bitboard where
u64: Shl<T, Output = u64>,
[src]
u64: Shl<T, Output = u64>,
type Output = Self
The resulting type after applying the <<
operator.
fn shl(self, shift: T) -> Self
[src]
Performs the <<
operation.
impl<T> ShlAssign<T> for Bitboard where
u64: ShlAssign<T>,
[src]
u64: ShlAssign<T>,
fn shl_assign(&mut self, shift: T)
[src]
Performs the <<=
operation.
impl<T> Shr<T> for Bitboard where
u64: Shr<T, Output = u64>,
[src]
u64: Shr<T, Output = u64>,
type Output = Self
The resulting type after applying the >>
operator.
fn shr(self, shift: T) -> Self
[src]
Performs the >>
operation.
impl<T> ShrAssign<T> for Bitboard where
u64: ShrAssign<T>,
[src]
u64: ShrAssign<T>,
fn shr_assign(&mut self, shift: T)
[src]
Performs the >>=
operation.
impl<T: Into<Bitboard>> BitAnd<T> for Bitboard
[src]
type Output = Self
The resulting type after applying the &
operator.
fn bitand(self, other: T) -> Self
[src]
Performs the &
operation.
impl<T: Into<Bitboard>> BitAndAssign<T> for Bitboard
[src]
fn bitand_assign(&mut self, other: T)
[src]
Performs the &=
operation.
impl<T: Into<Bitboard>> BitXor<T> for Bitboard
[src]
type Output = Self
The resulting type after applying the ^
operator.
fn bitxor(self, other: T) -> Self
[src]
Performs the ^
operation.
impl<T: Into<Bitboard>> BitXorAssign<T> for Bitboard
[src]
fn bitxor_assign(&mut self, other: T)
[src]
Performs the ^=
operation.
impl<T: Into<Bitboard>> BitOr<T> for Bitboard
[src]
type Output = Self
The resulting type after applying the |
operator.
fn bitor(self, other: T) -> Self
[src]
Performs the |
operation.
impl<T: Into<Bitboard>> BitOrAssign<T> for Bitboard
[src]
fn bitor_assign(&mut self, other: T)
[src]
Performs the |=
operation.
impl<T: Into<Bitboard>> Sub<T> for Bitboard
[src]
type Output = Self
The resulting type after applying the -
operator.
fn sub(self, other: T) -> Self
[src]
Performs the -
operation.
impl<T: Into<Bitboard>> SubAssign<T> for Bitboard
[src]
fn sub_assign(&mut self, other: T)
[src]
Performs the -=
operation.
impl Not for Bitboard
[src]
type Output = Self
The resulting type after applying the !
operator.
fn not(self) -> Self
[src]
Performs the unary !
operation.
impl<A: Into<Bitboard>> FromIterator<A> for Bitboard
[src]
fn from_iter<T: IntoIterator<Item = A>>(iter: T) -> Self
[src]
Creates a value from an iterator. Read more
impl<A: Into<Bitboard>> Extend<A> for Bitboard
[src]
fn extend<T: IntoIterator<Item = A>>(&mut self, iter: T)
[src]
Extends a collection with the contents of an iterator. Read more
impl Iterator for Bitboard
[src]
type Item = Square
The type of the elements being iterated over.
fn next(&mut self) -> Option<Self::Item>
[src]
Advances the iterator and returns the next value. Read more
fn size_hint(&self) -> (usize, Option<usize>)
[src]
Returns the bounds on the remaining length of the iterator. Read more
fn count(self) -> usize
[src]
Consumes the iterator, counting the number of iterations and returning it. Read more
fn last(self) -> Option<Self::Item>
[src]
Consumes the iterator, returning the last element. Read more
fn nth(&mut self, n: usize) -> Option<Self::Item>
1.0.0[src]
Returns the n
th element of the iterator. Read more
fn step_by(self, step: usize) -> StepBy<Self>
[src]
🔬 This is a nightly-only experimental API. (iterator_step_by
)
unstable replacement of Range::step_by
Creates an iterator starting at the same point, but stepping by the given amount at each iteration. Read more
fn chain<U>(self, other: U) -> Chain<Self, <U as IntoIterator>::IntoIter> where
U: IntoIterator<Item = Self::Item>,
1.0.0[src]
U: IntoIterator<Item = Self::Item>,
Takes two iterators and creates a new iterator over both in sequence. Read more
fn zip<U>(self, other: U) -> Zip<Self, <U as IntoIterator>::IntoIter> where
U: IntoIterator,
1.0.0[src]
U: IntoIterator,
'Zips up' two iterators into a single iterator of pairs. Read more
fn map<B, F>(self, f: F) -> Map<Self, F> where
F: FnMut(Self::Item) -> B,
1.0.0[src]
F: FnMut(Self::Item) -> B,
Takes a closure and creates an iterator which calls that closure on each element. Read more
fn for_each<F>(self, f: F) where
F: FnMut(Self::Item),
1.21.0[src]
F: FnMut(Self::Item),
Calls a closure on each element of an iterator. Read more
fn filter<P>(self, predicate: P) -> Filter<Self, P> where
P: FnMut(&Self::Item) -> bool,
1.0.0[src]
P: FnMut(&Self::Item) -> bool,
Creates an iterator which uses a closure to determine if an element should be yielded. Read more
fn filter_map<B, F>(self, f: F) -> FilterMap<Self, F> where
F: FnMut(Self::Item) -> Option<B>,
1.0.0[src]
F: FnMut(Self::Item) -> Option<B>,
Creates an iterator that both filters and maps. Read more
fn enumerate(self) -> Enumerate<Self>
1.0.0[src]
Creates an iterator which gives the current iteration count as well as the next value. Read more
fn peekable(self) -> Peekable<Self>
1.0.0[src]
Creates an iterator which can use peek
to look at the next element of the iterator without consuming it. Read more
fn skip_while<P>(self, predicate: P) -> SkipWhile<Self, P> where
P: FnMut(&Self::Item) -> bool,
1.0.0[src]
P: FnMut(&Self::Item) -> bool,
Creates an iterator that [skip
]s elements based on a predicate. Read more
fn take_while<P>(self, predicate: P) -> TakeWhile<Self, P> where
P: FnMut(&Self::Item) -> bool,
1.0.0[src]
P: FnMut(&Self::Item) -> bool,
Creates an iterator that yields elements based on a predicate. Read more
fn skip(self, n: usize) -> Skip<Self>
1.0.0[src]
Creates an iterator that skips the first n
elements. Read more
fn take(self, n: usize) -> Take<Self>
1.0.0[src]
Creates an iterator that yields its first n
elements. Read more
fn scan<St, B, F>(self, initial_state: St, f: F) -> Scan<Self, St, F> where
F: FnMut(&mut St, Self::Item) -> Option<B>,
1.0.0[src]
F: FnMut(&mut St, Self::Item) -> Option<B>,
An iterator adaptor similar to [fold
] that holds internal state and produces a new iterator. Read more
fn flat_map<U, F>(self, f: F) -> FlatMap<Self, U, F> where
F: FnMut(Self::Item) -> U,
U: IntoIterator,
1.0.0[src]
F: FnMut(Self::Item) -> U,
U: IntoIterator,
Creates an iterator that works like map, but flattens nested structure. Read more
fn flatten(self) -> Flatten<Self> where
Self::Item: IntoIterator,
[src]
Self::Item: IntoIterator,
iterator_flatten
)Creates an iterator that flattens nested structure. Read more
fn fuse(self) -> Fuse<Self>
1.0.0[src]
Creates an iterator which ends after the first [None
]. Read more
fn inspect<F>(self, f: F) -> Inspect<Self, F> where
F: FnMut(&Self::Item),
1.0.0[src]
F: FnMut(&Self::Item),
Do something with each element of an iterator, passing the value on. Read more
fn by_ref(&mut self) -> &mut Self
1.0.0[src]
Borrows an iterator, rather than consuming it. Read more
fn collect<B>(self) -> B where
B: FromIterator<Self::Item>,
1.0.0[src]
B: FromIterator<Self::Item>,
Transforms an iterator into a collection. Read more
fn partition<B, F>(self, f: F) -> (B, B) where
B: Default + Extend<Self::Item>,
F: FnMut(&Self::Item) -> bool,
1.0.0[src]
B: Default + Extend<Self::Item>,
F: FnMut(&Self::Item) -> bool,
Consumes an iterator, creating two collections from it. Read more
fn try_fold<B, F, R>(&mut self, init: B, f: F) -> R where
F: FnMut(B, Self::Item) -> R,
R: Try<Ok = B>,
[src]
F: FnMut(B, Self::Item) -> R,
R: Try<Ok = B>,
iterator_try_fold
)An iterator method that applies a function as long as it returns successfully, producing a single, final value. Read more
fn try_for_each<F, R>(&mut self, f: F) -> R where
F: FnMut(Self::Item) -> R,
R: Try<Ok = ()>,
[src]
F: FnMut(Self::Item) -> R,
R: Try<Ok = ()>,
iterator_try_fold
)An iterator method that applies a fallible function to each item in the iterator, stopping at the first error and returning that error. Read more
fn fold<B, F>(self, init: B, f: F) -> B where
F: FnMut(B, Self::Item) -> B,
1.0.0[src]
F: FnMut(B, Self::Item) -> B,
An iterator method that applies a function, producing a single, final value. Read more
fn all<F>(&mut self, f: F) -> bool where
F: FnMut(Self::Item) -> bool,
1.0.0[src]
F: FnMut(Self::Item) -> bool,
Tests if every element of the iterator matches a predicate. Read more
fn any<F>(&mut self, f: F) -> bool where
F: FnMut(Self::Item) -> bool,
1.0.0[src]
F: FnMut(Self::Item) -> bool,
Tests if any element of the iterator matches a predicate. Read more
fn find<P>(&mut self, predicate: P) -> Option<Self::Item> where
P: FnMut(&Self::Item) -> bool,
1.0.0[src]
P: FnMut(&Self::Item) -> bool,
Searches for an element of an iterator that satisfies a predicate. Read more
fn position<P>(&mut self, predicate: P) -> Option<usize> where
P: FnMut(Self::Item) -> bool,
1.0.0[src]
P: FnMut(Self::Item) -> bool,
Searches for an element in an iterator, returning its index. Read more
fn rposition<P>(&mut self, predicate: P) -> Option<usize> where
P: FnMut(Self::Item) -> bool,
Self: ExactSizeIterator + DoubleEndedIterator,
1.0.0[src]
P: FnMut(Self::Item) -> bool,
Self: ExactSizeIterator + DoubleEndedIterator,
Searches for an element in an iterator from the right, returning its index. Read more
fn max(self) -> Option<Self::Item> where
Self::Item: Ord,
1.0.0[src]
Self::Item: Ord,
Returns the maximum element of an iterator. Read more
fn min(self) -> Option<Self::Item> where
Self::Item: Ord,
1.0.0[src]
Self::Item: Ord,
Returns the minimum element of an iterator. Read more
fn max_by_key<B, F>(self, f: F) -> Option<Self::Item> where
B: Ord,
F: FnMut(&Self::Item) -> B,
1.6.0[src]
B: Ord,
F: FnMut(&Self::Item) -> B,
Returns the element that gives the maximum value from the specified function. Read more
fn max_by<F>(self, compare: F) -> Option<Self::Item> where
F: FnMut(&Self::Item, &Self::Item) -> Ordering,
1.15.0[src]
F: FnMut(&Self::Item, &Self::Item) -> Ordering,
Returns the element that gives the maximum value with respect to the specified comparison function. Read more
fn min_by_key<B, F>(self, f: F) -> Option<Self::Item> where
B: Ord,
F: FnMut(&Self::Item) -> B,
1.6.0[src]
B: Ord,
F: FnMut(&Self::Item) -> B,
Returns the element that gives the minimum value from the specified function. Read more
fn min_by<F>(self, compare: F) -> Option<Self::Item> where
F: FnMut(&Self::Item, &Self::Item) -> Ordering,
1.15.0[src]
F: FnMut(&Self::Item, &Self::Item) -> Ordering,
Returns the element that gives the minimum value with respect to the specified comparison function. Read more
fn rev(self) -> Rev<Self> where
Self: DoubleEndedIterator,
1.0.0[src]
Self: DoubleEndedIterator,
Reverses an iterator's direction. Read more
fn unzip<A, B, FromA, FromB>(self) -> (FromA, FromB) where
FromA: Default + Extend<A>,
FromB: Default + Extend<B>,
Self: Iterator<Item = (A, B)>,
1.0.0[src]
FromA: Default + Extend<A>,
FromB: Default + Extend<B>,
Self: Iterator<Item = (A, B)>,
Converts an iterator of pairs into a pair of containers. Read more
fn cloned<'a, T>(self) -> Cloned<Self> where
Self: Iterator<Item = &'a T>,
T: 'a + Clone,
1.0.0[src]
Self: Iterator<Item = &'a T>,
T: 'a + Clone,
Creates an iterator which [clone
]s all of its elements. Read more
fn cycle(self) -> Cycle<Self> where
Self: Clone,
1.0.0[src]
Self: Clone,
Repeats an iterator endlessly. Read more
fn sum<S>(self) -> S where
S: Sum<Self::Item>,
1.11.0[src]
S: Sum<Self::Item>,
Sums the elements of an iterator. Read more
fn product<P>(self) -> P where
P: Product<Self::Item>,
1.11.0[src]
P: Product<Self::Item>,
Iterates over the entire iterator, multiplying all the elements Read more
fn cmp<I>(self, other: I) -> Ordering where
I: IntoIterator<Item = Self::Item>,
Self::Item: Ord,
1.5.0[src]
I: IntoIterator<Item = Self::Item>,
Self::Item: Ord,
Lexicographically compares the elements of this Iterator
with those of another. Read more
fn partial_cmp<I>(self, other: I) -> Option<Ordering> where
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
Lexicographically compares the elements of this Iterator
with those of another. Read more
fn eq<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialEq<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialEq<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are equal to those of another. Read more
fn ne<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialEq<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialEq<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are unequal to those of another. Read more
fn lt<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are lexicographically less than those of another. Read more
fn le<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are lexicographically less or equal to those of another. Read more
fn gt<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are lexicographically greater than those of another. Read more
fn ge<I>(self, other: I) -> bool where
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
1.5.0[src]
I: IntoIterator,
Self::Item: PartialOrd<<I as IntoIterator>::Item>,
Determines if the elements of this Iterator
are lexicographically greater than or equal to those of another. Read more
impl DoubleEndedIterator for Bitboard
[src]
fn next_back(&mut self) -> Option<Self::Item>
[src]
Removes and returns an element from the end of the iterator. Read more
fn try_rfold<B, F, R>(&mut self, init: B, f: F) -> R where
F: FnMut(B, Self::Item) -> R,
R: Try<Ok = B>,
[src]
F: FnMut(B, Self::Item) -> R,
R: Try<Ok = B>,
iterator_try_fold
)This is the reverse version of [try_fold()
]: it takes elements starting from the back of the iterator. Read more
fn rfold<B, F>(self, accum: B, f: F) -> B where
F: FnMut(B, Self::Item) -> B,
[src]
F: FnMut(B, Self::Item) -> B,
iter_rfold
)An iterator method that reduces the iterator's elements to a single, final value, starting from the back. Read more
fn rfind<P>(&mut self, predicate: P) -> Option<Self::Item> where
P: FnMut(&Self::Item) -> bool,
[src]
P: FnMut(&Self::Item) -> bool,
iter_rfind
)Searches for an element of an iterator from the right that satisfies a predicate. Read more
impl ExactSizeIterator for Bitboard
[src]
fn len(&self) -> usize
[src]
Returns the exact number of times the iterator will iterate. Read more
fn is_empty(&self) -> bool
[src]
exact_size_is_empty
)Returns whether the iterator is empty. Read more
impl<T: Into<Bitboard>> Contained<Bitboard> for T
[src]
fn contained_in(self, other: Bitboard) -> bool
[src]
Returns whether self
is contained in other
.