最后,评论应写在一个有意义的方式的人不知道什么是代码。这是通常的情况下,程序员会说“很明显这是什么做的!我不会忘记这”。你猜怎么着?这不是明显的,你会惊讶地发现,你很快忘记。:)你(或其他人)会感谢你写什么,如何,为什么你在人类的语言代码。阅读个别代码行是很容易的。了解他们想完成什么目标不是。
总结:
在图书馆,程序,或功能水平,描述
在图书馆,程序,或功能,描述了如何
在语句层面,描述了为什么。
注释的代码
注释的代码段(暂时的)可以在一些情况下是有用的:
1)你工作在一个新的代码将不会编译,你需要运行的程序。编译器不会让你运行如果有编译错误。注释掉的进展代码允许程序编译,所以你可以运行它。
2)你想改变的方式,通过评论了个别代码行的执行你的计划。例如,你认为一个特定的函数调用你的程序崩溃。评述了函数调用和运行您的程序可能表明,功能是罪魁祸首。
在我们即将到来的例子,我们将提醒使用Visual Studio Express,他们需要开始他们的项目与#包括程序的入口点。”。然而,我们通常会评论这一行代码,因为它会导致编译其他的编译器错误。使用Visual Studio Express必须取消该行之前,他们编译。
我想评论作为一种“语言”的翻译方法。想象一下你正在学习另一种语言,如法语。当你学习法语,你显然不是要记住一切后一看学习你;会有,你会忘记等意义,除非你去了很多次的话。现在想象一下,你只部分地通过学习法语,但你去法国度假,强迫你说在大多数地方,你访问法国。理想的解决办法是把法国的英文字典,无论你去哪里。你不能说流利的法语,你必须使用法语的英语字典来帮助你理解在法国不同的句子。这就像是用C + + -英语词典来帮你记住在C++什么句子的意思。显然,这将是最终能够流利地讲C++很辛苦,所以评论有点像C++英文翻译。