Description
Late submissions would incur a penalty of 20% per day for up to 2 days, then they will not be accepted. Leave the last few days for documentation, further testing and formatting the results. Please read the description carefully and come see me (hopefully early) if you have any questions. You may discuss this project with other students. However, you must write your code and your report on your own.
-
Overview
In this project, we are going to build \Card Matching Fight”. Card matching ght 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 shu es the cards, deals the rst three cards and waits for the round to nish, before repeating the same process for the next round. A winner in a round is the rst player to get a match (i.e., two cards of equal rank). In each round, a di erent player is given the privilege to start.
Initially, the dealer shu es the deck of cards and hands each player a single card in a round robin fashion (say starting from player 1 in round 1). Once the dealer is done handling the cards, the dealer places the remaining deck of cards on the table and the rst 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 match, the player shows the hand, declares him/herself as a winner and the round completes. 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 shu e 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.
-
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 that the round is complete. Each thread should print a message when it nishes (e.g., \Player 1 wins and round completed”, \Player 2 round completed”, etc. The main program takes a seed as an argument for the random number generation (which will be used in shu ing and in discarding cards ).
-
The Output
The dealer and the players will write into a log le each action they talk. The log le should be able to describe exactly what is happening at each step. The log le 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)
CS4328 (Mina Guirguis ): Project #2 4 SUBMISSION
The nal 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: round completed
PLAYER 1: round completed
PLAYER 3: round completed
DEALER: shu e
The output of the program to the screen (not in the log le) 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 matching cards) 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.
-
Submission
Submission will be done through TRACS. Submissions will include the code, a report containing a brief overview of the design and implementation, the results of 5 independent runs of the program with di erent seeds, and instructions on to how to compile and run the simulator. Please upload a single zip le including all your les.
Page 3 of 3
