The Objective

The objective of this assignment is to give you some more practice writing functions, using separate compilation, generating pseudo-random numbers, using arrays, passing arrays to functions and will also test your ability to use top-down design.

The Background

In casinos from Monte Carlo to Las Vegas, one of the most common gambling devices is the slot machine -- the "one-armed bandit." A typical slot machine has three wheels that spin around behind a narrow window. Each wheel is marked with the following symbols: CHERRY, LEMON, ORANGE, PLUM, BELL, and BAR. The window, however, allows you to see only one symbol on each wheel at a time. For example, the window might show the following configuration:

If you put a silver dollar into a slot machine and pull the handle on its side, the wheels spin around and eventually come to rest in some new configuration. If the configuration matches one of a set of winning patterns printed on the front of the slot machine, you get back some money. If not, you're out a dollar. The following table shows a typical set of winning patterns, along with their associated payoffs:

BAR       BAR       BAR           pays  $ 250

BELL      BELL      BELL/BAR      pays  $  20

PLUM      PLUM      PLUM/BAR      pays  $  14

ORANGE    ORANGE    ORANGE/BAR    pays  $  10

CHERRY    CHERRY    CHERRY        pays  $   7

CHERRY    CHERRY    -             pays  $   5

CHERRY    -         -             pays  $   2

The notation BELL/BAR means that either a BELL or a BAR can appear in that position, and the dash means that any symbol at all can appear. Thus, getting a CHERRY in the first position is automatically good for two dollars, no matter what appears on the other wheels. Note that there is never any payoff for the the LEMON symbol in the first column, even if you happen to line up three of them.

The Task

Some SPECIFIC REQUIREMENTS for this project:

You may use the functions, SetRandomSeed() and GetRandomNumber() from Lecture 5 - An Example - Cards, cards.c, as two of your utility functions. GetValidInt() may also be useful and is found in the same lecture.

You should first welcome the user and present him/her with a explanation of what it means to play the game as opposed to testing the game. After this initial greeting, a Main Menu should be displayed that allows him/her to choose to run the program in Test Mode or Play Mode or to QUIT. Your program must be capable of running in either mode.

• For Test Mode:
  
  • The user should be prompted for the number of games the test should run (a positive integer which is 100,000 or less)
  • The user should be prompted for a positive integer seed for the pseudo-random number generator. (1 - 65000)
  • Seed the random number generator with that positive integer.
  • Simulate the playing of the number of games the user entered, storing the number of times each of the possible winning combinations occured in an array that is being used as a counter. You should NOT display the results of each individual roll
  • Print out the number of occurrences of each of the winning possibilities as well as the number of losses.
  • Return to the Main Menu

• For play mode:
  
  • The program should seed the generator by using a call to time as in SetRandomSeed(). - This should happen only when play mode is first entered, not every pull of the handle.
  • The user should then be presented with the Play Menu which allows him/her to choose to read the instructions, pull the handle to play a round, or QUIT.
  • Your program should provide the user with an initial stake of $ 50 and then let the user play until either the money runs out or the user decides to quit. During each round, your program should take away a dollar, simulate the spinning of the wheels, evaluate the result, display the results of that round and add any winnings to the players money.
  • If a player has run out of money, then they can no longer play, and should be automatically returned to the main menu after being shown the results of the last round.

In slot.c, there should be functions named GiveInstructions() and PlaySlots(). There should definitely be a lot more functions than this in slot.c, but I will leave the design of the rest of the program to you.

You MUST store the results of each individual roll in an array of ints of size 3. (1 element for each of the wheels)

You should use many constants in this program. There are many menu choices, minima, maxima, array sizes, etc. all of which should have constants. You MUST use the following ones:

Sample Run

End of a Sample Run

Submitting the Program

To submit the file you should use the command:

submit cs201 Proj2 proj2.c util.c slot.c util.h slot.h

You can check your submission by using the command:

submitls cs201 Proj2