C++ Program To Change The Colour Of Console

This article will guide you through various methods to change the text color in the C++ console. You will learn how to make your console applications more visually appealing and user-friendly by highlighting important information with different colors.

Problem Statement

Standard console output in C++ is typically monochrome, which can make it challenging to distinguish different types of messages, such as errors, warnings, or successful operations. For example, a lengthy log file displayed in the console might be difficult to parse quickly without visual cues. Enhancing readability through colored text can significantly improve user experience and debugging efficiency in command-line applications.

Example

Imagine a simple program where an error message is displayed in bright red, while a success message is shown in green.

This is a regular message.
Error: File not found!
Success: Operation completed.

This visual distinction immediately draws attention to critical information, unlike plain white text.

Background & Knowledge Prerequisites

To follow this article, you should have:

• Basic C++ knowledge: Familiarity with std::cout, main function, and basic data types.
• Operating System awareness: Understanding that console behavior can vary between Windows, Linux, and macOS.
• For Windows-specific solutions: Basic understanding of Windows API functions and including .

Use Cases or Case Studies

Changing console color is highly beneficial in several scenarios:

• Error Reporting: Displaying error messages in red makes them immediately noticeable in logs or interactive applications, guiding users or developers to critical issues.
• Status Indicators: Showing success messages in green or warnings in yellow can provide clear feedback on the outcome of an operation.
• Debugging Tools: Highlighting variable values or specific execution paths during debugging sessions helps in quicker problem identification.
• Game Development (Text-based): Creating simple text-based games with colored characters or backgrounds enhances the visual experience.
• Command-Line Utilities: Improving the output of custom scripts or tools, making their results easier to interpret at a glance.

Solution Approaches

There are primarily two robust approaches to changing console color in C++, each with its own advantages and platform compatibility.

1. Using SetConsoleTextAttribute on Windows

This method utilizes the Windows API to directly manipulate console text attributes. It offers precise control over foreground and background colors.

• One-line summary: Directly sets the console's text and background color attributes using Windows API functions.

// Windows Console Color Example
#include <iostream>
#include <windows.h> // Required for Windows API functions

int main() {
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE); // Get handle to console

    // Step 1: Set text color to red
    SetConsoleTextAttribute(hConsole, FOREGROUND_RED | FOREGROUND_INTENSITY);
    std::cout << "This text is red and intense." << std::endl;

    // Step 2: Set text color to green
    SetConsoleTextAttribute(hConsole, FOREGROUND_GREEN);
    std::cout << "This text is green." << std::endl;

    // Step 3: Set text color to yellow (red + green)
    SetConsoleTextAttribute(hConsole, FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_INTENSITY);
    std::cout << "This text is yellow and intense." << std::endl;

    // Step 4: Reset to default console colors (typically white on black)
    SetConsoleTextAttribute(hConsole, FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE); // White
    std::cout << "This text is back to default white." << std::endl;

    return 0;
}

Run

• Sample Output:

This text is red and intense.
This text is green.
This text is yellow and intense.
This text is back to default white.

*(Note: The actual colors will be displayed in the console window.)*

• Stepwise Explanation:

1. Include : This header provides access to Windows-specific API functions, including those for console manipulation.
2. GetStdHandle(STD_OUTPUT_HANDLE): This function retrieves a handle to the standard output device (the console). This handle is necessary to interact with the console.
3. SetConsoleTextAttribute(hConsole, attributes): This is the core function.
   • hConsole: The handle obtained in the previous step.

attributes: A combination of bit flags defining the foreground and background colors.

Foreground colors: FOREGROUND_RED, FOREGROUND_GREEN, FOREGROUND_BLUE. Combining these using the bitwise OR operator (|) creates other colors (e.g., FOREGROUND_RED | FOREGROUND_GREEN for yellow).

Intensity: FOREGROUND_INTENSITY brightens the foreground color. Similarly, BACKGROUND_RED, BACKGROUND_GREEN, BACKGROUND_BLUE, and BACKGROUND_INTENSITY exist for background colors.

1. Resetting Color: To return to the default console colors (usually white text on a black background), you typically set the foreground to a combination of red, green, and blue (FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE).

2. Using ANSI Escape Codes (Cross-platform)

ANSI escape codes are special character sequences that terminals interpret as commands to change formatting, including text color. These are widely supported on Linux, macOS, and modern Windows terminals (Windows 10 and later).

• One-line summary: Prints special character sequences (\033[...]) to the console, which are interpreted by the terminal to change text attributes.

// ANSI Escape Codes Console Color Example
#include <iostream>

int main() {
    // Step 1: Print red text
    std::cout << "\\033[31m" << "This text is red." << std::endl; // 31 = Red Foreground

    // Step 2: Print green text
    std::cout << "\\033[32m" << "This text is green." << std::endl; // 32 = Green Foreground

    // Step 3: Print yellow text (using bold/bright for effect)
    std::cout << "\\033[1;33m" << "This text is bold yellow." << std::endl; // 1 = Bold, 33 = Yellow Foreground

    // Step 4: Print blue background with white text
    std::cout << "\\033[44;37m" << "Blue background, white text." << std::endl; // 44 = Blue Background, 37 = White Foreground

    // Step 5: Reset to default colors
    std::cout << "\\033[0m" << "This text is back to default." << std::endl; // 0 = Reset all attributes

    return 0;
}

Run

• Sample Output:

This text is red.
This text is green.
This text is bold yellow.
Blue background, white text.
This text is back to default.

*(Note: The actual colors and bolding will be displayed in a compatible terminal.)*

• Stepwise Explanation:

1. Escape Sequence Format: ANSI escape codes begin with \033[ (or \x1B[). \033 is the ASCII escape character.
2. Color Codes:
   • 30-37: Standard foreground colors (e.g., 31m for red, 32m for green).

40-47: Standard background colors (e.g., 44m for blue background).

90-97: Bright foreground colors.

100-107: Bright background colors.

1. Attribute Codes:
   • 0m: Reset all attributes (most important for returning to default).

1m: Bold/Bright.

2m: Faint (decreased intensity).

3m: Italic.

4m: Underline.

1. Combining Codes: Multiple codes can be combined with semicolons (e.g., \033[1;33m for bold yellow foreground).
2. Placement: The escape sequence is simply printed to std::cout before the text you want to color. The color change persists until another escape code modifies it or \033[0m resets it.

Conclusion

Changing console color in C++ applications significantly enhances readability and user experience. For Windows-specific development, the SetConsoleTextAttribute function from the Windows API provides robust control. For cross-platform compatibility across Linux, macOS, and modern Windows terminals, ANSI escape codes are the preferred and more portable solution. Choosing the right approach depends on your target operating systems and the level of control required.

Summary

• SetConsoleTextAttribute (Windows): Uses and HANDLE for direct console attribute manipulation. Offers fine-grained control over foreground/background colors and intensity.
• ANSI Escape Codes (Cross-platform): Utilizes special character sequences (\033[...]) interpreted by most modern terminals (Linux, macOS, modern Windows). Portable but requires terminal compatibility.
• Best Practice: Always reset colors to default after printing colored text to avoid affecting subsequent output.
• Use Cases: Improves error reporting, status indicators, debugging, and overall visual appeal of console applications.