API函数中的缩写

最近看源码,发现有好多复杂的缩写,看不懂,记不住,MSDN上没有,百度呢,要不是没有,要不就是形似。就猜,应该是有联系的吧。有一定的命名规则。就上网搜了一下程序员的编程规范,发现了一些类似的标志。

形成缩写的几种技术

1) 去掉所有的不在词头的元音字母如screen写成scrn, primtive写成prmv

2) 使用每个单词的头一个或几个字母如Channel Activation写成ChanActiv ;Release Indication写成RelInd

3) 使用变量名中每个有典型意义的单词如Count of Failure写成FailCnt

4) 去掉无用的单词后缀 ing, ed等如Paging Request写成PagReq

5) 使用标准的或惯用的缩写形式包括协议文件中出现的缩写形式如BSIC(Base Station Identification Code)MAP(Mobile Application Part)

关于缩写的准则

1) 缩写应该保持一致性如Channel不要有时缩写成Chan有时缩写成Ch,Length有时缩写成Len有时缩写成len

2) 在源代码头部加入注解来说明协议相关的非通用缩写

3) 标识符的长度不超过32个字符

<规则2> 变量命名约定

参照匈牙利记法即

[作用范围域前缀] + [前缀] + 基本类型 + 变量名

其中

前缀是可选项以小写字母表示

基本类型是必选项以小写字母表示

变量名是必选项可多个单词(或缩写)合在一起每个单词首字母大写

前缀列表如下

前缀 意义 举例

g_ Global 全局变量 g_MyVar

m_ 类成员变量 或 模块级变量 m_ListBox, m_Size

s_ static 静态变量 s_Count

h_ Handle 句柄 hWnd

p_ Pointer 指针 pTheWord

lp_ Long Point 长指针 lpCmd

a_ Array 数组 aErr

基本类型列表如下

基本类型 意义 举例

b_ Boolean 布尔 bIsOK

by_ Byte 字节 byNum

c_ Char 字符 cMyChar

i或n_ Intger 整数 nTestNumber

u_ Unsigned integer 无符号整数 uCount

ul_ Unsigned Long 无符号长整数 ulTime

w_ Word 字 wPara
dw_ Double Word 双字 dwPara

l_ Long 长型 lPara

f_ Float 浮点数 fTotal

s_ String 字符串 sTemp

sz_ NULL结束的字符串 szTrees

fn_ Funtion 函数 fnAdd

enm 枚举型 enmDays

x,y x,y坐标

这些是在网上找的C++ 的编程的关于变量缩写的规范,vb应该大同小异。我们遇到时要具体问题具体分析。例如,W 有的时候是word的缩写,有的时候是windows的缩写。总之,看到缩写,就想想它的原意,这样就有事半功倍的效果。

(其中的缩写是摘抄自程序员编程规范)

猜你喜欢

转载自blog.csdn.net/jickjiang/article/details/80318644