共有回帖数 0 个
-
按照MS方式编程：匈牙利符号表示法
匈牙利符号表示法包括许多与下列命名有关的约定：
①变量 ②函数 ③类型和常量 ④类 ⑤参数
匈牙利符号表示法的前缀代码指导说明书：
*************************************************
前缀 数据类型（基本类型）
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 消息
*************************************************
变量的命名：
应用匈牙利表示法，变量可用上表中的前缀代码来表示。另外，当一个变量是由一个或几个子名构成时，每一个子名都要以大写字母开头。下面是几个例子：
char *szfileName; //a nulla terminated string:以0终止的字符串
int *lpidate; //a 32-bit pointer to an int:指向一个整型变量的32位的长指针
Bool bSemaphore; //a boolean value
WORD dwMaxCount; //a 32-bit unsigned WORD
尽管我们了解一个函数的局部变量没有说明，但是也有个别表示全局变量必须要以 g_ 开头：
int g_iXPos; //a global x-position
int g_iTimer; //a global y-position
char *g_szString; //a global NULL terminated string
函数的命名：
函数和变量的命名方式相同，但是没有前缀，换句话说，子名的第一个字母要大写。下面是几个例子：
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 ; // a C style constant
#define POWERUNIT 100; // a C style constant
typedef unsigned char UCHAR; // a user defined type
类的命名:
类命名的约定可能要麻烦一点。但我也看到有很多人在使用这个约定，并独立地进行补充。不管怎么说，所有C++的类必须以大写C为前缀，类名字的每一个子名的第一个字母都必须大写：
class CVector // the chinese mean of vector is 矢量
{
public:
CVector();
{
ix=iy=iz=imagnitude=0; //the chinese mean of magnitude is 大小
}
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);
匈牙利表示法
匈牙利表示法概述
密码- -间谍电影和其它各种人类活动的基本素材。当你第一次看到匈牙利表示法时，你可能会把它当成另一种密码。该表示法包含了密码的一切要素，其中包括一系列不得不解码的神秘字符以及使用时几乎不能破译的结果。然而，不久你就会明白，这是其他程序员的秘密代码，而不是本书中使用的匈牙利表示法。 匈牙利表示法可以为你节省大量的时间和精力。在编程方面花过大量时间的任何人都知道，当阅读以前自己编写的代码或阅读其他人编写的代码时，好的文档是无价之宝。这也正是匈牙利表示法要为你完成的任务- -文档化代码。 对匈牙利表示法的清晰理解将有助于你从本书的示例以及Microsoft （以及其他厂商）的手册中学到更多深入的东西。每一个Windows 编程语言厂商都在其手册中使用某种形式的匈牙利表示法。另外，相同的概念同样适用于诸如Visual FoxPro ，Delphi 以及Visual Basic这样的编程语言。即使语言本身完全不同，但使用匈牙利表示法编写出的代码超越了编程语言而具备一定的相似性。 那么，严格讲起来，什么是匈牙利表示法呢？匈牙利表示法是一种告诉其他人你准备如何使用变量的表示方法。知道了变量要干些什么经常有助于解释代码本身。例如，如果我告诉你某个特定变量保存了某个窗口的句柄，那么这就比变量只简单地是个变量提供了更多的信息。理解了该变量将操作窗口后，你就可以解释代码了。
这种变量命名系统第一阶段的开发工作是由Microsoft 公司的Charles Simonyi 完成的。他把这种命名系统称做匈牙利表示法（Hungarian Notation ），我们在这里就使用这种称呼。你可以从许多地方获取Charles Simonyi 著作的副本，包括BBS 和Internet 上的某些icrosoft编程站点（像CompuServer 这样的许多联机服务也以各种形式提供匈牙利表示法的副本）。
其他开发人员对Simonyi 的研究成果做了进一步的增强。例如，Xbase 程序员使用他们自己特殊版本的匈牙利表示法。这种表示法表达了Xbase 提供的不同类型的变量。FreshTechnologies 的Robert A. Difalco 出版了匈牙利表示法的Xbase 增强版本。在某些针对DBMS的BBS 上以及CompuServer 的Computer Associates Clipper 论坛上你都可以找到这位作者的作品。
本节讲述的基本概念在前面提到的两个文档中你都可以查阅到，表达形式上可能会有所不同。本节旧话重提的目的是为了让你准确地理解我所采用的约定的意义，并说明在你的代码中应该如何最佳地使用它们。在你的代码中采用这种命名法的原因有四个：
帮助记忆值 这种表示法有助于更容易地记住变量的名称，在团队项目中这是个要认真考虑的重要事情。
提供建议值 你或许并不是唯一要修改你的代码的人。如果你正在开发一个团队项目的话，小组中的其他成员最起码也要看一看你编写的代码。使用这些约定有助于其他开发人员理解你的代码。
一致性 程序员的工作成果通常并不仅仅体现在效率和功能方面，而且也体现在编写出的代码是否能够被其他程序员轻易地读懂。使用这些约定有助于在不同的项目中保持一致的代码风格。利用你所使用的约定，其他程序员也可以轻易地加入到修改或编写代码的行列中。
加快判断速度 在商业化世界中，创建和修改代码的速度经常会决定特定项目的成功程度。使用一致的代码将减少你花在猜测其他人创建的变量或函数意义方面所需的时间。这一判断时间的减少也就增加了你用于有效地开发产品的时间。
上面已经讲述了为什么应该使用匈牙利表示法，现在让我们看一看本书中准备如何应用这一表示法吧。我将按照下节阐述的规则命名变量。在命名数据库字段或其它与值相关的结构时我也将使用这些规则。另外，只要匈牙利表示法有助于更清晰地表达函数和过程的意义，这些函数和过程的命名也将使用下节中介绍的规则。
规则1：使用变量前缀
变量命名时，总使用一个或两个小写字母作为变量名前缀，以指明变量的类型。绝大多数情况下，变量名前缀使用变量类型的第一个字母，因此，可以轻易地记住应该使用哪个字母。下面的示例显示了Visual Basic ，Delphi 以及C 语言中普遍使用的前缀字母（Windows.中有成千上万种文字组合没有在这里列出）。
下表也提供了几个数据库专用的修饰符：
A Array
C Character
D Date
Dbl Double
Dc Device Context
Dw Double Word
F Flag,Boolean或Logical
H Handle
I Integer
Inst Instance
L Long
Li Long Integer
Lp Long Point
Msg Message
N Numeric
O Object
Pal Palette
Psz 指向以零结尾的字符串的指针（Pointer）
Ptr 指针（与其它类型变量一起使用时也可以使用p，比如psz）
R Real.续表
Rc Rectangle
Rgb Red,Green,Blue（红、绿、蓝，颜色变量）
Rsrc Resource
Sgl Single
Si Short Integer
Sz Zero Terminated String
U Unsigned
Ui Unsigned Integer或Byte
W Word
Wnd Window
规则2：标识状态变量
某些变量用于指明像数据库、字段或控件这样的对象的状态。这些变量甚至可以保存其它变量的状态。告诉其他程序员某个变量用于监视某个对象的当前状态有助于他们理解这些变量在程序中的意义。你可以使用下面的三字母修饰符之一来指明该变量是状态变量：
New 新的状态
Sav 已保存状态
Tem 临时状态
规则3：应用标准修饰符
标准修饰符几乎可以让其他人立即看清楚变量的用途。标准修饰符不提供变量的类型信息，但它们说明了一个变量与其它变量之间的关系。例如，使用Clr 修饰符将会告诉阅读程序的人该变量以某种方式用于操作颜色。你甚至可以把多个修饰符组合起来以进一步说明变量的作用并描述清楚应该如何使用这个变量。例如，cClrCrs 是个字符型变量，它用于确定光标的显示颜色。使用一到三个这样的修饰符通常就足以描述清楚变量的用途了。
下面列出的修饰符是应用最普遍的一些修饰符：
Ar Array
Attr Attribute
B Bottom
Clr Color
Col Column
Crs Cursor
Dbf Database File（数据库文件）
F First
File File
Fld Field
L Last/Left
Msg Message
Name Name
Ntx Index File（索引文件）
R right
Rec Record Number（记录号）续表
Ret Return Value（返回值）
Scr Screen
Str String
T Top
X Row
Y Column
规则4：添加描述性文字
当你清楚地定义了变量的内容和用途后，就可以使用一些描述性的文字进一步精化这些定义。例如，你可以把指向用于保存雇员姓名的字符串的长型指针变量定义为：lpszEmpName 。这个变量的前两个字母告诉我们它是个长型指针，紧接着的两个字母告诉我们这是个以零（或空）结尾的字符串，其余的字母告诉我们它是个雇员姓名（请注意，在这个示例中我使用了标准修饰符Name ）。在代码中看到这样的变量名让人一眼就可以看出其类型和用途。
规则5：创建多个变量
时不时就会遇到在某个特定模块中使用一个变量并不能够满足每一种需要的情况。多数情况下你会想到创建同种类型的多个变量，并用数字来区分这些变量。当然你也可以使用下面的这种有意义的数字指示符来说明各变量的功能：1 ，2 ，3 状态指针引用，比如SavClr1 ，cSavClr2 ，…
Max 限制上界，比如nFldMax指明字段的最大个数
Min 限制下界，比如nRecMin指明记录的最小个数
Ord 某种类型的顺序号
楼主 2015-12-31 12:17 回复
Copyright © 2010~2015 直线网 版权所有,All Rights Reserved.沪ICP备10039589号
意见反馈 |
关于直线 |
版权声明 |
会员须知
