某系统集成公司编码标准概述

1、编码标准批准人刘岩审核人崔戈拟制人刘慧丰批准日期1999.5. 12生效日期19995. 12关联文件沈阳东东系统集成有限公司更改记录序号发行日更改对象更改内容批准审查拟制01999. 5. 12新发行刘岩崔戈刘慧丰目 录1 .目的2/42 .编码的注意事项2/43 .编码风格2/44 .序言性注释格式3/4附录头注释样例1/4（附）L目的编码是以程序设计时做成的程序规范书、流程等逻辑设计书为基础。在编码时，为减少在编码水平上的 个人差异、顺利地进入单体试验阶段，以及便于进行调试和提高维护效率，特制定本标准。本标准作为代码的书写标准，其主要目的在于统一程序设计的记述风格，培养良好的编码习惯，使

2、代码 记述清晰、明确，具有良好的可读性。良好的编码习惯可以帮助程序员避开不必要的语法或语义错误，对出 现的错误迅速定位。另外，良好的幽迺睁助于在编码过程中对程序的设计思路进行验证和提示。本规范作为编码的通常标准，|希望每个人|都可以通过按此规范进行编码,提高程序的可读性、可修改性 及维护的效率°如果程序由用户指定记述标准或使用(半)自动生成工具时，可适当遵循其标准。2 .编码的注意事项(1)认真分析理解系统设计书、程序设计书(有时也包括流程图)。在很好地理解上述文件的基础上编码 (特别是在程序设计书与编码的担当者不同时)。对于不明确之处不可随意判断，应确认后再进行°(2)要

3、注意把编制容易理解(易读)的程序放到第一位。在头脑中要经常考虑程序的读者，按照向读者说 明的方式来写是一个窍门。读起来容易理解的程序一般质量都比较好、修改维护也容易，(3)在编码的过程中发现了设计上的问题时，要向上追溯到系统设计书/程序设计书。不可轻易地判断, 而应经设计者确认。(4)关于数据库的记录规范等的包含文件、模块头、宏等，要采用系统统一的规定。个人不可随意地制作。 否则就会为以后修改、改造造成困难。(5)在编码结束:后，要对编码重查。不可未经充分的重查而随便进入下一步测试阶段,编码重查作为最简 便的故障检查手段，也是非常有效的手段，有时可以检查出在试验工程中不能全部检查出的复杂的错误

4、。3.编码风格编码的目标首先是清晰正确，其次才是程序的效率。以下是在编程时应遵守规则。(1)合理使用goto语句。合理使用got。语句可以提高代码的运行效率，但goto语句的使 用会破坏程序的结构特性，因此要限制使用的范围。(2)用括号体现优先级和嵌套的层次。用括号体现优先级和嵌套的层次可使程序更清晰，并 且能够有效地避免二义性。(3)利用标准书写格式提高程序的可读性。a.用分层缩进显示嵌套结构的层次。b.每行只写一条语句。c.在注释段的周围加边框。d.在注释段与程序段以及不同程序段之间插入空行。(4)命名规则。命名应有实际意义，一般格式为：前缀+由形容词、名词或动词组成的词组。 前缀由使用的

5、语言决定。a.功能描述。b.接口描述。C.数据描述。d.履历描述。(5)适当的注释。适当的注释能提高程序的可读性，但过多的注释不但不能提高程序的可读 性，还会降低效率，因此注释一定要适当。注释分为序言性注释和功能性注释两种。在文件头、 模块头、函数和过程的头部的注释属于序言性注释。包括以下儿部分内容： 对所执行的功能进行简略的介绍。简述各输入参数和返回值。简述用到的重要变量、结构和文件等。包括设计者、日期和版本，文件头还包括版权声名。功能性注释嵌在源程序内部用来描述处理功能。(6)输入数据的检查。所有输入数据都应经过检查。(7)变量使用前要赋初值。(8)错误处理。一定要对可能出现的错误进行处理

6、，以避免故障引起停机。4.序言性注释格式（头注释）头注释可以大致分为文件注释、模块注释、数据注释等。（1）文件注释（文件头），文件注释记述以下信息文件识别信息* 系统名（主模块时）* 程序名或模块名* 版本信息（包括时间）* 所属（从属模块时）* 担当* 著作权声明（b）文件说明信息* 简介* 功能说明（主要模块说明）* 操作环境H/W, PLATFORM, OS, MEMORY 等* 编译、连接信息make file名，命令过程文件名，编译、连接选 项（Option）,应连接的装配模块文件名，子程 序库名等（C）文件维护信息版本，日期，作者所属部门名，作者姓名，补充说在写注释时推荐使用以下格

7、式。* SYSTEM* PROGRAMAdODULE* VERSION柒 MASTER MODULE* AUTHOR* COPYRIGHT* ABSTRACT/PURPOSE* FUNCTION* ENVIRONMENT* MAKE OPTION*柒法*明等* 创建信息* 更改记录（d）其它* 系统使用说明（主模块时）* 注意事项* 文件管理工具的附加信息 需要特别说明的信息说明：“事”表示标准项目，“柒”表示可选项目。（2）模块注释（模块头），模块注释对了解模块的概要非常有效, 要记述。模块注释记述以下信息* 模块名* 模块编号* 版本信息* 简介* 功能说明* 影响* 注意事项* 返回值*

8、 参数说明* 担当* 创建信息柒更改记录CREATE UPDATEUSAGENOTESPECIAL INFO而且在维护时也同样有效，所以一定MODULEIDVERSIONABSTRACTFUNCTIONSIDE-EFFECTNOTERETURNARGUMENTAUTHORCREATEUPDATE说明：“事”表示标准项目，“米”表示可选项目。（3）数据注释数据注释用来帮助对数据结构或数据表、数组等内容的理解C* 标识符名（用于标识符定义）* 数据结构名称* 数据类型* 简介兴注意事项TAG DATA DATA-TYPE ABSTRACT NOTE说明：“事”表示标准项目，“米”表示可选项目。编号

9、：时间：2021年X月X日书山有路勤为径，学海无涯苦作舟 页码：第5页共11页第10页共11页附录：头注释样例以下为c语言源文件的注释样例*/*/1 .主模块文件头（程序的主模块,生成命令程序。）/*/*系统：系统名*/*用户：用户名*/*程序：程序名-标题*/*担当部门：XXXX*/*YYYY*/* (C)Copyright Shenyang NETS integration Corporation 1996All Rights Reserved./*/*/*VERSION DATEVX.00 YY-MM/DDBYCHANGE/COMMENT姓名 Create*/*/*VX.XX YY-MM

10、/DD姓名更改概要、更改理由*/*/*功能概略：功能概略*/*异常处理：异常处理*/*调用方法：*/*程序名Argl Arg2*/*参数说明：*/*I/O参数名内容*/*IArgl内容说明*/*IAra2内容说明*/*适用计算机：计算机类型、型号*/*OS：OS名称（版本）*/*大小：内存MB*/*交换MB*/*编译：编译系统名称（版本）*/*连接信息：连接信息*/*/*/*请注意：未经许可，不可擅自使用、转载本内容的一部分或全部。*/*/*/2 .模块文件头(从属模块)CHANGE/COMMENTCreate更改概要、更改理由*/*/*/*/*/*系统：系统名*/*用户：用户名*/*模块：模

11、块名-标题*/*所属：主模块名或程序名*/*担当部门:XXXX*/*YYYY*/* (C)Copyright Shenyang NETS Integration Corporation 1996*/*All Rights Reserved.*/* VERSION DATE BY/*VX.00 YY-MM/DD 姓名/* VX.XX YY-MM/DD 姓名/*/*功能概略：功能概略 */*异常处理：异常处理 */*调用顺序：*/*int11*/*/*char01*/*sts = (&IL.,&01);*/*参数说明：*/*I/O变量名内容*/*III内容说明*/*/*I01内容说

12、明*/*0STS内容说明*/*适用计算机:计算机类型、型号*/*OS：OS名称（版本）*/*编译：编译系统（版本）*/*连接信息：连接信息*/*/*请注意：未经许可，不可擅自使用、转载本内容的一部分或全部。*/*/3 .文件头例 /* Copyright 1994-1995 Microsoft Corporation. All Rights Reserved.* PROGRAM:winprog.c* PURPOSE:Windowsprogram.* PLATFORMS:Windows 9512 FUNCTIONS:WinMain() - calls initialization functio

13、n, processes message loop3 InitApplicationO - Initializes window data nd registers window4 InitlnstanceO -saves instance handle and creates main window5 MainWindProcO Processes messages6 About() - Process menssages for “About” dialog box */4 .模块头1/*MODULE:main*VERSION:1.1*ABSTRACT:main function of programFUNCTION:function of main*ARGUMENT .*argc count of command line argument*argv command line argument*RETURN*0 normal end*1 abnormal end*SIDE-EFFECT*NOTE *CREATE:96-07 Netsl*UPDATE:96-08 Nets2the reason*UPDATE:96-09 Nets3*/5 .模块头2/*/*/*模块： 模块名-标题*/*功能概略：功能概略*/*/*/6 .类型声明/*TAG:DemoStr