谁知道如何写注释

来源：学生作业帮助网编辑：作业帮时间：2024/11/07 19:23:56

谁知道如何写注释
谁知道如何写注释

谁知道如何写注释
介绍你一个小知识吧(说是小知识,不过关系重大)
一般我们所说的注释都是针对函数(也就是方法),因为函数是模块化设计的最小单元(类还不算最小单元)
一个函数意味着一个功能,所以,函数的注释至少要有两条:
这个叫做'前导条件',建议在方法的开头注明,像这样 :
void xxx() {
//pre :前导条件}不是所有的函数都具有前导,有的函数可以在任何情况下得到正确结果,比如加法之类的.
所以,有时候,前导条件可以省略不写
这个叫做'后置条件',建议在方法的结尾注明,像这样 :
void xxx() {
//post :后置条件}所有的函数都具有后置条件.因为一个函数被调用之后肯定会造成影响,否则这个函数就没有存在地意义.
一定要写明每一个函数的后置条件.
3.函数当中如果用到了公式或者定理,要在注释当中用了那条定理或者公式,最好能付上公式或者定理的简要说明.(当然,如果是勾股定理这种简单的,不说也可以)
4.如果某一段代码是顺序不能颠倒的,要注明,像这样:
...;
#隔一行//处理XXX//sequence dependent
//1st :xxx
.;
//2nd :xxx
...;
//3rd :xxx
...;
#隔一行
注意 :在写代码的时候写的注释才有价值,如果在代码已经写完才来补注释,那么就不要再补了,把要写的写进文档就可以.
注释要求记录程序员写程序时候的思维过程这里提到的只是我个人的编码习惯,主要是介绍一下写注释需要注意的一些细节.

谁知道如何写注释谁知道论文如何写? 谁知道在keil4中如何注释中文吗?输入中文就变成了方框,如图谁知道的原文+注释+赏析? 谁知道如何写好规范字谁知道如何写欢迎辞谁知道如何写社团活动总结报告? eplan注释如何显示? pdf注释如何消除 javadoc注释如何生成 solidworks注释如何注释在下划线下 WORD 里如何加入小字符号的注释啊?写论文的注释是要小的阿拉伯数字怎么搞出来啊根据注释写词语为何要写注释? 《卖柑者言》的注释谁知道《卖柑者言》的注释啊? mathematica中如何写注释就是计算机不执行的句子, 如果在论文中引用了硕士学位论文,注释该如何写的课文,翻译和注释~谁知道