【自学C++】C++注释

C++注释

C++注释教程

用于注解说明解释程序的文字就是注释，注释提高了代码的阅读性。同时，注释也是一个程序员必须要具有的良好编程习惯。我们应该首先将自己的思想通过注释先整理出来，再用代码去体现。

在 C++ 中，一旦程序中某部分内容被注释掉，则该内容将会被 C++ 解释器忽略，换句话说，此部分内容将不会被执行。

C++注释作用

注释不仅可以用来解释程序某些部分的作用和功能（用自然语言描述代码的功能），在必要时，还可以将代码临时移除，是调试程序的好帮手。

通常而言，合理的代码注释应该占源代码的 1/3 左右。

C++注释形式

C++ 提供了两种注释的形式行注释和块注释。

行注释

// 注释内容

说明

C++ 的行注释使用的是 //，将需要被注释的内容放在 // 后面即可。

块注释(多行注释)

/* 
* 注释内容
*/

说明

C++ 的块注释使用的 /**/，C++ 块注释就是可以一次注释多行代码，但块注释不可以嵌套使用。

案例

C++行注释

C++ 行注释只能用来注释单行代码

#include <iostream>
using namespace std;

int main(int argc, char **argv)
{
	//cout << "Hello 嗨客网(www.haicoder.net)" << endl;
	
	cout << "嗨客网(www.haicoder.net)" << endl;
    cout << "Hello HaiCoder" << endl;
    
	//cout << "嗨客网" << endl; 这是行注释，这里不会被执行
}

程序运行，控制台输出，如下图：

我们可以看到，我们的程序并没有输出第一句和最后一句，因为，这两句都被我们注释了，被注释的代码不会被执行。

C++块注释

C++ 块注释也可以用来注释单行代码

#include <iostream>
using namespace std;

int main(int argc, char **argv)
{
	/* cout << "www.haicoder.net" << endl; */
	
	cout << "嗨客网(www.haicoder.net)" << endl;
    cout << "Hello HaiCoder,Hello Mul Comment" << endl;
    
	/* cout << "嗨客网" << endl; 这是注释，这里不会被执行 */
}

程序运行，控制台输出，如下图：

我们可以看到，我们使用了 C++ 的多行注释也就是块注释，注释了单行代码。

C++块注释

C++ 块注释可以用来一次注释多行代码

#include <iostream>
using namespace std;

int main(int argc, char **argv)
{
	/* 
		cout << "www.haicoder.net" << endl; 
		cout << "嗨客网" << endl;
	*/
	
	cout << "嗨客网(www.haicoder.net)" << endl;
    cout << "Hello HaiCoder,Hello Mul Comment" << endl;
}

程序运行，控制台输出，如下图：

我们使用了块注释，一次性注释了两行代码。

C++块注释

C++ 块注释不可以嵌套

#include <iostream>
using namespace std;

int main(int argc, char **argv)
{
	/* 
		cout << "www.haicoder.net" << endl; 
		cout << "嗨客网" << endl;
		
		/*这里是嵌套注释*/
	*/
	
	cout << "嗨客网(www.haicoder.net)" << endl;
    cout << "Hello HaiCoder,Hello Mul Comment" << endl;
}

程序运行，控制台输出，如下图：

我们可以看到，运行时直接报错，因为块注释是不支持嵌套的。

C++注释总结

C++ 注释分为单行注释和块注释，其中单行注释可以嵌套，块注释不可以嵌套。