src/table.rs
author Peter Gervai <grin@grin.hu>
Sun, 05 Feb 2023 01:42:36 +0100
changeset 8 91154fe07100
parent 5 0dd7f2c9fd81
permissions -rw-r--r--
Add some test comment, remove original draft comments.

/// Implemantation of the playing Table.

use std::collections::VecDeque;

use crate::card::Card;
use crate::row::Row;
use crate::player::PlayerCard;

#[derive(Debug)]
/// A playing Table, containing 5 [`Row`]s and some [`PlayerCard`]s.
/// A Table can do some useful function with its cards, like picking
/// closest row or moving cards.
pub(crate) struct Table {
    rows: Vec<Row>,
    player_cards: VecDeque<PlayerCard>, // owned by a player
}

impl Table {
    /// Creates a new `Table`, filling Rows from `row_cards`.
    pub(crate) fn new(row_cards: VecDeque<Card>) -> Self {
        // We have exactly 5 Rows.
        let mut rows = Vec::with_capacity(5);
        for card in row_cards {
            // create a new row then put a card into it
            let mut row = Row::new();
            if let Some(_) = row.push_or_collect(card) {
                // Row should have one card, so... mustn't happen.
                panic!("Freshly created row overflowed");
            }
            // Put the new row onto the Table.
            rows.push( row );
        }

        // And return the newly created Table.
        Table {
            rows,
            player_cards: VecDeque::new(),
        }
    }

    /// Gets a [`Card`] from a [`Player`] and put it into the `player_cards` area,
    /// remembering whose (`player_id`) card it was.
    pub(crate) fn lay_player_card( &mut self, card: Card, player_id: i32 ) {
        self.player_cards.push_back( PlayerCard { player_id, card } );
    }

    /// Sort the [`Card`]s thrown by the [`Player`]s, since we'd need
    /// to get them ordered by value later.
    pub(crate) fn sort_cards( &mut self ) {
        // Sorting a normal VecDeque is not possible since it may contain
        // holes, so we need to de-hole it first, then it's sortable (through
        // a returned pointer slice).
        self.player_cards.make_contiguous().sort_by( |a,b| b.card.cmp(&a.card) );
    }

    /// Returns true if we have unprocessed Player cards on the table.
    pub(crate) fn has_player_cards( &self ) -> bool {
        self.player_cards.len() > 0
    }

    /// Return the smallest player card on the table.
    /// FIXME: shall check whether it's ordered.
    pub(crate) fn get_smallest_player_card( &mut self ) -> PlayerCard {
        // FIXME: check orderedness!
        // FIXME: check asking when empty!
        self.player_cards.pop_back().expect("out of player cards on table")
    }

    /// Return the row which is closest to the `pcard` arg, or None if
    /// all Row tails are larger.
    pub(crate) fn get_closest_row( &self, pcard: &PlayerCard ) -> Option<usize> {
        // get the row id with last card closest smaller to players'
        let row_tails = self.get_row_tails();
        let mut closest_val = None;
        let mut diff = 127; // larger than any
        // Check all the row tail cards
        for i in 0..row_tails.len() {
            if row_tails[i] < pcard.card.value && pcard.card.value - row_tails[i] < diff {
                // it is smaller than pcard and closer than the old closest one: match!
                // Store the row index
                closest_val = Some(i); 
                diff = pcard.card.value - row_tails[i];
                // debug!("DEBUG: pcard {}, row {}, head {}, diff {}, closest {:?}", pcard.card.value, i, row_heads[i], diff, closest_val);
            }
        }

        closest_val
    }

    /// Put a [`Card`] into the `row_id` Row (tail).
    /// Returns `None` if ok or `Some(cards)` when the Row is full.
    pub(crate) fn put_card_into_row( &mut self, pcard: PlayerCard, row_id: usize ) -> Option<VecDeque<Card>> {
        // We actually ask the Row to do it properly.
        self.rows[row_id].push_or_collect(pcard.card)
    }

    pub(crate) fn get_row_tails( &self ) -> Vec<i8> {
        let mut heads: Vec<i8> = Vec::new();
        for i in 0..self.rows.len() {
            heads.push( self.rows[i].last_card_value() );
        }
        heads
    }

    // take a whole row and hand it over
    pub(crate) fn take_row( &mut self, row_id: usize ) -> VecDeque<Card> {
        self.rows[row_id].take_row()
    }

    // collect remaining cards in the rows at the end of round
    pub(crate) fn collect_rows( &mut self ) -> VecDeque<Card> {
        let mut cards = VecDeque::new();
        for row in 0..self.rows.len() {
            self.rows[row]
                .take_row()
                .into_iter()
                .for_each(|card| cards.push_back(card));
        }
        cards
    }

    /// Return a non-mutable borrow of the rows to look at
    pub fn peek_rows(&self) -> &Vec<Row> {
        &self.rows
    }
}