号名的命名 a符号名即标识符,包括模块名、 变量名、常量名、标号名、子程 序名、、数据区名以及缓冲区名 等 这些名字应能反映它所代表的实 际东西,应有一定实际意义。 a例如,表示次数的量用Tmes,表 示总量的用Ttal,表示平均值的 用 average,表示和的量用Sum等
符号名的命名 符号名即标识符,包括模块名、 变量名、常量名、标号名、子程 序名、 、数据区名以及缓冲区名 等。 这些名字应能反映它所代表的实 际东西,应有一定实际意义。 例如,表示次数的量用Times,表 示总量的用Total,表示平均值的 用Average,表示和的量用Sum等
0名字不是越长越好,应当选择精炼的 意义明确的名字。必要时可使用缩写 名字,但这时要注意缩写规则要一致 并且要给每一个名字加注释。同时 在一个程序中,一个变量只应用于一 种用途。 D NEWBALANCEACCOUNTS PAYABLE D NBALLAP
名字不是越长越好,应当选择精炼的 意义明确的名字。必要时可使用缩写 名字,但这时要注意缩写规则要一致, 并且要给每一个名字加注释。同时, 在一个程序中,一个变量只应用于一 种用途。 NEW.BALANCE.ACCOUNTS.PAYABLE NBALAP N
程序的注隆 0夹在程序中的注释是程序员与日后 的程序读者之间通信的重要手股。 0注释决不是可有可无的。 0一些正规的程序文本中,注释行的 数量占到整个源程序的1/3到1/2 甚至更多。 0注释分为序言性注释和功能性注释
程序的注释 夹在程序中的注释是程序员与日后 的程序读者之间通信的重要手段。 注释决不是可有可无的。 一些正规的程序文本中,注释行的 数量占到整个源程序的1/3到1/2, 甚至更多。 注释分为序言性注释和功能性注释
席言性注 通常置于每个程序模块的开头部分 窍应当飴H程席的体说明,对于 增解程序本身具有引导作用。有些 软件开发部门对序言性注释做了明 确而严的规定,要求程序編制者 逐项列出 a有关项目包括 0序标题
序言性注释 通常置于每个程序模块的开头部分, 它应当给出程序的整体说明,对于 理解程序本身具有引导作用。有些 软件开发部门对序言性注释做了明 确而严格的规定,要求程序编制者 逐项列出。 有关项目包括: 程序标题;
口有关本模块功能和目的的说阻; 口主要算法 0接口说阻:包括调用形式,参数描 述,子程序清单; 0有关数据描述:重要的变量及其用 制条件,以及其3有 关信息 摸块位置:在哪一个源文件中,或 属于哪一个软件包 0开发简历:模块设计者,复审者 复审日期 旧期及有关说明等
有关本模块功能和目的的说明; 主要算法; 接口说明:包括调用形式,参数描 述,子程序清单; 有关数据描述:重要的变量及其用 途,约束或限制条件,以及其它有 关信息; 模块位置:在哪一个源文件中,或 隶属于哪一个软件包; 开发简历:模块设计者,复审者, 复审日期,修改日期及有关说明等