Iostream: std::cout, std::cin, and std::endl

What is the iostream Library?

The iostream library is the part of the C++ standard library that lets your program display output to the screen and read input from the keyboard. You will use it in virtually every C++ program you write.

#include <iostream>

Understanding std::

The std:: prefix stands for "standard" and indicates these functions belong to the standard library namespace. Think of it as saying "use the standard version of cout" rather than any other version.

Output with std::cout

std::cout ([c]haracter [out]put) sends data to the screen:

Basic Output

std::cout << "Hello, World!";  // Output: Hello, World!
std::cout << 42;                // Output: 42
std::cout << 3.14159;           // Output: 3.14159

Chaining Output

Use multiple << operators to output several things:

// Output: The answer is 42 exactly.
std::cout << "The answer is " << 42 << " exactly.";

Variables in Output

int age{25};
int score{95};
// Output: You scored 95 points at age 25.
std::cout << "You scored " << score << " points at age " << age << ".";

Think for a moment

Input with cin

cin ([c]haracter [in]put) reads data from the keyboard:

Basic Input

int age{};
std::cout << "Enter your age: ";  // Output: Enter your age:
std::cin >> age;

Multiple Inputs

int x{};
int y{};
std::cout << "Enter two numbers: ";  // Output: Enter two numbers:
std::cin >> x >> y;  // User can type: 10 20

String Input

char grade{};
std::cout << "Enter your school grade: ";  // Output: Enter your school grade:
std::cin >> grade;    // Reads until whitespace

Line Endings: '\n' vs std::endl

To create a new line, use '\n' (the newline character):

std::cout << "First line" << '\n';   // Output: First line
std::cout << "Second line" << '\n';  // Output: Second line

You can also embed \n directly in string literals:

std::cout << "First line\n";   // Output: First line
std::cout << "Second line\n";  // Output: Second line
std::cout << "Third line (no extra << needed)\n";

Without Newlines

See what happens when we don't add newlines:

std::cout << "First line";    // Output: First line
std::cout << "Second line";   // Output: Second line
// Result: First lineSecond line (all runs together on one line!)

Notice how the output runs together without line breaks.

What About std::endl?

You may see code that uses std::endl instead of '\n':

std::cout << "First line" << std::endl;   // Works, but not preferred
std::cout << "Second line" << std::endl;  // Works, but not preferred

std::endl does two things:

1. Outputs a newline character
2. Flushes the output buffer (forces output to appear immediately)

Formatting Output

Spacing

std::cout << "Name: " << name << '\n';        // Output: Name: Alice
std::cout << "Age: " << age << " years" << '\n';  // Output: Age: 25 years

Multiple Lines

You can add multiple line of whitespace in the following manner.

// Output: Welcome to our program!
std::cout << "Welcome to our program!\n";
std::cout << '\n';  // Output: (blank line)
std::cout << '\n';  // Output: (blank line)

int age{};
// Output: Please enter your age:
std::cout << "Please enter your age:\n";
std::cin >> age;
// No new line needed when using std::cin

Note: you do not need to provide another new line when using std::cin, when you press enter it automatically moves to a new line.

Common Patterns

Prompt and Input

std::cout << "Enter value: ";
std::cin >> value;

Calculate and Display

int a{5};
int b{3};
int result{a + b};

// Output: 5 + 3 = 8
std::cout << a << " + " << b << " = " << result << '\n';

Looking Ahead: Other Input/Output Options

While std::cout and std::cin handle most basic input/output needs, C++ offers additional options for specific situations:

std::getline() - Reading Full Lines

std::cin >> stops reading at the first whitespace, but sometimes you want to read an entire line including spaces:

#include <iostream>
#include <string>

std::string fullName;
std::cout << "Enter your full name: ";
std::getline(std::cin, fullName);  // Reads entire line, including spaces

std::cout << "Hello, " << fullName << "!\n";
// Input: "John Smith" -> Output: Hello, John Smith!

Why use std::getline()?

• Reads complete sentences or phrases
• Handles spaces within the input
• Better for text that contains multiple words

When you'll learn more: Advanced input handling lessons will cover std::getline() in detail, including how to handle mixed input scenarios.

std::printf() - C-Style Output

std::printf() is an older output method inherited from the C language:

#include <iostream>
#include <cstdio>    // Needed for printf

int age{25};
double price{19.99};

std::printf("Age: %d\n", age);           // %d for integers
std::printf("Price: $%.2f\n", price);   // %.2f for 2 decimal places
std::printf("Hello %s!\n", "World");    // %s for strings

Why might you see std::printf()?

• Used in older C++ code
• Sometimes preferred for precise number formatting
• Common in C programming (which C++ is based on)
• Can be more concise for complex formatting

Modern C++ approach: std::cout is generally preferred because it's type-safe and more C++-style, but understanding std::printf() helps when reading existing code.

Quick Comparison

Output Buffering

What is Buffering?

When you use std::cout, your output doesn't always appear immediately on screen. Instead, it's stored in a buffer (temporary storage) and displayed later:

std::cout << "Hello";        // Might not appear immediately
std::cout << "World";        // Still might not appear
std::cout << std::endl;      // NOW both lines appear: HelloWorld

Why Use Buffering?

• Performance: Writing to screen is slow, so collecting output and writing it all at once is faster
• Efficiency: Less system calls mean better performance

Flushing the Buffer

std::endl does two things:

1. Adds a newline (\n)
2. Flushes (empties) the buffer, forcing output to appear

std::cout << "Immediate" << std::flush;  // Forces output without newline
std::cout << "With newline" << std::endl; // Forces output with newline

When Buffer Automatically Flushes

The buffer automatically empties when:

• Program ends
• Buffer becomes full
• You use std::endl or std::flush
• You read from std::cin (usually)

For now: Just remember that std::endl ensures your output appears when you expect it to!

Summary

The iostream library provides essential input/output capabilities for C++ programs:

Key Components:

• std:: - Standard library namespace prefix
• std::cout - Outputs data to the screen using << operator
• std::cin - Reads input from keyboard using >> operator
• '\n' - Newline character (preferred for most output)
• std::endl - Creates newline and flushes output buffer (use only when flushing is needed)

Essential Patterns:

#include <iostream>

// Output
std::cout << "Hello World!\n";

// Input
int age{};
std::cout << "Enter age: ";
std::cin >> age;

// Chaining
std::cout << "You are " << age << " years old.\n";

Remember: std::cout and std::cin are your primary tools for communicating with users - displaying results and gathering input.