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

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

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

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

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

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

6、注释等。在写注释时推举使用以下格式。文件注释（文件头）,文件注释记述以下信息 (a)文件识不信息系统名（主模块时）程序名或模块名版本信息（包括时刻）所属（从属模块时）担当著作权声明(b)文件讲明信息简介功能讲明（要紧模块讲明）操作环境H/W，PLATFORM，OS，MEMORY等编译、连接信息make file名，命令过程文件名，编译、连接选项（Option），应连接的装配模块文件名，子程序库名等文件维护信息版本，日期，作者所属部门名，作者姓名，补充讲明等创建信息更改记录(d)其它系统使用讲明（主模块时）注意事项文件治理工具的附加信息需要特不讲明的信息SYSTEMPROGRAM/MODULEV

7、ERSIONMASTER MODULEAUTHORCOPYRIGHTABSTRACT/PURPOSEFUNCTIONENVIRONMENTMAKE OPTIONCREATEUPDATEUSAGENOTESPECIAL INFO讲明：“”表示标准项目，“”表示可选项目。模块注释（模块头）。模块注释对了解模块的概要特不有效，而且在维护时也同样有效，因此一定要记述。模块注释记述以下信息模块名模块编号版本信息简介功能讲明阻碍注意事项返回值参数讲明担当创建信息更改记录MODULEIDVERSIONABSTRACTFUNCTIONSIDE-EFFECTNOTERETURNARGUMENTAUTHORCRE

8、ATEUPDATE讲明：“”表示标准项目，“”表示可选项目。数据注释数据注释用来关心对数据结构或数据表、数组等内容的理解。标识符名（用于标识符定义）数据结构名称数据类型简介注意事项TAGDATADATA-TYPEABSTRACTNOTE讲明：“”表示标准项目，“”表示可选项目。附录: 头注释样例以下为C语言源文件的注释样例主模块文件头（程序的主模块，生成命令程序。）/*/*/* 系统： 系统名 */* 用户： 用户名 */* 程序： 程序名 - 标题 */* 担当部门： XXXX*/* YYYY*/* (C)Copyright Shenyang NETS integration Corpora

9、tion 1996*/* All Rights Reserved. */*/* VERSION DATE BY CHANGE/COMMENT*/* VX.00 YY-MM/DD 姓名 Create*/* VX.XX YY-MM/DD 姓名 更改 概要、更改理由*/*/* 功能概略：功能概略 */* 异常处理：异常处理 */* 调用方法： */* 程序名 Arg1 Arg2 */* 参数讲明： */* I/0 参数名 内容 */* I Arg1 内容讲明 */* I Arg2 内容讲明 */* 适用计算机：计算机类型、型号 */* OS： OS名称（版本） */* 大小： 内存 MB */* 交

10、换 MB */* 编译： 编译系统名称（版本） */* 连接信息： 连接信息 */*/*/* 请注意：未经许可，不可擅自使用、转载本内容的一部分或全部。*/*/*/模块文件头（从属模块）/*/*/* 系统： 系统名 */* 用户： 用户名 */* 模块： 模块名- 标题 */* 所属： 主模块名或程序名 */* 担当部门： XXXX */* YYYY */* (C)Copyright Shenyang NETS Integration Corporation 1996 */* All Rights Reserved. */*/* VERSION DATE BY CHANGE/COMMENT *

11、/* VX.00 YY-MM/DD 姓名 Create */* VX.XX YY-MM/DD 姓名 更改概要、更改理由 */*/* 功能概略：功能概略 */* 异常处理：异常处理 */* 调用顺序： */* int I1 */* : */* char 01 */* sts = (&I1,&01); */* 参数讲明： */* I/0 变量名 内容 */* I I1 内容讲明 */* : */* I 01 内容讲明 */* 0 STS 内容讲明 */* 适用计算机：计算机类型、型号 */* OS： OS名称（版本） */* 编译： 编译系统（版本） */* 连接信息： 连接信息 */*/* 请注

12、意：未经许可，不可擅自使用、转载本内容的一部分或全部。*/*/文件头例/* * Copyright 1994-1995 Microsoft Corporation. All Rights Reserved. *PROGRAM:winprog.c * *PURPOSE:Windows program. * *PLATFORMS:Windows 95 * *FUNCTIONS: *WinMain() - calls initialization function, processes message loop *InitApplication() - Initializes window data

13、 nd registers window *InitInstance() -saves instance handle and creates main window *MainWindProc() Processes messages *About() - Process menssages for About dialog box */模块头1/* * MODULE: main *VERSION: 1.1 *ABSTRACT: main function of program *FUNCTION: function of main *ARGUMENT: * argccount of command line argument * argvcommand line argument *RETURN: * 0normal end * 1abnormal end *SIDE-EFFECT: *NOTE: *CREATE: 96-07Nets1 *UPDATE: 96-08Nets2 * the reason *UPDATE: 96-09Nets3 */模块头2/*/* */* 模块： 模块名 - 标题 */* 功能概略： 功能概略 */* */*/类型声明/* * TAG: DemoStruct *ABSTRACT: D