从今天开始,和大家一起学习C++帮助手册
注释
注释是一种代码内文档,当被插入到程序中时,它们实际上会被编译器忽略;它们只需要被阅读源代码的人当做注记。
语法
(1) /*注释 */
(2) // 注释
1)通常被称为C风格或者多行注释
2)通常被称为C++风格或者单行注释
在翻译阶段3中,每段注释通过被替换为单个空白字符从程序中删除。
C风格
C风格注释通常用于注释大块的文本,也可以用于注释单行文本,要插入一个C风格注释,可以简单的以 /* 和 / 环绕文本,这样会使注释的内容被编译器忽视。尽管不是C++标准的一部分,/* 和*/用于指示文档块,这是合法的。
C++风格
C++风格注释通常用于注释单行文本,不过也可以使用多个//来注释多行的文本。C++风格注释告诉编译器忽视//和换行符之间的内容。
注意:
因为注释在预处理阶段以及被移除,所以宏不能用于组成注释,而且未终止的C风格注释不会从被#include的文件中漏出。除了把代码注释掉之外,用于排除源码的其他机制还有:
#if 0
std::cout << "这一行话不会被执行,甚至不会被编译" << endl;
#endif
以及
if (false)
{
std::cout << "这一句话不会被执行" << endl;
}