App\Card\CardHand

Complexity

Total Complexity

17

Size/Duplication

Total Lines	94
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	getCards()	0	3	1
A	addCard()	0	3	1
B	getTotal()	0	25	7
A	getNrOfCards()	0	3	1
A	getTotalBlackJack()	0	20	5
A	toArray()	0	7	2

<?php

namespace App\Card;

/**
 * Class CardHand represents a hand of cards.
 */
class CardHand
{
    /** @var Card[] */
    private array $cards = [];

    public function addCard(Card $card): void
    {
        $this->cards[] = $card;
    }

    /**
     * @return Card[]
     */
    public function getCards(): array
    {
        return $this->cards;
    }

    /**
     * Get total points of the hand.
     * Handle the Aces.
     * @return int
     */
    public function getTotal(): int
    {
        $sum = 0;
        $aces = [];

        foreach ($this->cards as $card) {
            if ($card->getValue() === 'Ace') {
                $aces[] = $card;
                continue;
            }
            $sum += $card->getNumericValue();
        }
        $numAces = count($aces);

        if ($numAces === 2) {
            // If 2 Aces — one counts as 14, one as 1
            $sum += 14 + 1;
        } elseif ($numAces === 1) {
            // One Ace — check the current sum
            $sum += ($sum + 14 <= 21) ? 14 : 1;
        } elseif ($numAces > 2) {
            // More than 2 Aces — treat one as 14, one as 1, rest as 1
            $sum += 14 + 1 + ($numAces - 2) * 1;
        }
        return $sum;
    }

    /**
     * Calculate total points of the hand for black jack game.
     * Handle the Aces.
     * @return int
     */
    public function getTotalBlackJack(): int
    {
        $sum = 0;
        $aces = 0;

        foreach ($this->cards as $card) {
            if ($card->getValue() === 'Ace') {
                $aces++;
                continue;
            }
            $sum += $card->getBlackJackNumericValue();
        }

        for ($i = 0; $i < $aces; $i++) {
            $sum += 11;
            if ($sum > 21) {
                $sum -= 10;
            }
        }
        return $sum;
    }

    public function getNrOfCards(): int
    {
        return count($this->cards);
    }

    /**
     * Convert the hand to an array.
     *
     * @return array<int, array<string, string>>
     */
    public function toArray(): array
    {
        $array = [];
        foreach ($this->cards as $card) {
            $array[] = $card->toArray();
        }
        return $array;
    }
}