C++ Primer Chapter 1: Compiling a Simple C++ Program

Chapter 1 serves as the “gateway” to C++, with the core goal of helping readers establish a basic understanding of C++ programs—from “what is a C++ program” to “how to write, compile, and run a simple program”. It also introduces fundamental concepts such as input and output, comments, variables, and functions, laying the groundwork for subsequent chapters.

1.1 Writing a Simple C++ Program

This section demonstrates the basic structure of a C++ program through the classic “Hello, World” program (a common introductory example in programming languages), while explaining “how the program interacts with the operating system” and “the execution flow of the code”.

1.1.1 The First Program: Outputting “Hello, World”

First, let’s look at the complete code, then break it down line by line:

#include <iostream>  // Header file inclusion
int main() {         // Program entry point: main function
    std::cout << "Hello, World!" << std::endl;  // Output statement
    return 0;        // Function return value
}

Line-by-line Code Analysis

#include <iostream>: Header file inclusion

#include is a C++preprocessor directive (starting with#, processed by the “preprocessor” before compilation), which serves to “copy the contents of the specified header file into the current code”.
<iostream> is the C++ standard library’sinput-output stream header file, which definesstd::cout (standard output),std::cin (standard input), and other core components—this header file must be included to use input-output functionality.
Note: C++ standard library header filesdo not have a.h suffix (e.g.,<iostream> instead of<iostream.h>); header files with.h suffixes (like<stdio.h>) belong to the C standard library or older versions of the C++ library. Modern C++ recommends using the standard header files without suffixes.

int main(): The unique entry point of the program

int: Thereturn type of the function, indicating thatmain() will return an “integer” to the operating system upon completion.
main: The function name (fixed, cannot be modified).
(): The parentheses contain theparameter list, which is empty here, indicating thatmain() does not accept parameters (it can also be written asint main(void)<code>, which has the same effect).
{}: The curly braces contain thefunction body, which is the code to be executed (code statements must be placed within the function body).

main() is themandatory entry function of a C++ program—regardless of how many other functions the code has, the program will always executemain()<code> first, and a program can only have one<code>main()<code> function (having more will result in a compilation error).
Function structure analysis:

std::cout << "Hello, World!" << std::endl;: Output statement

std::cout: “standard output stream” (cout is an abbreviation for “console output”), belonging to thestd namespace (which will be explained in detail in section 1.2), and must be prefixed withstd:: to be used.
<<: “output operator” (also called “insertion operator”), which serves to “insert the content on the right into the stream on the left”—here, it inserts the string"Hello, World!" into thestd::cout stream, which is ultimately displayed on the console.
"Hello, World!": string literal (a sequence of characters enclosed in double quotes), which is the content to be output.
std::endl: “newline character” (endl is an abbreviation for “end line”), which serves two purposes: ① outputs a newline in the console (allowing subsequent content to be displayed on a new line); ② flushes the output buffer (ensuring the content is displayed immediately, avoiding delays due to the buffer not being full).
;: Thestatement terminator in C++—any executable statement must end with;<code>, otherwise a compilation error will occur (this is a clear distinction between C++ and languages like Python, Java, etc.).

This is thestandard output statement in C++, which serves to print content to the “console” (such as the command prompt in Windows or the terminal in Linux).
Meaning of each part:

return 0;: Function return value

Returning0 indicates “the program ended normally”—this is a convention established by the operating system (0 corresponds to “success status code”).
If a non-zero value is returned (e.g.,return 1;), it indicates “the program ended abnormally” (non-zero values represent “error status codes”, with different values indicating different error types for the operating system or other programs to determine the cause of the error).

return is thereturn statement in C++, which serves to “end the current function and return the specified value to the caller”.
For themain() function:
Note: The C++11 standard allows themain() function to omitreturn 0;—in this case, the compiler will automatically addreturn 0; at the end of themain()<code> function body, but for clarity, it is recommended to write it explicitly.

1.1.2 Compiling and Running the Program

C++ is acompiled language, meaning that the code cannot be run directly; it must go through the steps of “compilation → linking” to generate an executable file before it can be run. Taking Windows (using the MinGW compiler) and Linux (using the GCC compiler) as examples, the process is as follows:

1. Save the Code

Save the above “Hello, World” code as a file, with the file name extension being.cpp (the standard extension for C++ source files; you can also use.cc or.cxx, but.cpp<code> is the most common), for example,<code>hello.cpp.

2. Compile (Convert Source File to Object File)

Open the terminal/command prompt, navigate to the directory where the code is located, and execute the compilation command:

Windows (MinGW):g++ hello.cpp -o hello.exe
Linux (GCC):g++ hello.cpp -o hello

g++: The C++ compiler (GNU Compiler Collection’s C++ compiler).
hello.cpp: The source file to be compiled.
-o hello.exe/-o hello: Specifies the name of the generated “target executable file” (with the .exe suffix in Windows, and no suffix in Linux).

3. Run the Executable File

Windows: Typehello.exe in the command prompt and press enter; the console will displayHello, World!.
Linux: Type./hello in the terminal (./ indicates “current directory”), press enter, and the terminal will displayHello, World!.

Common Compilation Errors

Forgetting to write;: The compiler will prompt “syntax error before ‘}’ token” (syntax error before the closing brace).
Omittingstd::: For example, if you writecout << ..., it will prompt “‘cout’ was not declared in this scope” (cout is not declared in the current scope).
Incorrect file name extension: For example, using.c (the C language extension) may cause the compiler to compile according to C language rules, leading to errors with C++ features likestd::cout.