====== 第一个 C++ 程序的关键记号 ======
下面这段代码是 C++ 的入门程序,我们借它认识各个组成部分:
#include
using namespace std;
int main()
{
cout << "Hello World" << endl;
return 0;
}
===== 逐项解释 =====
^ 记号 ^ 含义 ^
| %%#%% | 预处理指令的引导符。以 %%#%% 开头的行由**预处理器**在编译前处理,它不是 C++ 语句,所以行尾**不写分号**。 |
| %%include%% | 预处理指令之一,意思是"把另一个文件的内容原样插入到这里"。%%#include %% 就是引入输入输出相关的声明。 |
| %%%% | C++ 标准库头文件,名字来自 input output stream(输入输出流),其中声明了 cout、cin、endl 等。尖括号表示到系统标准库目录里查找;若写成双引号,则先查找当前目录,用于自己编写的头文件。 |
| %%using%% | 关键字,"使用某个名字/命名空间",让后面写代码时不必再加前缀。 |
| %%namespace%% | 关键字,**命名空间**。用来给一批名字分组,避免不同库里的同名函数互相冲突。 |
| %%std%% | **standard** 的缩写,C++ 标准库的所有名字都放在名为 %%std%% 的命名空间里。%%using namespace std;%% 的作用是:以后写 %%cout%% 就等同于写 %%std::cout%%。 |
| %%int%% | 关键字,**整数类型**(integer)。%%int main()%% 表示 %%main%% 函数执行完毕后返回一个整数。 |
| %%cout%% | **c**onsole **out**put,标准输出流对象,默认输出到屏幕(控制台)。 |
| %%<<%% | **流插入运算符**(也称"输出运算符")。把右边的内容"送进"左边的流里,可连续使用:%%cout << a << b%% 等价于 %%(cout << a) << b%%。注意不要与位运算的左移混淆——这里是重载之后的语义。 |
| %%endl%% | **end line**,意为"结束本行":输出一个换行符 %%\n%%,**并刷新输出缓冲区**(立刻把内容真正送到屏幕)。只想要换行也可以直接写 %%"\n"%%,差别就在于是否强制刷新。 |
| %%return%% | 关键字,从函数返回一个值给调用者。%%return 0;%% 表示 %%main%% 正常结束;返回非 0 通常用来表示程序出错(操作系统可以读到这个值)。 |
===== 容易混淆的地方 =====
* ''#'' 那一行末尾没有分号,而 C++ 语句末尾必须有 '';''——这是初学者最常犯的错误。
* ''main'' 是程序的入口,操作系统从这里开始执行;它的返回值类型是 ''int''。
* ''using namespace std;'' 虽然省事,但在大型项目中通常不推荐(容易引起命名冲突);更稳妥的写法是直接使用 ''std::cout''。
* ''cout'' 和 ''endl'' 都属于 ''std'',所以要么写 ''using namespace std;'',要么老老实实写 ''std::cout''、''std::endl''。
===== 深入:这些记号的定义在哪些文件里 =====
这些"定义"其实是三类东西,位置完全不同:
^ 记号 ^ 归属 ^ 在本机哪里能看到 ^
| ''#''、''include'' | 预处理器(cpp)的行为,不是 C++ 语言本身 | 编译器自带:GCC 源码 gcc/libcpp/,其中 [[英语单词:directives]].cc 负责处理 include、define 这类指令,init.cc 负责初始化;概念说明见 GCC 手册 The C Preprocessor |
| ''int''、''return''、''namespace''、''using'',以及对内置类型使用的 %%<<%% | C++ 语言的关键字与语法 | 没有对应的头文件,由 G++ 前端识别:GCC 源码 gcc/cp/,lex.cc 管词法、parser.cc 管语法;权威定义是 ISO/IEC 14882 标准 |
| ''iostream'' | 标准库头文件 | /usr/include/c++/13/iostream(13 是你的 GCC 主版本号) |
| ''std'' | 命名空间 | 头文件里是用宏 %%_GLIBCXX_BEGIN_NAMESPACE_VERSION%% 进入的,宏定义在 bits/c++config.h,展开后是 namespace std 加上一个内联的 ABI 版本命名空间 |
| ''cout'' | 头文件里只有 extern 声明,对象实体在库里 | 声明在 /usr/include/c++/13/iostream;实体在 libstdc++ 源码 libstdc++-v3/src/c++98/globals.cc,二进制形式在 libstdc++.so.6 |
| ''endl''、对流对象使用的 %%<<%% | 函数模板与运算符重载 | /usr/include/c++/13/ostream,模板实现在 bits/ostream.tcc |
===== 在本机定位它们 =====
# 1. 版本与头文件搜索路径(顺带得到主版本号 13)
g++ --version
echo '#include ' | g++ -x c++ -E -v - 2>&1 >/dev/null \
| sed -n '/search starts here:/,/End of search list/p'
# 搜索结果
#include "..." search starts here:
#include <...> search starts here:
/usr/lib/gcc/x86_64-redhat-linux/10/../../../../include/c++/10
/usr/lib/gcc/x86_64-redhat-linux/10/../../../../include/c++/10/x86_64-redhat-linux
/usr/lib/gcc/x86_64-redhat-linux/10/../../../../include/c++/10/backward
/usr/lib/gcc/x86_64-redhat-linux/10/include
/usr/local/include
/usr/include
End of search list.
依次cd,查找iostream文件,最后:
# 2. 打开入口头文件。它很小,只是把活分派出去
less /usr/include/c++/10/iostream
看到这里看不下去了,没有得到什么有营养的东西,只是知道这些指令都是代码形成的就行了
# 3. 继续往下钻
grep -n 'endl' /usr/include/c++/13/ostream
grep -n 'operator<<' /usr/include/c++/13/ostream | head
grep -n '_GLIBCXX_BEGIN_NAMESPACE_VERSION' /usr/include/c++/13/bits/c++config.h | head
# 4. 看预处理展开后的真实代码(很长,务必配合 grep)
echo '#include ' | g++ -E -x c++ - | grep -n 'namespace std' | head
# 5. 头文件之间的包含链
g++ -H -c test.cpp 2>&1 | head -40
# 6. cout 的实体确实在动态库里
nm -DC /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep -E 'std::cout|std::endl'
# 7. g++ 背后真正干活的编译器前端
g++ -print-prog-name=cc1plus
''iostream'' 的内容大致如下,可以看到 ''cout'' 只是一个 extern 声明:
#include
#include
#include
namespace std _GLIBCXX_VISIBILITY(default)
{
_GLIBCXX_BEGIN_NAMESPACE_VERSION
extern istream cin;
extern ostream cout;
extern ostream cerr;
extern ostream clog;
static ios_base::Init __ioinit;
}
===== 拿到源码与标准原文 =====
# Debian / Ubuntu:先装头文件,再取完整源码(需启用 deb-src)
sudo apt install libstdc++-13-dev
apt-get source gcc-13
# Fedora / RHEL
sudo dnf download --source gcc
# 上游源码(体积很大,建议浅克隆)
git clone --depth 1 https://gcc.gnu.org/git/gcc.git
# 标准库头文件与实现:libstdc++-v3/include/、libstdc++-v3/src/
# C++ 前端与预处理器:gcc/cp/、gcc/libcpp/
* libstdc++ 手册与 Doxygen 源码浏览:[[https://gcc.gnu.org/onlinedocs/libstdc++/]]
* C++ 标准草案(条款号与正式标准一致,可全文搜索):[[https://eel.is/c++draft/]]
* 头文件速查:[[https://en.cppreference.com/w/cpp/header/iostream]]
===== 建议的阅读顺序 =====
1. bits/c++config.h
先弄清 _GLIBCXX_BEGIN_NAMESPACE_VERSION 这类宏,后面满屏的宏才不至于吓人。
2. iostream -> ostream -> bits/ostream.tcc
看 cout、endl、operator<< 的声明与各自的模板实现。
3. ios_base::Init 与 libstdc++-v3/src/c++98/globals.cc
理解 cout 为什么在 main 之前就已经可用。
4. gcc/libcpp/directives.cc
看 include 这类指令究竟是预处理器里哪段代码消费掉的。
```mdk height=480
# 第一个 C++ 程序
## 预处理 `#include `
- `#` 预处理引导符,行尾不加分号
- `include` 引入头文件
- `` 输入输出流标准库;尖括号=系统目录,双引号=当前目录
## `using namespace std;`
- `using` 使用某个名字
- `namespace` 命名空间,避免命名冲突
- `std` 标准库命名空间
- 不写 using 就得用 `std::cout`
## `int main()`
- `int` 整数类型
- `main` 程序入口,操作系统从这里开始
- `return 0;` 返回 0 表示正常结束
## `cout << "Hello World" << endl;`
- `cout` 标准输出对象,输出到屏幕
- `<<` 流插入运算符,可连续使用
- `endl` 换行并刷新缓冲区(`"\n"` 只换行)
## 易错点
- `#include` 行不写分号,语句必须写分号
- `cout`、`endl` 属于 `std`
- 大型项目建议直接写 `std::cout`
```