C++中的注释(Comment)是一种代码内嵌的文档形式,仅仅为人们阅读代码提供说明,被编译器完全忽略。所有注释会在词法分析阶段移除,并替换为空格字符。
虽然C++标准未规定注释的具体内容格式,但是有些某些外部工具可以解析代码中遵循特定内容格式的注释,形成特定格式的文档。
C++中的注释有两种语法形式:
- C风格(C-style)注释,也称多行(multi-line)注释,主要用于大块的注释内容。
/* comment */ - C++风格(C++-style)注释,也称单行(single-line)注释,用于简单的一行注释,也可连续多个形成多行注释。//之后至行尾换行符之间的内容被认定为注释内容。
// comment注:在预处理阶段之前,注释被移除。所以,宏无法用于生成注释。同样的,如果头文件中存在没有结尾*/的C风格注释,也不会影响#include此头文件的源文件其他部分内容。
