Setting Up C++ and Your First Program

What Is It?

Setting Up Your C++ Environment

Before you can write and run C++ programs, you need two things: a text editor or IDE to write code, and a compiler to convert your code into an executable program. Unlike Python or JavaScript where you can run code with just an interpreter, C++ requires compilation -- your source code must be translated into machine code before it can run.

This chapter walks you through installing a C++ compiler on any operating system, setting up an editor, and writing your very first program. By the end, you will be able to write, compile, and run C++ programs from your terminal.

What You Need

Why Does It Matter?

Why Does Setup Matter?

Many beginners skip environment setup and use online compilers exclusively. While online compilers are fine for learning basics, understanding the local setup process is critical for several reasons:

1. Real-World Development

No professional developer uses an online compiler. Real projects have multiple files, libraries, build systems (Make, CMake), and debuggers. Setting up a local environment teaches you the fundamentals of how software development actually works.

2. Competitive Programming

In competitions like ICPC and Google Code Jam, you often code locally and submit files. A properly configured local setup with fast compilation and testing saves crucial minutes during contests.

3. Debugging

Online compilers give you limited error information. A local setup with a debugger (GDB, LLDB) lets you step through code line by line, inspect variables, and find bugs efficiently.

4. Understanding the Toolchain

Knowing what g++ does, what flags it accepts, and how compilation works makes you a better programmer. When you get a "linker error" or "undefined reference," you will know what it means and how to fix it.

Detailed Explanation

Detailed Explanation

Installing g++ on Different Platforms

Windows (MinGW-w64)

Windows does not come with a C++ compiler. The most popular free option is MinGW-w64, which provides g++ for Windows:

1. Download the MinGW-w64 installer from https://www.mingw-w64.org/ or install via MSYS2.
2. During installation, select x86_64 architecture and posix threads.
3. Add the bin directory to your system's PATH environment variable (e.g., C:\mingw64\bin).
4. Open Command Prompt and verify: g++ --version.

Alternatively, install via MSYS2: run pacman -S mingw-w64-x86_64-gcc in the MSYS2 terminal.

macOS

macOS provides Clang (which is compatible with g++) via Xcode Command Line Tools:

1. Open Terminal and run: xcode-select --install
2. Verify: g++ --version (this actually invokes Clang on macOS, but it is fully compatible)

Linux (Ubuntu/Debian)

Most Linux distributions have g++ available in their package manager:

1. Open Terminal and run: sudo apt update && sudo apt install g++
2. Verify: g++ --version

Compiling from the Terminal

The basic compilation command is:

g++ filename.cpp -o outputname

This compiles filename.cpp and creates an executable called outputname. To run it:

• Linux/macOS: ./outputname
• Windows: outputname.exe or just outputname

Useful g++ flags:

IDEs and Editors for C++

Anatomy of a C++ Program

Every C++ program has a specific structure. Let us break down each part:

1. #include <iostream>

This is a preprocessor directive. It tells the preprocessor to include the contents of the <iostream> header file. This header provides cout (console output), cin (console input), endl (newline + flush), and other I/O facilities. Without this line, you cannot use any of these.

2. using namespace std;

The C++ standard library puts everything inside the std namespace to avoid name conflicts. Without this line, you would need to write std::cout, std::cin, std::endl everywhere. The using namespace std; directive imports all names from the std namespace into the global scope, so you can write just cout.

3. int main()

This is the entry point of every C++ program. When you run the executable, execution starts from the first line inside main(). The int return type means main returns an integer to the operating system. return 0; means success; any non-zero value means an error occurred.

4. Statements and Semicolons

Every statement in C++ must end with a semicolon (;). This is how the compiler knows where one statement ends and the next begins. Forgetting a semicolon is the single most common syntax error for beginners.

5. Comments

C++ supports two types of comments:

• // Single-line comment: everything after // on that line is ignored by the compiler.
• /* ... */ Multi-line comment: everything between /* and */ is ignored, even across multiple lines.

6. cout and the Insertion Operator (<<)

cout stands for "character output" and sends data to the standard output (your terminal). The << operator is called the insertion operator because it inserts data into the output stream. You can chain multiple << operators to output several values in sequence.

7. cin and the Extraction Operator (>>)

cin stands for "character input" and reads data from the standard input (your keyboard). The >> operator is called the extraction operator because it extracts data from the input stream and stores it in a variable. cin >> reads until the first whitespace character (space, tab, or newline).

8. endl vs \n

Both endl and '\n' produce a newline. The difference: endl also flushes the output buffer, forcing all buffered data to be written immediately. '\n' just adds a newline without flushing. In competitive programming, use '\n' because buffer flushing is slow when done repeatedly.

9. Case Sensitivity

C++ is case-sensitive. Main is not the same as main. Cout is not the same as cout. Int is not the same as int. Every keyword and identifier must match its exact casing.

Code Examples

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, World!" << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    // Separate cout statements
    cout << "Name: Rohan" << endl;
    cout << "Age: 20" << endl;

    // Chaining multiple values in one cout
    cout << "Branch: " << "CSE" << ", Year: " << 3 << endl;

    // Mixing strings and expressions
    cout << "2 + 3 = " << 2 + 3 << endl;

    return 0;
}

#include <iostream>
using namespace std;

int main() {
    int age;
    string name;
    float gpa;

    cout << "Enter your name: ";
    cin >> name;

    cout << "Enter your age: ";
    cin >> age;

    cout << "Enter your GPA: ";
    cin >> gpa;

    cout << "\nHello, " << name << "!" << endl;
    cout << "Age: " << age << ", GPA: " << gpa << endl;

    return 0;
}

#include <iostream>
using namespace std;

// This is a single-line comment
// The compiler ignores everything after //

/*
  This is a multi-line comment.
  It can span multiple lines.
  Useful for explaining complex logic
  or temporarily disabling blocks of code.
*/

int main() {
    // Print a greeting
    cout << "Welcome to C++" << endl;  // inline comment

    /* cout << "This line is commented out"; */

    return 0;
}

#include <iostream>

int main() {
    std::cout << "Method 1: Using std:: prefix" << std::endl;

    // You can also import specific names
    using std::cout;
    using std::endl;

    cout << "Method 2: Selective using" << endl;

    return 0;
}

#include <iostream>
using namespace std;

int main() {
    int a, b, c;

    cout << "Enter three numbers separated by spaces: ";
    cin >> a >> b >> c;

    cout << "You entered: " << a << ", " << b << ", " << c << endl;
    cout << "Sum: " << a + b + c << endl;
    cout << "Average: " << (a + b + c) / 3.0 << endl;

    return 0;
}

#include <iostream>
using namespace std;

int main() {
    cout << "Newline: Hello\nWorld" << endl;
    cout << "Tab: Col1\tCol2\tCol3" << endl;
    cout << "Backslash: C:\\Users\\Priya" << endl;
    cout << "Double quote: She said \"Hello\"" << endl;
    cout << "Single quote: It\'s working" << endl;
    cout << "Null character size: " << sizeof('\0') << endl;

    return 0;
}

Common Mistakes

#include <iostream>
using namespace std;

int main() {
    cout << "Hello" << endl
    cout << "World" << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    cout << "Hello" << endl;
    cout << "World" << endl;
    return 0;
}

#include <iostream>
using namespace std;

int Main() {
    cout << "Hello" << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    cout << "Hello" << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    string name;
    cout << "Enter your full name: ";
    cin >> name;  // Only reads first word!
    cout << "Hello, " << name << endl;
    return 0;
}

#include <iostream>
#include <string>
using namespace std;

int main() {
    string name;
    cout << "Enter your full name: ";
    getline(cin, name);  // Reads the entire line
    cout << "Hello, " << name << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    string name = "Kavya";
    cout << name << endl;
    return 0;
}

#include <iostream>
#include <string>
using namespace std;

int main() {
    string name = "Kavya";
    cout << name << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    cout << 'Hello' << endl;
    return 0;
}

#include <iostream>
using namespace std;

int main() {
    cout << "Hello" << endl;
    return 0;
}

Summary