1 Overview

In this project, you are to build Pair War. Pair War is a simple card game with one dealer, 3 players, and a single deck of cards. The game is composed of three rounds. At the beginning of each round, the dealer shuffles the cards, deals the first three cards and waits for the round to finish, before repeating the same process for the next round. A winner in a round is the first player to get a pair. In each round, a different player is given the privilege to start.

Initially, the dealer shuffles the deck of cards and hands each player a single card in a round robin fashion (say starting from player 1 for round 1). Once the dealer is done handling the cards, the dealer places the remaining deck of cards on the table and the first round begins. Each player (starting from player 1), draws a card from the deck and compares it to the card he/she has. If they are a pair, the player shows the hand, declares him/herself as a winner and the round ends. Otherwise, the player will discard one card (at random) by placing it at the end of the deck of cards on the table and the next player proceeds. Once a round ends, the dealer will shuffle the deck and hands a card to each player. In the second round, the second player starts drawing a card from the deck. In the third round, the third player starts drawing a card from the deck.

2 Implementation

This project is to implemented in C using POSIX threads. You can check: https://computing.llnl.gov/tutorials/pthreads for a tutorial on the POSIX thread library. The main function should create a thread for the dealer and 3 threads for the players. Notice that we want to keep the threads synchronized and to protect any shared objects. Also, when a player wins, he/she needs to inform other players so they can exit. Each thread should print a message when it finishes (e.g., Player 1 wins and exits, Player 2 exits, etc. The main program takes a seed as an argument for the random number generation (which will be used in shuffling and in discarding cards ).

3 The Output

The dealer and the players will write into a log file each action they talk. The log file should be able to describe exactly what is happening at each step. The log file should look something like this:

PLAYER 1: hand 5
PLAYER 1: draws 7
PLAYER 1: discards 7
PLAYER 1: hand 5
DECK: contents of the deck, separated by spaces (e.g., 1 2 3)

The final messages for a round should look something like:

PLAYER 2: hand 3
PLAYER 2: draws 3
PLAYER 2: hand 3 3
PLAYER 2: wins
PLAYER 2: exits round
PLAYER 1: exits round
PLAYER 3: exits round
DEALER: shuffle

The output of the program to the screen (not in the log file) should indicate the hand for each player, the status (win, lost) and the remaining deck of cards:

HAND card1 card2
WIN yes (or no)
DECK contents of the deck, separated by spaces (e.g., 1 2 3)

The hand of the winner would show two cards (the winning pair) and the hands of the other players would show only one card. A single run of the program should have 3 rounds with 3 winners.

Academic Honesty!
It is not our intention to break the school's academic policy. Posted solutions are meant to be used as a reference and should not be submitted as is. We are not held liable for any misuse of the solutions. Please see the frequently asked questions page for further questions and inquiries.
Kindly complete the form. Please provide a valid email address and we will get back to you within 24 hours. Payment is through PayPal, Buy me a Coffee or Cryptocurrency. We are a nonprofit organization however we need funds to keep this organization operating and to be able to complete our research and development projects.