C-Language-Series-#157-Creating-a-Number-Guessing-Game

Welcome to installment #157 of our C Language Series! Today, we're embarking on a classic and engaging project: building a simple Number Guessing Game. This isn't just about creating a fun diversion; it's a powerful hands-on exercise that reinforces several fundamental C programming concepts, including random number generation, user input, loops, and conditional logic. By the end of this tutorial, you'll have a fully functional guessing game and a deeper understanding of how these core elements work together.

Let's dive in and create our interactive game!

Understanding the Game Logic

Before writing any code, it's always beneficial to outline the game's core mechanics. Our Number Guessing Game will follow these steps:

• The computer will secretly generate a random number within a predefined range (e.g., 1 to 100).
• The player will be prompted to guess this number.
• After each guess, the computer will provide feedback:
  • "Too low!" if the guess is less than the target number.
  • "Too high!" if the guess is greater than the target number.
  • "Congratulations! You guessed it!" if the guess is correct.
• The game continues, prompting for new guesses, until the player guesses correctly.
• The game should also keep track of how many attempts the player took.

Prerequisites and C Concepts Involved

To build this game, we'll primarily rely on:

• stdio.h: For standard input/output operations like printf() (to display text) and scanf() (to read user input).
• stdlib.h: For the rand() and srand() functions, essential for generating random numbers.
• time.h: Specifically, the time() function, which we'll use to seed our random number generator for better randomness.
• Variables: To store the target number, the player's guess, and the number of attempts.
• Loops: A while loop will keep the game running until the correct number is guessed.
• Conditional Statements: if-else if-else will be used to compare the guess with the target number and provide appropriate feedback.

Step-by-Step Implementation

1. Include Necessary Headers and Main Function

Every C program starts with includes and a main function. Let's set up our basic structure.

#include <stdio.h>  // For printf and scanf
#include <stdlib.h> // For rand and srand
#include <time.h>   // For time

int main() {
    // Game logic will go here
    return 0;
}

2. Generate a Random Number

This is crucial for our game. The rand() function generates a pseudo-random integer. To make it truly random each time the program runs, we need to "seed" it using srand(). A common practice is to seed it with the current time, which changes every second.

To get a number within a specific range (e.g., 1 to 100):

targetNumber = (rand() % 100) + 1;

• rand() % 100 gives a number between 0 and 99.
• Adding + 1 shifts the range to 1 to 100.

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main() {
    // Seed the random number generator
    srand(time(NULL));

    // Generate a random number between 1 and 100
    int targetNumber = (rand() % 100) + 1;

    printf("I have picked a secret number between 1 and 100.\n");
    printf("Can you guess what it is?\n");

    // For debugging, you can print the target number:
    // printf("DEBUG: The target number is %d\n", targetNumber); 

    return 0;
}

3. Initialize Variables

We'll need variables to store the player's guess and count their attempts.

    // ... (previous code)

    int guess;          // To store the player's current guess
    int numberOfAttempts = 0; // To count how many guesses the player makes

    // ... (rest of the main function)

4. Implement the Game Loop and Logic

Now, we'll use a while loop to repeatedly ask for a guess until the correct number is found. Inside the loop, we'll use if-else if-else to provide feedback.

#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main() {
    srand(time(NULL)); // Seed the random number generator
    int targetNumber = (rand() % 100) + 1; // Number between 1 and 100

    int guess;
    int numberOfAttempts = 0;

    printf("Welcome to the Number Guessing Game!\n");
    printf("I have picked a secret number between 1 and 100.\n");
    printf("Can you guess what it is?\n");

    // Game loop
    do { // Using do-while ensures the loop runs at least once
        printf("Enter your guess: ");
        scanf("%d", &guess);
        numberOfAttempts++;

        if (guess < targetNumber) {
            printf("Too low! Try again.\n");
        } else if (guess > targetNumber) {
            printf("Too high! Try again.\n");
        } else {
            printf("Congratulations! You guessed the number %d in %d attempts!\n", targetNumber, numberOfAttempts);
        }
    } while (guess != targetNumber); // Continue loop until guess is correct

    return 0;
}

A note on do-while: We use a do-while loop here because we want to execute the guessing logic at least once (prompt for input, read guess, provide feedback) before checking the condition to continue the loop.

Full C Code for the Number Guessing Game

Here's the complete, runnable code for our Number Guessing Game:

#include <stdio.h>  // Required for printf() and scanf()
#include <stdlib.h> // Required for rand() and srand()
#include <time.h>   // Required for time() to seed random number generator

int main() {
    // 1. Seed the random number generator
    //    Using time(NULL) ensures a different seed value each time the program runs,
    //    leading to a new sequence of "random" numbers.
    srand(time(NULL));

    // 2. Generate the target number
    //    (rand() % 100) produces numbers from 0 to 99.
    //    Adding + 1 shifts the range to 1 to 100.
    int targetNumber = (rand() % 100) + 1;

    // 3. Initialize game variables
    int guess;          // Stores the player's current guess
    int numberOfAttempts = 0; // Counts how many guesses the player has made

    // 4. Display introductory messages
    printf("Welcome to the C Number Guessing Game!\n");
    printf("I have selected a secret number between 1 and 100.\n");
    printf("Can you guess what it is?\n");

    // Optional: Uncomment the line below for debugging purposes
    // printf("DEBUG: The target number is %d\n", targetNumber);

    // 5. Game loop: Continue until the player guesses correctly
    do {
        // Prompt the player for their guess
        printf("\nEnter your guess: ");

        // Read the player's input
        // scanf returns the number of items successfully read.
        // We'll add error handling later for robustness.
        if (scanf("%d", &guess) != 1) {
            printf("Invalid input. Please enter a number.\n");
            // Clear the invalid input from the buffer
            while (getchar() != '\n'); 
            continue; // Skip to the next iteration of the loop
        }

        // Increment the attempt counter
        numberOfAttempts++;

        // Provide feedback based on the guess
        if (guess < targetNumber) {
            printf("Too low! Try again.\n");
        } else if (guess > targetNumber) {
            printf("Too high! Try again.\n");
        } else {
            // Player guessed correctly
            printf("\nCONGRATULATIONS! You guessed the number %d correctly!\n", targetNumber);
            printf("It took you %d attempts.\n", numberOfAttempts);
        }
    } while (guess != targetNumber); // Loop condition: continues as long as guess is not correct

    // 6. End of the program
    return 0;
}

Compilation and Execution

To compile and run your game:

1. Save the code above in a file named guessing_game.c.
2. Open a terminal or command prompt.
3. Navigate to the directory where you saved the file.
4. Compile the code using a C compiler (like GCC):

   gcc guessing_game.c -o guessing_game

5. Run the executable:

   ./guessing_game

You will then be able to play the game directly in your console!

Further Enhancements (Ideas for Expansion)

This basic game can be expanded in many ways. Here are a few ideas to challenge yourself:

• Limit Guesses: Introduce a maximum number of attempts and end the game if the player runs out of tries.
• "Play Again" Option: After the game ends, ask the player if they want to play another round without restarting the program.
• Difficulty Levels: Allow the player to choose a difficulty (e.g., easy: 1-50, medium: 1-100, hard: 1-1000).
• Input Validation: Implement more robust input validation to handle non-numeric input gracefully (as shown in the full code example).
• High Score Tracking: Save the best scores (fewest attempts) to a file.

Conclusion

Congratulations! You've successfully created a Number Guessing Game in C. This project demonstrates how to combine various fundamental C concepts – input/output, random number generation, loops, and conditional statements – into a complete, interactive program. It's a fantastic stepping stone for more complex game development and a solid way to practice your problem-solving skills in C.

Keep experimenting with the suggested enhancements to further deepen your understanding and creativity in C programming!