Struct PieceStatus 

pub struct PieceStatus {
    pub pieces: [TrackedPieceStatus; 34],
}

Status records for every physical piece tracked by the board.

Records are ordered as white pawns, rooks, knights, bishops, queens, king, followed by the corresponding black pieces.

This value is carried by BoardEvent::PieceStatus after Command::read_piece_status is sent. Low-level transport implementations can obtain it through decode_response_notification.

Examples

Query the running board actor with BoardHandle::piece_status, then inspect the records returned by the board:

use chessnut_move::transport::tokio::{BoardHandle, HandleError};

async fn report_piece_batteries(board: &BoardHandle) -> Result<(), HandleError> {
    let status = board.piece_status().await?;

    for tracked in &status.pieces {
        match tracked.battery_percentage {
            Some(percentage) => {
                println!("{:?}: {percentage}%", tracked.piece);
            }
            None => println!("{:?}: unavailable", tracked.piece),
        }
    }

    Ok(())
}

Fields

pieces: [TrackedPieceStatus; 34]

Piece records in the order defined by the Move protocol.

Trait Implementations

impl Clone for PieceStatus

fn clone(&self) -> PieceStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PieceStatus

impl Debug for PieceStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PieceStatus

impl Hash for PieceStatus

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PieceStatus

fn eq(&self, other: &PieceStatus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PieceStatus