(6)显式地声明一切变量 Int a, b, c, float x, y, Z, (7)对变量最好作出注释说明其含义 int sum; /sum:统计每行空格数 int total sum;/ total sum:统计空格总数
(6)显式地声明一切变量 int a,b,c; float x,y,z; (7)对变量最好作出注释说明其含义 int sum; /*sum:统计每行空格数*/ int total_sum; /* total_sum :统计空格总数*/
2)程序的注解要适当 在正规的程序文件中,注解行的数量占整个源程序的 1/5到1/3,甚至更多。只有代码,没有注解的程序是不可 取的。 (1)序言性注解 序言性注解通常位于每个程序模块的开头部分, II 量量a量量量■ 它应当给出该模块的整体说明, Maino 模块名称、功能、主要算法、接口特点、 重要数据、开发简史
2)程序的注解要适当 在正规的程序文件中,注解行的数量占整个源程序的 1/5到1/3,甚至更多。只有代码,没有注解的程序是不可 取的。 (1)序言性注解 序言性注解通常位于每个程序模块的开头部分, 它应当给出该模块的整体说明, 模块名称、功能、主要算法、接口特点、 重要数据、开发简史。 ……………… ……………… Main() {
(2)功能性注解 功能性注解应插入在源程序体中,用以描述其后的语句 是在做什么工作,主要解释包含这段代码的必要性和提供 些额外的信息。 如: Totalsum= Totalsum+Sum/*把每行的空格数累加到总空格数中 应该用空格和空行清楚地区分注解和程序 注解的内容一定要正确,是最新式的。(程序修改后, 必须修改注解)
(2)功能性注解 功能性注解应插入在源程序体中,用以描述其后的语句 是在做什么工作,主要解释包含这段代码的必要性和提供一 些额外的信息。 如:TotalSum= TotalSum +Sum /* 把每行的空格数累加到总空格数中*/ 应该用空格和空行清楚地区分注解和程序。 注解的内容一定要正确,是最新式的。(程序修改后, 必须修改注解)
3)视觉组织 ◆空格、空行和缩进(阶梯式)。 FOR i=l to m FOR j=I TO n ENDFOR ENDFOR ◆颜色:关键字,注解 FORi=1TOm循环
3)视觉组织 ♣ 空格、空行和缩进(阶梯式)。 FOR i=1 TO m FOR j=1 TO n P=i*j ENDFOR ENDFOR ♣ 颜色:关键字,注解 FOR i=1 TO m /*循环
2.数据说明 1)数据说明的次序应当规范化 原则上,数据说明的次序与语法无关,其次序是 任意的。但出于阅读、理解和维护的需要最好使其 规范化,使说明的先后次序固定 例如,常量说明、类型说明、全程量说明、局部量说明。 在类型说明中还可按如下顺序排列: 整型量→实型量→字符量→逻辑量说明
2.数据说明 1)数据说明的次序应当规范化 原则上,数据说明的次序与语法无关,其次序是 任意的。但出于阅读、理解和维护的需要最好使其 规范化,使说明的先后次序固定。 例如,常量说明、类型说明、全程量说明、局部量说明。 在类型说明中还可按如下顺序排列: 整型量→实型量→字符量→逻辑量说明