参数是输入参数还是输出参数。）【访问变量】（必需。列出该函数访问的全局变量、成员变量。）【返回值】（
can shu shi shu ru can shu hai shi shu chu can shu fang wen bian liang bi xu lie chu gai han shu fang wen de quan ju bian liang cheng yuan bian liang fan hui zhi
*******************【函数名称】（必需）【函数功能】（必需）【参数】（必需。标明各
******************* han shu ming cheng bi xu han shu gong neng bi xu can shu bi xu biao ming ge
**************************************************
**************************************************
的信息使用函数。格式不做具体要求。●在函数的定义之前，要给出足够的注释。注释格式要求如下：/****
de xin xi shi yong han shu ge shi bu zuo ju ti yao qiu zai han shu de ding yi zhi qian yao gei chu zu gou de zhu shi zhu shi ge shi yao qiu ru xia /****
则规则描述：●在函数的声明之前，要给出精练的注释（不必牵扯太多的内部细节），让使用者能够快速获得足够
ze gui ze miao shu zai han shu de sheng ming zhi qian yao gei chu jing lian de zhu shi bu bi qian che tai duo de nei bu xi jie rang shi yong zhe neng gou kuai su huo de zu gou
码边注释，修改代码的同时修改相应的注释，保证代码与注释的一致性。2.2.1对函数进行注释规范级别：规
ma bian zhu shi xiu gai dai ma de tong shi xiu gai xiang ying de zhu shi bao zheng dai ma yu zhu shi de yi zhi xing 2.2.1 dui han shu jin hang zhu shi gui fan ji bie gui
供明确的指导。下面是关于注释的基本原则：1．注释内容要清晰明了，含义准确，防止出现二义性。2．边写代
gong ming que de zhi dao xia mian shi guan yu zhu shi de ji ben yuan ze 1 zhu shi nei rong yao qing xi ming le han yi zhun que fang zhi chu xian er yi xing 2 bian xie dai
是程序与日后的程序读者之间通信的重要手段。良好的注释能够帮助读者理解程序，为后续阶测智商段进行测试和维护提
shi cheng xu yu ri hou de cheng xu du zhe zhi jian tong xin de zhong yao shou duan liang hao de zhu shi neng gou bang zhu du zhe li jie cheng xu wei hou xu jie ce zhi shang duan jin hang ce shi he wei hu ti
har *s;//而应该写成这样char* s;2.2注释这一部分对程序注释提出了要求。程序中的注释
har *s;// er ying gai xie cheng zhe yang char* s;2.2 zhu shi zhe yi bu fen dui cheng xu zhu shi ti chu le yao qiu cheng xu zhong de zhu shi
“*”、“&”和类型写在一起。测智商理由：统一格式，提高代码的可读性。举例:// 不要象下面这样写代码：c
* & he lei xing xie zai yi qi ce zhi shang li you tong yi ge shi ti gao dai ma de ke du xing ju li :// bu yao xiang xia mian zhe yang xie dai ma c
2.1.10将作符“*”、“&”和类型写在一起规范级别：规则规则描述：在定义指针、引用变量时，将作符
2.1.10 jiang zuo fu * & he lei xing xie zai yi qi gui fan ji bie gui ze gui ze miao shu zai ding yi zhi zhen yin yong bian liang shi jiang zuo fu
em;//最好写成这样result = ((fact / 100) * number) + rem;
em;// zui hao xie cheng zhe yang result = ((fact / 100) * number) + rem;
的可读性。举例:// 下面这测智商行代码：result = fact / 100 * number + r
de ke du xing ju li :// xia mian zhe ce zhi shang hang dai ma result = fact / 100 * number + r
二元、三元作符作的作数的两边，应该放置“（”和“）”。理由：避免出现不明确的运算、赋值顺序，提高代码
er yuan san yuan zuo fu zuo de zuo shu de liang bian ying gai fang zhi he li you bi mian chu xian bu ming que de yun suan fu zhi shun xu ti gao dai ma
idth, le测智商ngth;2.1.9在表达式中使用括号规范级别：建议规则描述：对于一个表达式，在一个
idth, le ce zhi shang ngth;2.1.9 zai biao da shi zhong shi yong kuo hao gui fan ji bie jian yi gui ze miao shu dui yu yi ge biao da shi zai yi ge
的可读性。举例：// 应该这样写int width;int length;// 不要这样写int w
de ke du xing ju li // ying gai zhe yang xie int width;int length;// bu yao zhe yang xie int w
、定义一个变量规范级别：规则规则描述测智商：一次（一条声明、定义语句）只声明、定义一个变量。理由：提高代码
ding yi yi ge bian liang gui fan ji bie gui ze gui ze miao shu ce zhi shang yi ci yi tiao sheng ming ding yi yu ju zhi sheng ming ding yi yi ge bian liang li you ti gao dai ma
该这样写代码x = x0;y = y0;while(isok(x)){x++;}2.1.8一次只声明
gai zhe yang xie dai ma x = x0;y = y0;while(isok(x)){x++;}2.1.8 yi ci zhi sheng ming
例：// 测智商不要这样写x = x0; y = y0;while(isok(x)) {x++;}// 应
li // ce zhi shang bu yao zhe yang xie x = x0; y = y0;while(isok(x)) {x++;}// ying
2.1.7 一行只写一条语句规范级别：规则规则描述：一行只写一条程序语句。理由：提高代码的可读性。举
2.1.7 yi hang zhi xie yi tiao yu ju gui fan ji bie gui ze gui ze miao shu yi hang zhi xie yi tiao cheng xu yu ju li you ti gao dai ma de ke du xing ju