注释
来自 cppreference.cn
< cpp
注释用作代码内文档的一种形式。当插入到程序中时，它们实际上会被编译器忽略；它们的目的仅仅是供阅读源代码的人类用作注释。虽然具体的文档不是 C++ 标准的一部分，但存在几种实用程序，可以解析具有不同文档格式的注释。
内容 |
[编辑] 语法
/* 注释 */ |
(1) | ||||||||
// 注释 |
(2) | ||||||||
1) 通常称为“C 风格”或“多行”注释。
2) 通常称为“C++ 风格”或“单行”注释。
所有注释都在翻译阶段 3 从程序中删除，方法是将每个注释替换为单个空白字符。
[编辑] C 风格
C 风格注释通常用于注释大段文本，但是，它们也可以用于注释单行。要插入 C 风格注释，只需用 /* 和 */ 包围文本；这将导致注释的内容被编译器忽略。虽然它不是 C++ 标准的一部分，但 /** 和 */ 通常用于指示文档块；这是合法的，因为第二个星号只是被视为注释的一部分。C 风格注释不能嵌套。
[编辑] C++ 风格
C++ 风格注释通常用于注释单行，但是，多个 C++ 风格注释可以放在一起以形成多行注释。C++ 风格注释告诉编译器忽略 // 和换行符之间的所有内容。
[编辑] 注解
由于注释在预处理器阶段被删除，因此宏不能用于形成注释，并且未终止的 C 风格注释不会从 #include'd 文件中溢出。
除了注释掉之外，用于源代码排除的其他机制是
#if 0 std::cout << "this will not be executed or even compiled\n"; #endif
和
if (false) { std::cout << "this will not be executed\n"; }
[编辑] 示例
运行此代码
#include <iostream> /* C-style comments can contain multiple lines */ /* or just one */ /************** * you can insert any *, but * you can't make comments nested */ // C++-style comments can comment one line // or, they can // be strung together int main() { // comments are removed before preprocessing, // so ABC is "1", not "1//2134", and "1 hello world" // will be printed #define ABC 1//2134 std::cout << ABC << " hello world\n"; // The below code won't be run // return 1; // The below code will be run return 0; }
输出
1 hello world
[编辑] 参见
| C 文档 关于 comment
|
