cvi语言编码规范.docx

目的：规范上位机CVI软件代码的编写，提高上位机程序的可读性和可维护性。
适用范围：
适用于本公司基于 CVI的所有上位机程序。
说明：CVI语言的核心是标准 C;因此本规范是在 C语言编码规范的基础上，对变量命名，函数名，函数 调用等具体细节进行了详细的规范；其余内容基本参照原 C语言编码规范的规定。
1、 DLL文件命名
通信类 DLL文件的命名，用产品名称+后缀 .DLL的方式命名；女口 ;作为
公司代码前缀的 AN用大写字母，作为产品系列的后缀 H,X,U,P等用大写字母；对于某一系列产品通
用的DLL文件，产品名称中相应的位用小写字母 x代替，如 ; ；
C语言的源文件，头文件，工程文件等的命名，遵照 DLL文件命名的原则。
2、 函数命名
通信类DLL文件中，函数的命名原则为： DLL文件名（没有后缀）+下划线 _+函数功能名
其中函数功能名为动宾词组，每个单词的首字母大写，其它字母小写;
对查询类函数，动词为
Read;如 ReadVoltage , ReadCurrent , ReadPower等等
对设置类函数，动词为
Set;女口 SetOutVoltage ; SetOutFrequency 等等
对控制类函数，动词为
Control ;女口 ControlStart ; ControlStop 等等
对组合类命令，动词为
Complex;女口 ComplexSetStartReadVoltage 等等；
3、函数返回值
对通信类DLL函数，返回值为int型，=0，表示函数执行成功，=负值表示相应的通信错误代码 （注
意，不是下位机通信返回的错误代码） ，错误代码如下表，
CodeError Message
-1 Unknown system error.
-2 Inv alid port nu mber.
-3 Port is not ope n.
-4 Unknown I/O error.
-5 Un expected internal error.
-6 No serial port found.
-7 Cannot ope n port.
-8 A NULL poin ter was passed whe n a non-NULL poin ter was expected.
-11 Out of memory.
-12 Un able to allocate system resources.
-13 Inv alid parameter.
-14 Inv alid baud rate.
-24 In valid parity.
-34 Inv alid nu mber of data bits.
-44 Inv alid nu mber of stop bits.
-90 Bad file han dle.
-91 File I/O error.
-94 Inv alid count; must be greater tha n or equal to 0.
-97 Inv alid in terrupt level.
-99 I