在英语中,依靠单词的大小写拼写复合词的做法,叫做”骆驼拼写法”(CamelCase)。比如,backColor这个复合词,color的第一个字母采用大写。

几年以前,Charles
Simonyi(他后来成为微软的著名程序员)设计了一种以前缀为基础的命名方法,这种方法后来称为”匈牙利表示法”以记念他.他的思想是根据每个标识符所代表的含义给它一个前缀.微软后来采用了这个思想,给每个标识符一个前缀以说明它的数据类型.因此,整型变量的前缀是n,长整型变量是nl,字符型数组变量是ca,以及字符串(以空类型结尾的字符数组)以sz为前缀.这些名字可能会非常古怪.比如说:lpszFoo表示”Foo”是一个指向以空字符为结尾的字符串的长整型指针.

1.- 变量应该是尽可能的望文知意。千万不要使用教材中的命名方式。

这种拼写法在正规的英语中是不允许的,但是在编程语言和商业活动中却大量使用。比如,sony公司的畅销游戏机PlayStation,play和station两个词的词首字母都是大写的。

这种方法的优点是使人能够通过变量的名字来辨别变量的类型,而不比去查找它的定义.遗憾的是,这种方法不仅使变量名字非常绕口,而且使改变变量类型的工作变得十分艰巨.在Windows3.1中,整型变量为16为宽.如果我们在开始时采用了一个整型变量,但是在通过30—40个函数的计算之后,发现采用整型变量宽度不够,这时我们不仅要改变这个变量的类型,而且要改变这个变量在这30–40个函数中的名字.

  • 好的变量 daysDateRange, flightNumber, carColor.
  • 坏的变量: days, dRange, temp, data, aux…

这样做的好处是可以用一连串的描述性单词来表述一个新的含义–因为中间没有空格,可以被视为一个新词(组),而不是一个短语。

因为不切实际,除了一些顽固的Windows程序员外已经没有人再使用”匈牙利表示法”了.毫无疑问,在某种场合它依然存在,但大部分人现在已经抛弃它了.一般而言,输入前缀是一种糟糕的想法,因为它把变量于其类型紧紧地绑在了一起.

在我们的日常工作中,有很大数量的开发人员喜欢使用短的变量名,而不是有含义的变量名。这主要是因为我们大学教科书的那些示例所造成的,人都是先入为主,所以,教科书中的那些很抽象,带着演示的变量命名影响了我们一代又一代的程序员,并影响了他们很多年。虽然那些短的,教材式的变量名,可能会让你少打一些字,但其实,这是非常非常不好的。因为软件的维护成本远远大于了软件的开发成本,如果你不取一个好的一点的变量名,那么当进行代码评审时,当进行bug
fixing时,当进行代码重构时,当进行代码维护时,你的某个变量名可能会让你一头雾水,不知道所措,还可以会让你走入陷阱,造成更大的时间成本。所以,一个可阅读的代码必然和那些不错的变量名分不开,而这也能让你的软件间接上有更好的质量。

它之所以被叫做”骆驼拼写法”,是因为大小写的区分使得复合词呈现”块状”(bump),看上去就像骆驼的驼峰(hump),有高有低。

对于30行以下的函数,匈牙利方法一般有优势。

2.- 变量名不要太长,尽可能地简短

“骆驼拼写法”又分为两种。第一个词的首字母小写,后面每个词的首字母大写,叫做”小骆驼拼写法”(lowerCamelCase);

尤其是对界面编程,有优势。

只有简单和简短的变量名才是容易阅读的。因为你的变量名一定会用于程序语句中,所以,为了让你的程序语句看起来的简短,你的变量名也应该短一点,不然写出来的一个表达式就会显得很复杂。

第一个词的首字母,以及后面每个词的首字母都大写,叫做”大骆驼拼写法”(UpperCamelCase),又称”帕斯卡拼写法”(PascalCase)。

但对于有强烈的算法要求、尤其是有很多抽象类型的C++程序,匈牙利方法简直是一个灾难。

当然,在有些时候,一个有含义的变量名和一个简短的变量名可能存在一些冲突。这相当锻炼我们的语言能力——如果有最精炼的词语来表达最丰富的含义。如果实在做不到,那么,取一个有含义的变量名要比取一个简短的变量名更好一些。不管怎么样,我们希望即简短又有丰富的含义,但如果不能两全,那有含义优先级更高一些。

原文转载自:

看你用在什么地方。

  • 坏的变量:howLonDoesItTakeToOpenTheDoor, howBigIsTheMaterial…
  • 好的变量:timeToOpenTheDoor, MaterialSize.

 

现在有了很好的IDE工具,如:VC,SourceInsight等.

3.- 可以使用缩写,但需要有一些注释

为了代码清晰易懂,通常变量名采用一些著名的命名规则,主要有Camel标记法,Pastal标记法和匈牙利标记法。

选中变量,会自动提示告诉你它的声明和定义,这样

有一些时候,我们需要使用一些缩写来命名变量,比如:用usr来表示user,用gp来表示group,用conf来表示configuration,用cwd来表示current
working directory,用ptr来代码point to
reference,等等,等等。缩写一般要用在大家可以看得懂的,而不是为了缩写而缩短一个单词,当然,如果你把缩写后的变量名加上注释,那就更加稳妥了。关于一些约定俗成的缩写,可参看本文的附录一

      Camel标记法采用首字母小写,接下来的单词都以大写字母开头的方法,如myName。

匈牙利命名法就没有很大的必要了.

4.- 使用合适的匈牙利命名规则

      Pascal标记法采用首字母大写,接下来的单词都以大写字母开头的方法,如MyName。

无非就是为了程序可读性较好.

这里有一篇非常不错的英文文章告诉你 《什么是合适的匈牙利命名 》,这篇文章同时还告诉你如何去用他。基本上来说,匈牙利命名法主要是为变量加上某种前缀以标识这个变量的类型,或是一种方法的功能。其基本原则是:变量名=属性+类型+对象描述。

     
匈牙利标记法是在Pastal标记法的基础上,变量名前面加上一个小写字母,或者小写字母的序列,以说明该变量的类型,如sMyName。

实际上良好的代码书写习惯比强制使用匈牙利命名法更重要.

比如:在描述类型方面:指针p,函数fn,长整型
l,布尔b,浮点型(有时也指文件)f,双字 dw,字符串 sz,短整型
n,双精度浮点 d,无符号 u……等等。关于更多的命名规范,请参见附录二

匈牙利命名法是微软推广的一种关于变量、函数、对象、前缀、宏定义等各种类型的符号的命名规范。匈牙利命名法的主要思想是:在变量和函数名中加入前缀以增进人们对程序的理解。它是由微软内部的一个匈牙利人发起使用的,结果它在微软内部逐渐流行起来,并且推广给了全世界的Windows开发人员。下面将介绍匈牙利命名法,后面的例子里也会尽量遵守它和上面的代码风格。还是那句话,并不是要求所有的读者都要去遵守,但是希望读者作为一个现代的软件开发人员都去遵守它。

系统性。整体性。可读性。分类要清楚。要有注释!

注意,匈牙利命名也是有不好的地方的,比如你要把一个整形改成一个浮点型,你除了要改变这个变量的类型,你还要改变这个变量的名字。这是相当麻烦的。而且,在某些时候,这种前缀式的命名可以反而让你不知所措。另外,在C++中,有了类以后,这种命名方法就显得不容易去实施了。所以,合适地使用匈牙利命名方式背后的思想是很关键的。

a       Array                                 数组
b       BOOL (int)                            布尔(整数)
by      Unsigned Char (Byte)                  无符号字符(字节)
c       Char                                  字符(字节)
cb      Count of bytes                        字节数
cr      Color reference value                 颜色(参考)值
cx      Count of x (Short)                    x的集合(短整数)
dw      DWORD   (unsigned long)                 双字(无符号长整数)
f       Flags   (usually multiple bit values)  
标志(一般是有多位的数值)
fn      Function                              函数
g_      global                                全局的
h       Handle                                句柄
i       Integer                               整数
l       Long                                  长整数
lp      Long pointer                          长指针
m_      Data member of a class                一个类的数据成员
n       Short int                             短整数
p       Pointer                               指针
s       String                                字符串
sz      Zero terminated String                以0结尾的字符串
tm      Text metric                           文本规则
u       Unsigned int                          无符号整数
ul      Unsigned long (ULONG)                 无符号长整数
w       WORD (unsigned short)                 无符号短整数
x,y     x, y coordinates (short)              坐标值/短整数
v       void                                  空

匈牙利命名法是微软推广的一种关于变量、函数、对象、前缀、宏定义等各种类型的符号的命名规范。匈牙利命名法的主要思想是:在变量和函数名中加入前缀以增进人们对程序的理解。它是由微软内部的一个匈牙利人发起使用的,结果它在微软内部逐渐流行起来,并且推广给了全世界的Windows开发人员。下面将介绍匈牙利命名法,后面的例子里也会尽量遵守它和上面的代码风格。还是那句话,并不是要求所有的读者都要去遵守,但是希望读者作为一个现代的软件开发人员都去遵守它。

5.- 不要使用反逻辑来命名

有关项目的全局变量用g_开始,类成员变量用m_,局部变量若函数较大则可考虑用l_用以显示说明其是局部变量。

a Array 数组

  • 好的命名:  IsEnabled.
  • 坏的命名: IsNotEnabled.

前缀    类型               例子
g_      全局变量           g_Servers
C       类或者结构体       CDocument,CPrintInfo
m_      成员变量           m_pDoc,m_nCustomers

b BOOL (int) 布尔(整数)

在阅读的时候,我们更喜欢正向的逻辑,而不是反向逻辑。这一规则不单单的命名,在条件语句中,我们也是要尽量不要使用这种反面的逻辑。如:if
(! (isAdmin ||
isUser)),这样的语句很不符合人读代码的习惯,写成这样会更好一些——if
(!isAdmin && !isUser)。

VC常用前缀列表:

by Unsigned Char (Byte) 无符号字符(字节)

6.- 保持一致性

前缀    类型    描述例子
ch      char    8位字符 chGrade
ch      TCHAR   16位Unicode集字符 chName
b       BOOL    布尔变量 bEnable
n       int     整型 nLength
n       UINT    无符整型 nLength
w       WORD    16位无符号整型 wPos
l       Long    32位有符号整型 lOffset
dw      DWORD   32位无符号整型 dwRange
p       *       指针变量,内存模块指针(Ambient memory model point)
pDoc
lp      Far*    长指针 lpDoc
lpsz    LPSTR   32位字符串指针 lpszName
lpsz    LPCSTR 32位常量字符串指针 lpszName
lpsz    LPCTSTR 32位Unicode集常量指针 lpszName
h       handle Windows对象句柄 hWnd
lpfn    (*fn)() 回调函数指针 Callback Far pointer to CALLBACK function
lpfnAbort

c Char 字符(字节)

保持所有代码的一致性。使用相同的命名规则。这外世界上没有最好的命名规范。但有一点是可以确认的,那就是在一个代码库中,应该使用一致的命名规则,即使这个规则不那么好,但整个团队使用一致的就是好的。

匈牙利命名法

cb Count of bytes 字节数

7.- 附和应用程序的领域术语

MFC、句柄、控件及结构的命名规范 Windows类型样本变量 MFC类样本变量

cr Color reference value 颜色(参考)值

在不同的领域中,不同的观念会有非常特别和不同的意思。例如:单词“order”并不总是意味着“次顺”,有些时候,其意味着“订单”,有些时候,意味着“命令”,有些时候,意为着“规则”。所以,在某个领域中,某些单词会有不同的含义,所以,这需要我们的命令去附和这些领域。

HWND hWnd;        CWnd* pWnd;
HDLG hDlg;        CDialog* pDlg;
HDC hDC;         CDC* pDC;
HGDIOBJ hGdiObj; CGdiObject* pGdiObj;
HPEN hPen;        CPen* pPen;
HBRUSH hBrush;    CBrush* pBrush;
HFONT hFont;      CFont* pFont;
HBITMAP hBitmap; CBitmap* pBitmap;
HPALETTE hPaltte; CPalette* pPalette;
HRGN hRgn;        CRgn* pRgn;
HMENU hMenu;      CMenu* pMenu;
HWND hCtl;        CState* pState;
HWND hCtl;        CButton* pButton;
HWND hCtl;        CEdit* pEdit;
HWND hCtl;        CListBox* pListBox;
HWND hCtl;        CComboBox* pComboBox;
HWND hCtl;        CScrollBar* pScrollBar;
HSZ hszStr;      CString pStr;
POINT pt;         CPoint pt;
SIZE size;        CSize size;
RECT rect;        CRect rect;

cx Count of x (Short) x的集合(短整数)

 

一般前缀命名规范

dw DWORD (unsigned long) 双字(无符号长整数)

黄金法则- 花一些时间去思考去权衡一下你的变量名

前缀          类型实例
C    类或结构 CDocument,CPrintInfo
m_   成员变量 m_pDoc,m_nCustomers

f Flags (usually multiple bit values) 标志(一般是有多位的数值)

当你设计好一个的变量名一个函数名的时候,别着急去使用他,停下来,想一想,这个变量名是否合适,是否还有更好的?也许你正在使用的是一个很不好的变量名。有些时候,需要我们权衡利弊一下,可能还要去和同事讨论一下。

变量命名规范

fn Function 函数

总之,变量名是编程的第一步,第一步走好了,后面才走得好。试想,无论是你或你的同事在使用一些好的变量名编程是一件多么轻松的事啊。

前缀 类型 描述实例
ch    char 8位字符 chGrade
ch    TCHAR 如果_UNICODE定义,则为16位字符 chName
b     BOOL 布尔值 bEnable
n     int 整型(其大小依赖于操作系统) nLength
n     UINT 无符号值(其大小依赖于操作系统) nHeight
w     WORD 16位无符号值 wPos
l     LONG 32位有符号整型 lOffset
dw    DWORD 32位无符号整型 dwRange
p     * 指针 pDoc
lp    FAR* 远指针 lpszName
lpsz LPSTR 32位字符串指针 lpszName
lpsz LPCSTR 32位常量字符串指针 lpszName
lpsz LPCTSTR 如果_UNICODE定义,则为32位常量字符串指针 lpszName
h     handle Windows对象句柄 hWnd
lpfn callback 指向CALLBACK函数的远指针

g_ global 全局的

 

前缀 符号类型 实例 范围

h Handle 句柄

附录:部分的缩写规范

IDR_ 不同类型的多个资源共享标识 IDR_MAIINFRAME 1~0x6FFF
IDD_ 对话框资源 IDD_SPELL_CHECK 1~0x6FFF
HIDD_ 对话框资源的Help上下文 HIDD_SPELL_CHECK 0x20001~0x26FF
IDB_ 位图资源 IDB_COMPANY_LOGO 1~0x6FFF
IDC_ 光标资源 IDC_PENCIL 1~0x6FFF
IDI_ 图标资源 IDI_NOTEPAD 1~0x6FFF
ID_   来自菜单项或工具栏的命令 ID_TOOLS_SPELLING 0x8000~0xDFFF
HID_ 命令Help上下文 HID_TOOLS_SPELLING 0x18000~0x1DFFF
IDP_ 消息框提示 IDP_INVALID_PARTNO 8~0xDEEF
HIDP_ 消息框Help上下文 HIDP_INVALID_PARTNO 0x30008~0x3DEFF
IDS_ 串资源 IDS_COPYRIGHT 1~0x7EEF
IDC_ 对话框内的控件 IDC_RECALC 8~0xDEEF

i Integer 整数

完整单词 缩写
A  
average avg
B  
back bk
background bg
break brk
buffer buf
C  
color cr,clr
control ctrl
D  
data dat
delete del
document doc
E  
edit edt
error err
escape esc
F  
flag flg
form frm
G  
grid grd
I  
increment inc
information info
initial init
insert ins
image img
L  
lable lab
length len
list lst
library lib
M  
manager mgr,mngr
message msg
O  
Oracle Ora
P  
panorama pano
password pwd
picture pic
point pt
position pos
print prn
program prg
S  
server srv
source src
statistic stat
string str
Sybase Syb
T  
temp tmp
text txt
U  
user usr
W  
window win,wnd

应用程序符号命名规范

l Long 长整数

 

Microsoft MFC宏命名规范名称类型

lp Long pointer 长指针

附录二、匈牙利命名法 a Array 数组 b BOOL (int) 布尔(整数) by Unsigned
Char (Byte) 无符号字符(字节) c Char 字符(字节) cb Count of bytes 字节数
cr Color reference value 颜色(参考)值 cx Count of x (Short)
x的集合(短整数) dw DWORD (unsigned long) 双字(无符号长整数) f Flags
标志(一般是有多位的数值) fn Function 函数 g_ global 全局的 h Handle
句柄 i Integer 整数 l Long 长整数 lp Long pointer 长指针 m_ Data member
of a class 一个类的数据成员 n Short int 短整数 p Pointer 指针 s String
字符串 sz Zero terminated String 以0结尾的字符串 tm Text metric 文本规则
u Unsigned int 无符号整数 ul Unsigned long (ULONG) 无符号长整数 w WORD
(unsigned short) 无符号短整数 x,y x, y coordinates (short) 坐标值/短整数
v void 空

_AFXDLL 唯一的动态连接库(Dynamic Link Library,DLL)版本
_ALPHA   仅编译DEC Alpha处理器
_DEBUG   包括诊断的调试版本
_MBCS    编译多字节字符集
_UNICODE 在一个应用程序中打开Unicode
AFXAPI   MFC提供的函数
CALLBACK 通过指针回调的函数

m_ Data member of a class 一个类的数据成员

有关项目的全局变量用g_开始,类成员变量用m_,局部变量若函数较大则可考虑用l_用以显示说明其是局部变量。

库标识符命名法 标识符值和含义

n Short int 短整数

前缀 类型 例子 g_ 全局变量 g_Servers C 类或者结构体
CDocument,CPrintInfo m_ 成员变量 m_pDoc,m_nCustomers

u ANSI(N)或Unicode(U)
d 调试或发行:D = 调试;忽略标识符为发行。

p Pointer 指针

VC常用前缀列表:

静态库版本命名规范 库描述

s String 字符串

前缀 类型 描述 例子 ch char 8位字符 chGrade ch TCHAR 16位UNICODE类型字符
chName b BOOL 布尔变量 bEnabled n int 整型 nLength n UINT 无符号整型
nLength w WORD 16位无符号整型 wPos l LONG 32位有符号整型 lOffset dw
DWORD 32位无符号整型 dwRange p * 内存模块指针,指针变量 pDoc lp FAR*
长指针 lpDoc lpsz LPSTR 32位字符串指针 lpszName lpsz LPCSTR
32位常量字符串指针 lpszName lpsz LPCTSTR 32位UNICODE类型常量指针
lpszName h handle Windows对象句柄 hWnd lpfn (*fn)() 回调函数指针
lpfnAbort

NAFXCWD.LIB 调试版本:MFC静态连接库
NAFXCW.LIB 发行版本:MFC静态连接库
UAFXCWD.LIB 调试版本:具有Unicode支持的MFC静态连接库

sz Zero terminated String 以0结尾的字符串

Windows对象名称缩写:

UAFXCW.LIB 发行版本:具有Unicode支持的MFC静态连接库

tm Text metric 文本规则

Windows对象 例子变量 MFC类 例子对象 HWND hWnd; CWnd* pWnd; HDLG hDlg;
CDialog* pDlg; HDC hDC; CDC* pDC; HGDIOBJ hGdiObj; CGdiObject*
pGdiObj; HPEN hPen; CPen* pPen; HBRUSH hBrush; CBrush* pBrush; HFONT
hFont; CFont* pFont; HBITMAP hBitmap; CBitmap* pBitmap; HPALETTE
hPalette; CPalette* pPalette; HRGN hRgn; CRgn* pRgn; HMENU hMenu;
CMenu* pMenu; HWND hCtl; CStatic* pStatic; HWND hCtl; CButton* pBtn;
HWND hCtl; CEdit* pEdit; HWND hCtl; CListBox* pListBox; HWND hCtl;
CComboBox* pComboBox; (全文完)

动态连接库命名规范 名称类型

u Unsigned int 无符号整数

_AFXDLL 唯一的动态连接库(DLL)版本
WINAPI Windows所提供的函数

ul Unsigned long (ULONG) 无符号长整数

Windows.h中新的命名规范类型定义描述

w WORD (unsigned short) 无符号短整数

WINAPI   使用在API声明中的FAR
PASCAL位置,如果正在编写一个具有导出API人口点的DLL,则可以在自己的API中使用该类型
CALLBACK 使用在应用程序回叫例程,如窗口和对话框过程中的FAR
PASCAL的位置
LPCSTR   与LPSTR相同,只是LPCSTR用于只读串指针,其定义类似(const char
FAR*)
UINT     可移植的无符号整型类型,其大小由主机环境决定(对于Windows
NT和Windows 9x为32位);它是unsigned int的同义词
LRESULT 窗口程序返回值的类型
LPARAM   声明lParam所使用的类型,lParam是窗口程序的第四个参数
WPARAM   声明wParam所使用的类型,wParam是窗口程序的第三个参数
LPVOID   一般指针类型,与(void *)相同,可以用来代替LPSTR

x,y x, y coordinates (short) 坐标值/短整数

v void 空

有关项目的全局变量用g_开始,类成员变量用m_,局部变量若函数较大则可考虑用l_用以显示说明其是局部变量。

前缀 类型 例子

g_ 全局变量 g_Servers

C 类或者结构体 CDocument,CPrintInfo

m_ 成员变量 m_pDoc,m_nCustomers

VC常用前缀列表:

前缀 类型 描述 例子

ch char 8位字符 chGrade

ch TCHAR 16位UNICODE类型字符 chName

b BOOL 布尔变量 bEnabled

n int 整型(其大小由操作系统决定) nLength

n UINT 无符号整型(其大小由操作系统决定) nLength

w WORD 16位无符号整型 wPos

l LONG 32位有符号整型 lOffset

dw DWORD 32位无符号整型 dwRange

p * Ambient memory model pointer 内存模块指针,指针变量 pDoc

lp FAR* 长指针 lpDoc

lpsz LPSTR 32位字符串指针 lpszName

lpsz LPCSTR 32位常量字符串指针 lpszName

lpsz LPCTSTR 32位UNICODE类型常量指针 lpszName

h handle Windows对象句柄 hWnd

lpfn (*fn)() 回调函数指针 Callback Far pointer to CALLBACK function
lpfnAbort

Windows对象名称缩写:

Windows对象 例子变量 MFC类 例子对象

HWND hWnd; CWnd* pWnd;

HDLG hDlg; CDialog* pDlg;

HDC hDC; CDC* pDC;

HGDIOBJ hGdiObj; CGdiObject* pGdiObj;

HPEN hPen; CPen* pPen;

HBRUSH hBrush; CBrush* pBrush;

HFONT hFont; CFont* pFont;

HBITMAP hBitmap; CBitmap* pBitmap;

HPALETTE hPalette; CPalette* pPalette;

HRGN hRgn; CRgn* pRgn;

HMENU hMenu; CMenu* pMenu;

HWND hCtl; CStatic* pStatic;

HWND hCtl; CButton* pBtn;

HWND hCtl; CEdit* pEdit;

HWND hCtl; CListBox* pListBox;

HWND hCtl; CComboBox* pComboBox;

VC常用宏定义命名列表:

前缀 符号类型 符号例子 范围

IDR_ 标识多个资源共享的类型 IDR_MAINFRAME 1~0x6FFF

IDD_ 对话框资源(Dialog) IDD_SPELL_CHECK 1~ 0x6FFF

HIDD_ 基于对话框的上下文帮助 HIDD_SPELL_CHECK 0x20001~0x26FF

IDB_ 位图资源(Bitmap) IDB_COMPANY_LOGO 1~0x6FFF

IDC_ 光标资源(Cursor) IDC_PENCIL 1~0x6FFF

IDI_ 图标资源(Icon) IDI_NOTEPAD 1~0x6FFF

ID_、IDM_ 工具栏或菜单栏的命令项 ID_TOOLS_SPELLING 0x8000~0xDFFF

HID_ 命令上下文帮助 HID_TOOLS_SPELLING 0x18000~0x1DFFF

IDP_ 消息框提示文字资源 IDP_INVALID_PARTNO 8~0xDFFF

HIDP_ 消息框上下文帮助 HIDP_INVALID_PARTNO 0x30008~0x3DFFF

IDS_ 字符串资源(String) IDS_COPYRIGHT 1~0x7FFF

IDC_ 对话框内的控制资源 IDC_RECALC 8~0xDFFF

Microsoft MFC宏命名规范

名称 类型

_AFXDLL 唯一的动态连接库(Dynamic Link Library,DLL)版本

_ALPHA 仅编译DEC Alpha处理器

_DEBUG 包括诊断的调试版本

_MBCS 编译多字节字符集

_UNICODE 在一个应用程序中打开Unicode

AFXAPI MFC提供的函数

CALLBACK 通过指针回调的函数

库标识符命名法

标识符 值和含义

u ANSI(N)或Unicode(U)

d 调试或发行:D = 调试;忽略标识符为发行

静态库版本命名规范

库 描述

NAFXCWD.LIB 调试版本:MFC静态连接库

NAFXCW.LIB 发行版本:MFC静态连接库

UAFXCWD.LIB 调试版本:具有Unicode支持的MFC静态连接库

UAFXCW.LIB 发行版本:具有Unicode支持的MFC静态连接库

动态连接库命名规范

名称 类型

_AFXDLL 唯一的动态连接库(DLL)版本

WINAPI Windows所提供的函数

Windows.h中新的命名规范

类型 定义描述

WINAPI 使用在API声明中的FAR
PASCAL位置,如果正在编写一个具有导出API人口点的DLL,则可以在自己的API中使用该类型

CALLBACK 使用在应用程序回调程序,如窗口和对话框过程中的FAR PASCAL的位置

LPCSTR 与LPSTR相同,只是LPCSTR用于只读串指针,其定义类似(const char
FAR*)

UINT 可移植的无符号整型类型,其大小由主机环境决定(对于Windows
NT和Windows 9x为32位);它是unsigned int的同义词

LRESULT 窗口程序返回值的类型

LPARAM 声明lParam所使用的类型,lParam是窗口程序的第四个参数

WPARAM 声明wParam所使用的类型,wParam是窗口程序的第三个参数

LPVOID 一般指针类型,与(void *)相同,可以用来代替LPSTR

MSDN中给出了一段遵守代码风格和匈牙利命名法的代码参考如下:

1 #include “sy.h”

2 extern int *rgwDic;

3 extern int bsyMac;

4 struct SY *PsySz(char sz[])

6 {

7 char *pch;

8 int cch;

9 struct SY *psy, *PsyCreate();

10 int *pbsy;

11 int cwSz;

12 unsigned wHash=0;

13 pch=sz;

14 while (*pch!=0)

15 wHash=wHash<>11+*pch++;

16 cch=pch-sz;

17 pbsy=&rgbsyHash[(wHash&077777)%cwHash];

18 for (; *pbsy!=0; pbsy = &psy->bsyNext)

19 {

20 char *szSy;

21 szSy= (psy=(struct SY*)&rgwDic[*pbsy])->sz;

22 pch=sz;

23 while (*pch==*szSy++)

24 {

25 if (*pch++==0)

26 return (psy);

27 }

28 }

29 cwSz=0;

30 if (cch>=2)

31 cwSz=cch-2/sizeof(int)+1;

32 *pbsy=(int *)(psy=PsyCreate(cwSY+cwSz))-rgwDic;

33 Zero((int *)psy,cwSY);

34 bltbyte(sz, psy->sz, cch+1);

35 return(psy);

36 }