SysTutorials

Formatting Output with C++ cout

· updated April 11, 2026

C++ provides the <iomanip> header for controlling how data appears when printed to standard output. These manipulators give you precise control over formatting, alignment, precision, and radix.

Basic Manipulators

The most common manipulators are persistent (they remain active until changed) or stateless (they apply once and reset).

Width and Alignment:

#include <iostream>
#include <iomanip>

int main() {
    std::cout << std::setw(10) << "Name" << std::setw(10) << "Score" << '\n';
    std::cout << std::setw(10) << "Alice" << std::setw(10) << 95 << '\n';
    std::cout << std::setw(10) << "Bob" << std::setw(10) << 87 << '\n';
    return 0;
}

std::setw() sets the minimum field width for the next output only. By default, numeric values right-align and strings left-align within the field.

Use std::left and std::right to control alignment (these persist):

std::cout << std::left << std::setw(10) << "Name" 
          << std::right << std::setw(10) << "Score" << '\n';

Floating-Point Precision:

double pi = 3.14159265359;

std::cout << std::setprecision(3) << pi << '\n';        // 3.14
std::cout << std::fixed << std::setprecision(2) << pi << '\n';  // 3.14
std::cout << std::scientific << std::setprecision(2) << pi << '\n';  // 3.14e+00

Number Base:

int value = 255;

std::cout << std::dec << value << '\n';        // 255
std::cout << std::hex << value << '\n';        // ff
std::cout << std::oct << value << '\n';        // 377
std::cout << std::showbase << std::hex << value << '\n';  // 0xff

std::showbase adds the prefix (0x for hex, 0 for octal). This persists until you call std::noshowbase.

Fill Characters:

std::cout << std::setfill('*') << std::right 
          << std::setw(10) << 42 << '\n';  // ********42

The fill character persists across operations.

Practical Example: Tabular Output

Here’s a realistic scenario formatting a data table:

#include <iostream>
#include <iomanip>
#include <vector>

struct Record {
    std::string name;
    int id;
    double salary;
};

int main() {
    std::vector<Record> records = {
        {"Alice Johnson", 1001, 75000.50},
        {"Bob Smith", 1002, 68500.00},
        {"Charlie Brown", 1003, 82300.75}
    };

    std::cout << std::left 
              << std::setw(20) << "Name"
              << std::right 
              << std::setw(8) << "ID"
              << std::setw(15) << "Salary"
              << '\n'
              << std::setfill('-') << std::setw(43) << "" << '\n'
              << std::setfill(' ');

    for (const auto& r : records) {
        std::cout << std::left << std::setw(20) << r.name
                  << std::right 
                  << std::setw(8) << r.id
                  << "$" << std::setw(13) << std::fixed 
                  << std::setprecision(2) << r.salary
                  << '\n';
    }

    return 0;
}

Resetting Formatting

To reset all formatting flags to their default state:

std::cout.copyfmt(std::ios(NULL));

Or reset individual flags:

std::cout << std::noshowbase << std::defaultfloat << std::right;

std::defaultfloat (C++11) resets the floating-point format to the default.

Low-Level Control with setf()

For more granular control, use the flags directly:

std::cout.setf(std::ios::showpoint);  // Always show decimal point
std::cout.setf(std::ios::uppercase);  // HEX, not hex
std::cout.unsetf(std::ios::floatfield);  // Reset float formatting

Most use cases are better served by the manipulators, but this approach is useful when you need to test or manipulate flags programmatically.

Common Pitfalls

← All posts