C++启蒙之注释标记

在我们的措施变得更巨大之前，我们先看看C++是如那里理惩罚注释的。注释可以辅佐人们阅读措施。在典范环境下，它们用于总结算法、表白变量的目标或澄清其它一些恍惚的代码片断。注释不会增加可执行措施的巨细。编译器会忽略所有注释。

在C++中有两种范例的注释：单行注释和成对注释。单行注释以双斜线（//）开头。同一行中斜线右侧的所有内容都是注释，会被编译器略过。

另一个脱离符是注释标记对（/* */），它担任自C语言。这种注释以/*开始，以*/末了。编译器把/*和*/之间的部门都作为注释来处理惩罚：

#include <iostream>
/* 简朴的main函数： 读入两个数字并输出功效 */
int main()
{
　// 提示用户输入数字
　std::cout << "Enter two numbers:" << std::endl;
　int v1, v2; // 初始化了的
　std::cin >> v1 >> v2; // 读取输入
　return 0;
}

注释标记对可以安排在答允输入tab、空格或新行的任那里所。注释标记对可以超过措施的多个行，可是不是必需这样做的。当注释标记对没有超过多个行，凡是表白内部行是多行注释的一部门。我们的样式是每行以星号开始，因此表白整个范畴都是多行注释的部门。

典范环境下措施包括多种注释形式。注释标记对凡是用做多行表明，而双斜线注释倾向于半行或单行注释。

措施中殽杂了太多的注释大概使代码杂乱。凡是在要表明的代码上方安排注释。

跟着代码的改变，注释也应该保持更新。措施员但愿注释是准确的，而且很相信它们，纵然其它形式的系统文档逾期了。不正确的注释比没有注释尚有糟糕，因为它会误导随后的阅读者。

注释标记对不能嵌套

以/*开始的注释凡是以*/竣事。其功效是一个注释标记对不能呈此刻另一个之中。这类措施错误导致的编译器错误动静大概难以领略。譬喻，在你的系统上编译下面的措施：

#include <iostream>
/*
* 注释标记对 /* */ 不能嵌套。
* "不能嵌套" 会被认为是源代码的一部门
*/
int main()
{
　return 0;
}

当你注释一大段措施的时候，看起来把注释标记对放在你但愿姑且略过的部门是最容易的。问题是假如那段代码已经有了注释标记对，那么新插入的注释将过早地终止。姑且忽略一段代码的更好的步伐是利用编辑器在但愿忽略的代码的每一行前面插入单行注释。利用这种要领的时候，你就不必担忧本身注释的代码是否包括注释标记对。