计算机编码程序设计说
明书
第 1 章 序言
所谓编码就是基于在程序设计时作成的程序设计书和流程图等逻辑设计、用编程语言、对为在计算机上实现某些功能的逻辑进行描述的工作。
在编码过程中、为了消除因程序员水平不同而造成的差异、为了顺利的进入单体测试阶段、同时也为了维护方便、以下整理了编码的准备和代码书写的标准。
而且、关于书写标准、除非客户有指定的要求、或者使用了（半）自动生成代码的工具话、则应尽量遵从这个标准。
本规是以使用Microsoft 的 Visual Basic 来开发PC的应用程序为前提的。
第 2 章 编码的准备
（1） 以系统设计书、程序设计书（根据情况也包含流程图等的逻辑设计书）为基础。 （2） 在完全理解了以上文档容的基础上开始编码工作（特别是程序设计书的作者和编码的担
当者不同时）。对于不明白的地方不要随意判断、要进行确认。
（3） 始终注意要把程序的易理解性（易读性）放在第一位。为此、在编程时要时刻想着程序
的读者、本着以向读者说明的态度来编写程序是写好程序的关键。读起来容易理解的程序一般来说总是质量优良、而且容易改造的。
（4） 象数据库的记录的规等include文件、模块头、宏定义等系统应该统一的东西、要采用
系统规定的东西、不要根据个人的意愿随意的作成、否则、这将成为在进行变更和改造时发生问题的原因。
（5） 编码结束后、要对代码进行检查。不检查代码则不能轻易的进入下一步的测试阶段的工
作。检查代码不仅是最容易发现错误的方法、而且有时还能检出在测试时不易发现的复杂错误。
第 3章 命名规约
3 – 1 . 使用的目的
命名规约以以下4点为目的的而使用。
（1） Object名容易明白会使应用程序的结构代码等容易理解。 （2） 确立开发小组“通用语言”、使全体成员用同样的“语言”来开发应用程序。 （3） 使VB Jet的Object 容易被使用。
（4） 用较少的劳力作成VB开发用的工具、在各式各样的VBA 平台里通用的源码库。
本规约是用遵从被VisualBasic作为标准的 Lezynski命名规则（Lezynski Naming Convention、 以下称LNC）的方法来规定命名法的。
3 – 2 . Object的结构化
LNC按以下格式对Object进行命名。
[ Prefix ] tag [ BaseName ][ Quantifier ][ Suffix ]
Prefix 前缀 Tag 标签 BaseName 基本名 Quantifier 量词 Suffix 后缀
对各个部分按顺序进行说明。
３－３. 前缀（prefix）
前缀是在标签前面的识别符、是对标签进行进一步详细说明的。前缀用1到2个小写字母组成。对1个Object复数个前缀可以组合使用。
前缀有表示有效围的和表示变量特性的。另外、2个前缀能够重叠使用。
（1） 表示有效围的前缀
表1 . 表示有效围的前缀 无 Procedure的局部变量 s 用Static声明的Procedure的局部变量 m p g （2）
a c e i r t v 在模块Declarations Section 的用Dim 或Private声明的模块水平的变量 在模块的Declarations Section用Public声明的变量 在模块的Declarations Section作为Public或Global声明的变量
表示变量特性的前缀
表2. 表示变量特性的前缀 作为数组声明的变量 用Const声明的变量 作为的Collection1个要素的变量 作为数组的Index或循环的计数器使用的变量 传递给Procedure参数的作为参照传递( ByRef )声明的变量 作为用户定义型定义的变量 传递给Procedure参数的作为值传递( ByVal )声明的变量
（3） 例
值传递的参数：vintCount
参照传递的参数： rstrFileName
在Declarations用public声明的数组的Index变量：apintMember 用Const声明的变量：cintFNAMEMAX
3 – 4 . 标签（tag）
标签是表示基本名的特征的复数个的字母、放在基本名的前面。标签基本上相当于面向Object编程的类识别符。标签用3到4个小写字母组成。
标签是表示基本名的特征的复数个的字母、表示变量的型啦的种类。从标签表示的意思上可以对数据型、模块、Form、控件的标签进行分类。
（1） 数据型
表3. 数据型标签
布尔值 bln 长整数 lng Byte byt Object obj 双精度浮点数 dbl 字符串 str 错误 err 用户定义 typ 整数 int Variant var
（2） 模块、Form、控件
表4 模块标签 表5. 标签
类模块 标准模块 Form
Command Button 控件 Combo Box 菜单 菜单项 Node List Box （3） 例
? 判定成功用的变量： ? 文件名： ? 检索处理用的标准模块： ? 主Form： ? Start Button： ? Font Dialog：
cls bas frm 对话框 菜单 fdlg fmnu 表6. 控件标签 cmd Option Button ctl Pocture cbo Printer mnu 属性 mni,mnis Tab nod,mods Text Box lst Common Dialog opt pic,pics prn,prns prp,prps tab,tabs txt cdlg blnSuccess strFileName basSearchData frmMain cmdStart cdlgFont
3 – 5 . 基本名（BaseName）
基本名是设Object名是最先遇到的部分、是不管采用不采用命名规则都必须使用的名字。
基本名要用有意义的单词（原则上用英文单词）来组合、各个单词的第一个字母大写其余用小写。这时、再加上专用名词的情况下、要用日语的罗马字。但是、用Const声明的变量的基本名全部用大写。另外、虽然没有限制、基本名还是要选择不太长的名字。
作为基本名的样本用在VB编码里的标准的作业变量表示如下。
表7 . 标准LNC作业变量 blnRET 接受函数调用的返回值（ True/False ） intErr 保持Err的值 intLoop 循环计数器 intMsg 接受MsgBox函数的返回值 intResult 保持算术演算的接果（dblresult 、lngResult 也同样） intRet 接受函数调用的返回值（dblRet、lngRet也同样） intWord 用在所有暂时的作业（dblWord 、 lngWork也同样） strMsg 作成Message Box字符串
3 – 6 . 量词（ Qualifier）
量词表示Object在关联上是怎样被利用的。（最大、最小等）量词要尽量短、用大写.小写字母的组合来表示。
表8 . 量词 Curr 存贮1Set的现在的要素 First 存贮1Set的最初的要素 Hold 存贮以后要使用的要素 Last 存贮1Set的最后的要素 Max 存贮1Set的最大要素 Min 存贮1Set的最小要素 Next 存贮1Set的下一个的要素 New 存贮的新的instance或值 Oid 存贮的以前的instance或值 Prev 存贮1Set的前面的要素 Src 存贮Source Temp 存贮暂时的值
3 – 7 . 后缀（Suffix）
后缀是以在按照命名规则时变成的名字的Object名上识别符为目的而添加的。所以不是非要不可、根据Project决定是否采用。
假设DB关联的标准模块有SortData、DeleteData、InsertData、UpdateData4个。这时、如果存贮错误码的变量设为、在各个模块里确保变量的话、就会区别不开。如果在取各个模块的大写的2个字母作后缀、各个变量就能区别开。
①SortData （ SD ） -﹥ gintErr_SD ②DeleteData （ DD ） -﹥ gintErr_DD ③DeleteData （ ID ） -﹥ gintErr_ID ④DeleteData （ UD ） -﹥ gintErr_UD
虽然后缀的决定方法没有特别的基准、还是要选择容易明白区别基准的2到3个字母的字符串。另外、大写字母、小写字母可以任意使用。
第４章 模块头
模块头对了解模块的概要是很有效的、另外还有助于维护。所以、对此必须记述。
计算机编码程序的设计说明书
