dealer.h File Reference

Contains function-equivalents of what a real-life table dealer would do in a real poker game. More...

#include <stdbool.h>
#include "gamerules.h"
#include "gamestate.h"
#include "player.h"
#include "playingcard.h"

Go to the source code of this file.

Functions
void	buildDeck (PlayingCard[], bool)
	Builds a deck of playing cards containing 4 suits & 13 cards for each suit.
int	decideWinners (Player *[], int, int *)
	Compares the scores of all players on the same tier (scores array index). Populates the winners array with player indexes who function deemed as winners.
void	distributeCards (PlayingCard[], Player *[], PlayingCard *[], const GameRuleSet *)
	Distributes random playing cards to players' hands and selects community cards.
void	scorePlayersHand (Player *, const PlayingCard *[], int)
	Analyzes Player's hand using functions inside handranking.c and saves scores in Player.scores array.

Detailed Description

Contains function-equivalents of what a real-life table dealer would do in a real poker game.

Function Documentation

buildDeck()

void buildDeck	(	PlayingCard	targetArray[],
		bool	print_addrs )

Builds a deck of playing cards containing 4 suits & 13 cards for each suit.

Parameters

targetArray	The array of PlayingCards to build the deck in.
print_addrs	If true, console will print out memory address of each card. For debug purposes.

decideWinners()

int decideWinners	(	Player *	players[],
		int	players_count,
		int *	winners )

Compares the scores of all players on the same tier (scores array index). Populates the winners array with player indexes who function deemed as winners.

Parameters

players	The Players who will be compared with each other score-wise.
players_count	The length of players array.
winners	An array which the function will populate with player indexes who are to be awarded the pot or part of it.

Returns

The size of the resulting winners array, or how many players are winners.

distributeCards()

void distributeCards	(	PlayingCard	deck[],
		Player *	players[],
		PlayingCard *	comm_cards[],
		const GameRuleSet *	rules )

Distributes random playing cards to players' hands and selects community cards.

Parameters

deck	An array of previously generated PlayingCard structs.
players	Array of Players who will be dealt hole cards.
comm_cards	Array of PlayingCards which will be community cards.
rules	GameRuleSet struct containing amount of Players.

First, it generates an array of random numbers which will symbolize playing cards' index in the deck. Then, this array will be checked and modified to ensure that all elements are unique. Lastly, players' hands and community card arrays are populated with addresses to cards with randomly selected indexes. Each used index is replaced with -1 to ensure no player and community card were given the same card.

scorePlayersHand()

void scorePlayersHand	(	Player *	_player,
		const PlayingCard *	comm_cards[],
		int	rev_cards_count )

Analyzes Player's hand using functions inside handranking.c and saves scores in Player.scores array.

Parameters

_player	The player whose hand will be scored.
comm_cards	An array of pointers to current community cards.
rev_cards_count	How many community cards have been revealed by dealer. For more info on how scores work, refer to handranking.h documentation.