摘自《WIndows游戏编程大师技巧》第二章
匈牙利符号表示法
如果你正在动作一个像Microsoft一样的公司,有几千个程序员都在干不同的项目
,在某一点上就应当提出一个编写代码的标准方式。否则,结果将是一片混乱。因此一个
名字叫Charles Simonyi的人被委托创立了一套编写Microsoft代码的规范。这个规范已经
用作编写代码的基本指导说明书。所有Microsoft的API、界面、技术文件等等都采用这些
规范。
这个规范通常被称为匈牙利符号表示法,可能是因为创立这个规范工作很长时间,弄
得他饥肠辘辘的原因吧(英文中饥饿和匈牙利谐音),或者可能他是匈牙利人。对我们根本
不知道,关键是你必须了解这个规范,以便于你能够阅读Microsoft代码。匈牙利符号表示
法包括许多与下列命名有关的约定:
·变量
·函数
·类型和常量
·类
·参数
表2.1给出了匈牙利符号表示法使用的前缀代码。这些代码在大多数情况下一半用于前
缀变量名,其他约定根据名称确定。其他解释可以参考本表。
表2.1 匈牙利符号表示法的前缀代码指导说明书
━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━
前缀 │数据类型(基本类型)
──────┼────────────────────────
c │字符
by │字节(无符号字符)
n │短整数和整数(表示一个数)
i │整数
x,y │短整数(通常用于x坐标和y坐标)
cx,cy │短整数(通常用于表示x和y的长度:c表示计数)
b │布尔型(整数)
w │UINT(无符号整数)和WORD(无符号字)
l │LONG(长整数)
dw │DWORD(无符号长整数)
fn │函数指针
s │串
sz,str│以0字节终止的字符串
lp │32位的长整数指针
h │编号(常用于表示Windows对象)
msg │消息
──────┴───────────────────────
变量的命名
应用匈牙利符号表示法,变量可用表2.1中的前缀代码来表示。另外,当一个变量是由
一个或几个子名构成时,每一个子名都要以大写字母开头。下面是几个例子:
char *szFileName;//a nulla terminated string
int *lpiDate;//a 32-bit pointer to an int
BOOL bSemaphore;//a boolean value
WORD dwMaxCount;//a 32-bit unsigned WORD
尽管我了解一个函数的局部变量没有说明,但是也有个别表示全局变量:
int g_iXPos;//a global x-position
int g_iTimer;//a global y-position
char *g_szString;//a global NULL terminated string
总的来说,变量以g_开头,或者有时就只用g。
函数的命名
函数和变量命名方式相同,但是没有前缀。换句话说,子名的第一个字母要大写。下
面是几个例子:
int PlotPixel(int ix,int iy,int ic);
void *MemScan(char *szString);
而且,下划线是非法的,例如,下面的函数名表示是无效的匈牙利符号表示法:
int Get_Pixel(int ix,int iy);
类型和常量的命名
所有的类型和常量都是大写字母,但名字中可以允许使用下划线。例如:
const LONG NUM_SECTORS = 100;//a C++ style constant
#define MAX_CELLS 64;//a C style constant
#define POWERUNIT 100;//a C style constant
typedef unsigned char UCHAR;//a user defined type
这儿并没有什么不同的地方——非常标准的定义。尽管大多数Microsoft程序员不使用
下划线,但我还是喜欢用,因为这样能使名字更具有可读性。
C++ 在C++中,关键字const不止一个意思。在前面的代码行中,它用来创建一个常
数变量。这和#define相似,但是它增加了类型信息这个特性,const不仅仅像#define一样
是一个简单的预处理文本替换,而且更像是一个变量,它允许编译器进行类型检查和替换
。
类的命名
类命名的约定可能要麻烦一点。但我也看到有很多人在使用这个约定,并独立地进行
补充。不管怎样说,所有C++的类必须以大写C为前缀,类名字的每一个子名的第一个字母
都必须大写。下面是几个例子:
class CVector
{
public
CVector();{ix=iy=yz=imagnitude = 0;}
CVector(int x,int y,int z){ix=x;iy=y;iz=z;}
.
.
private:
int ix,iy,iz;//the position of the vector
int imagnitude;//the magnitude of the vector
};
参数的命名
函数的参数命名和标准变量命名的约定相同,但也不总是如此。例如下面例子给出了
一个函数定义:
UCHAR GetPixel(int x,int y);
这种情况下,更准确的匈牙利函数原型是:
UCHAR GetPixel(int ix,int iy);
但我认为这并没有什么两样。
最后,你甚至可能都看不到这些变量名,而仅仅看到类型,如下所示:
UCHAR GetPixel(int, int);
当然,这仅仅是原型使用的,真正的函数声明必须带有可赋值的变量名,这一点你已
经掌握了。
注意:仅仅会读匈牙利符号表示并不代表你能使用它。实际上,我进行编程工作已经
有20多年了,我也不准备为谁改变我的编程风格。因此,本书中的代码使用类匈牙利符号
表示法的编码风格,这是Win32 API造成的,在其他位置将使用我自己的风格,必须注意的
是,我使用的变量名的第一个字母没有大写,并且我还使用下划线。