编码标准Word文档下载推荐.docx
- 文档编号:19214055
- 上传时间:2023-01-04
- 格式:DOCX
- 页数:9
- 大小:29.31KB
编码标准Word文档下载推荐.docx
《编码标准Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《编码标准Word文档下载推荐.docx(9页珍藏版)》请在冰豆网上搜索。
4.序言性注释格式3/4
附录
头注释样例1/4(附)
1.目的
编码是以程序设计时做成的程序规范书、流程等逻辑设计书为基础。
在编码时,为减少在编码水平上的个人差异、顺利地进入单体试验阶段,以及便于进行调试和提高维护效率,特制定本标准。
本标准作为代码的书写标准,其主要目的在于统一程序设计的记述风格,培养良好的编码习惯,使代码记述清晰、明确,具有良好的可读性。
良好的编码习惯可以帮助程序员避开不必要的语法或语义错误,对出现的错误迅速定位。
另外,良好的编码习惯还有助于在编码过程中对程序的设计思路进行验证和提示。
本规范作为编码的通常标准,希望每个人都可以通过按此规范进行编码,提高程序的可读性、可修改性及维护的效率。
如果程序由用户指定记述标准或使用(半)自动生成工具时,可适当遵循其标准。
2.编码的注意事项
(1)认真分析理解系统设计书、程序设计书(有时也包括流程图)。
在很好地理解上述文件的基础上编码(特别是在程序设计书与编码的担当者不同时)。
对于不明确之处不可随意判断,应确认后再进行。
(2)要注意把编制容易理解(易读)的程序放到第一位。
在头脑中要经常考虑程序的读者,按照向读者说明的方式来写是一个窍门。
读起来容易理解的程序一般质量都比较好、修改维护也容易。
(3)在编码的过程中发现了设计上的问题时,要向上追溯到系统设计书/程序设计书。
不可轻易地判断,而应经设计者确认。
(4)关于数据库的记录规范等的包含文件、模块头、宏等,要采用系统统一的规定。
个人不可随意地制作。
否则就会为以后修改、改造造成困难。
(5)在编码结束后,要对编码重查。
不可未经充分的重查而随便进入下一步测试阶段。
编码重查作为最简便的故障检查手段,也是非常有效的手段,有时可以检查出在试验工程中不能全部检查出的复杂的错误。
3.编码风格
编码的目标首先是清晰正确,其次才是程序的效率。
以下是在编程时应遵守规则。
(1)合理使用goto语句。
合理使用goto语句可以提高代码的运行效率,但goto语句的使用会破坏程序的结构特性,因此要限制使用的范围。
(2)用括号体现优先级和嵌套的层次。
用括号体现优先级和嵌套的层次可使程序更清晰,并且能够有效地避免二义性。
(3)利用标准书写格式提高程序的可读性。
a.用分层缩进显示嵌套结构的层次。
b.每行只写一条语句。
c.在注释段的周围加边框。
d.在注释段与程序段以及不同程序段之间插入空行。
(4)命名规则。
命名应有实际意义,一般格式为:
前缀+由形容词、名词或动词组成的词组。
前缀由使用的语言决定。
(5)适当的注释。
适当的注释能提高程序的可读性,但过多的注释不但不能提高程序的可读性,还会降低效率,因此注释一定要适当。
注释分为序言性注释和功能性注释两种。
在文件头、模块头、函数和过程的头部的注释属于序言性注释。
包括以下几部分内容:
a.功能描述。
对所执行的功能进行简略的介绍。
b.接口描述。
简述各输入参数和返回值。
c.数据描述。
简述用到的重要变量、结构和文件等。
d.履历描述。
包括设计者、日期和版本,文件头还包括版权声名。
功能性注释嵌在源程序内部用来描述处理功能。
(6)输入数据的检查。
所有输入数据都应经过检查。
(7)变量使用前要赋初值。
(8)错误处理。
一定要对可能出现的错误进行处理,以避免故障引起停机。
4.序言性注释格式(头注释)
头注释可以大致分为文件注释、模块注释、数据注释等。
在写注释时推荐使用以下格式。
(1)文件注释(文件头),文件注释记述以下信息
(a)文件识别信息
¯
系统名(主模块时)
✷程序名或模块名
✷版本信息(包括时间)
所属(从属模块时)
✷担当
✷著作权声明
(b)文件说明信息
✷简介
功能说明(主要模块说明)
操作环境
H/W,PLATFORM,OS,MEMORY等
编译、连接信息
makefile名,命令过程文件名,编译、连接选项(Option),应连接的装配模块文件名,子程序库名等
(c)文件维护信息
版本,日期,作者所属部门名,作者姓名,补充说明等
✷创建信息
更改记录
(d)其它
系统使用说明(主模块时)
注意事项
文件管理工具的附加信息
需要特别说明的信息
SYSTEM
✷PROGRAM/MODULE
✷VERSION
MASTERMODULE
✷AUTHOR
✷COPYRIGHT
✷ABSTRACT/PURPOSE
FUNCTION
ENVIRONMENT
MAKEOPTION
✷CREATE
UPDATE
USAGE
NOTE
SPECIALINFO
说明:
“”表示标准项目,“”表示可选项目。
(2)模块注释(模块头)。
模块注释对了解模块的概要非常有效,而且在维护时也同样有效,所以一定要记述。
模块注释记述以下信息
✷模块名
模块编号
版本信息
功能说明
影响
返回值
参数说明
担当
创建信息
✷MODULE
ID
VERSION
✷ABSTRACT
SIDE-EFFECT
RETURN
ARGUMENT
AUTHOR
CREATE
(3)数据注释
数据注释用来帮助对数据结构或数据表、数组等内容的理解。
✷标识符名(用于标识符定义)
✷数据结构名称
✷数据类型
✷TAG
✷DATA
✷DATA-TYPE
附录:
头注释样例
以下为C语言源文件的注释样例
1.主模块文件头(程序的主模块,生成命令程序。
)
/***************************************************************/
/**/
/*系统:
系统名*/
/*用户:
用户名*/
/*程序:
程序名-标题*/
/*担当部门:
XXXX*/
/*YYYY*/
/*(C)CopyrightShenyangNETSintegrationCorporation1996*/
/*AllRightsReserved.*/
/*VERSIONDATEBYCHANGE/COMMENT*/
/*VX.00YY-MM/DD姓名Create*/
/*VX.XXYY-MM/DD姓名更改概要、更改理由*/
/*功能概略:
功能概略*/
/*异常处理:
异常处理*/
/*调用方法:
*/
/*程序名Arg1Arg2*/
/*参数说明:
/*I/0参数名内容*/
/*IArg1内容说明*/
/*IArg2内容说明*/
/*适用计算机:
计算机类型、型号*/
/*OS:
OS名称(版本)*/
/*大小:
内存MB*/
/*交换MB*/
/*编译:
编译系统名称(版本)*/
/*连接信息:
连接信息*/
/*请注意:
未经许可,不可擅自使用、转载本内容的一部分或全部。
*/
2.模块文件头(从属模块)
系统名*/
用户名*/
/*模块:
模块名-标题*/
/*所属:
主模块名或程序名*/
XXXX*/
/*YYYY*/
/*(C)CopyrightShenyangNETSIntegrationCorporation1996*/
/*VERSIONDATEBYCHANGE/COMMENT*/
/*VX.00YY-MM/DD姓名Create*/
/*VX.XXYY-MM/DD姓名更改概要、更改理由*/
/*调用顺序:
/*intI1*/
/*:
/*char01*/
/*sts=(&
I1,....,&
01);
/*I/0变量名内容*/
/*II1内容说明*/
/*I01内容说明*/
/*0STS内容说明*/
编译系统(版本)*/
连接信息*/
3.文件头例
/*
*Copyright1994-1995MicrosoftCorporation.AllRightsReserved.
*PROGRAM:
winprog.c
*
*PURPOSE:
Windowsprogram.
*PLATFORMS:
Windows95
*FUNCTIONS:
*WinMain()-callsinitializationfunction,processesmessageloop
*InitApplication()-Initializeswindowdatandregisterswindow
*InitInstance()-savesinstancehandleandcreatesmainwindow
*MainWindProc()Processesmessages
*About()-Processmenssagesfor"
About"
dialogbox
4.模块头1
*MODULE:
main
*VERSION:
1.1
*ABSTRACT:
mainfunctionofprogram
*FUNCTION:
functionofmain
*ARGUMENT:
*argccountofcommandlineargument
*argv[]commandlineargument
*RETURN:
*0normalend
*1abnormalend
*SIDE-EFFECT:
*NOTE:
*CREATE:
96-07Nets1
*UPDATE:
96-08Nets2
*thereason
96-09Nets3
5.模块头2
/**/
模块名-标题*/
功能概略*/
6.类型声明
*TAG:
DemoStruct
DemoInformationStorageStructure
Thestructisonlyusedasademonstration
7.数据定义
*DATA:
DemoData
*DATA-TYPE:
DemoSruct
DemoInformationStorage
Thedataisonlyusedasademonstration
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 编码 标准
![提示](https://static.bdocx.com/images/bang_tan.gif)