匈牙利命名法介绍
匈牙利命名法介绍
MFC、句柄、控件及结构的命名规范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 | 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; |
一般前缀命名规范
前缀 | 类型 | 实例 |
C | 类或结构 | CDocument,CPrintInfo |
m_ | 成员变量 | m_pDoc,m_nCustomers |
变量命名规范
前缀 | 类型 | 描述 | 实例 |
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函数的远指针 |
应用程序符号命名规范
前缀 | 符号类型 | 实例 | 范围 |
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 |
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 |
1.1 构造匈牙利名称
一个通常的匈牙利名称由一个或者多个前缀(prefix)、一个基本标识(base tag)和一个修饰符(qualifier)拼接而成。基本标识指示了变量的类型(如"co"代表color),前缀修正该类型(如"rg"表示数组,那么"rgco"就表示颜色数组),修饰符描述了该特定类型的应用(如"rgcoGray"表示用作灰度的颜色数组)。并非所有名字都会使用全部组成元素,前缀往往是不需要的,而当类型的应用是显而易见的时候,比如当代码中只包含一个相关类型时,修饰符也可以省略。
值得提醒的是:许多(也许绝大部分)基本标识和修饰符将是应用程序相关的,因为它们被用于表示应用程序定义的类型和应用。虽然我们已经为一些基本类型定义了标准标识(下面将列出其中一部分),但是在更适于使用抽象类型的场合下使用这些标准标识是错误的。例如,如果一个color恰好是用long来实现的,那么有人可能会用"rgl"来标识一个颜色数组,但是这样将破坏对color的抽象。
当匈牙利命名法用于函数名称时,修饰符通常仅仅标识了函数的动作。有时在基本标识符后添加描述函数参数的匈牙利类型会很有用。当然,函数名的首字母一定要大写。例如"FInitFooFromHwndXY"应当是一个函数的名字,该函数将使用类型为Hwnd,X和Y的参数来初始化一个"foo"结构,并且返回一个Boolean成功代码。这种做法并非强制性的,只有当这样做会让函数名更易于理解才这样做。
1.2 标准基本标识
下面的表中给出了基本类型的标准基本标识。如上所述,应用程序将为其内部类型定义许多自己的标识。
f |
标志(BOOL)。取值为TRUE或者FALSE。修饰符应当描述何时该标志为TRUE,例如fError表示当错误发生时变量为TRUE。 |
ch |
单字节字符(CHAR)。 |
sz |
以0结尾的CHAR型字符串(经典的C字符串)。有时可以描述字符串的最大长度,如"sz255"表示实际的字符串体可以容纳255个字符,因此必需分配256个字符。 |
st |
带长度前缀的CHAR型字符串。这种字符串长度不超过255个字符,因为其长度必须存放在一个字节中。如同sz一样,可以用"st32"来表示字符串最大长度为32,因此需要分配33个字符空间来存放字符及其长度。 |
stz |
带长度前缀同时也以0结尾的CHAR型字符串。注意如果在名称中描述了长度length,那么至少要分配length+2个CHAR。 |
chw, wt, wz, wtz |
ch,sz,st和stz的宽字符(WCHAR)版本。所有最终用户可见的字符串都必须使用宽字符串(UNICODE)。 |
fn |
函数。通常和"p"前缀(见下)连用成为"pfn",因为在C中只能将函数地址存放在变量中。 |
b |
一个BYTE。 |
w |
一个16位的无符号数量值(WORD, SHORT, or USHORT)。 |
dw |
一个32位的无符号双字(DWORD)。 |
l |
一个LONG (有符号32位数量值). |
u |
一个无符号长整型数(ULONG)。在经典的匈牙利命名法中,这代表一个无符号word,在Office中,这代表一个无符号32位数量值,与"dw"相同,但是当类型是数值时更倾向用"u"标识(和ULONG类型)。 |
v |
Void类型。总是和"p"连用构成"pv",标识指向未知类型的指针。 |
sc |
OLE SCODE |
hr |
OLE HRESULT |
var |
OLE VARIANT |
varg |
OLE VARIANTARG |
1.3 标准前缀
下面表中给出了用于修饰基本标识类型的标准前缀。可以使用一个或者多个前缀。应用程序有可能(但是可能很罕见)需要定义自己的前缀(典型情况是一个应用程序将只定义基本标识和修饰符)。
p |
指针。例如"pch"标识指向一个字符的指针,在经典的微软匈牙利命名法中,"p"代表near pointer,相应地,"lp"和"hp"用于表示long (far) pointer和huge pointer。在32位世界里,这不再是个问题了。 |
rg |
数组(从"range"变来)。例如"rgch"表示字符数组。同C/C++用法一样,这可以是一个分配好的数组的名字,也可以是指向数组的指针的名字。 |
i |
基本类型数组的索引。例如"ich"表示字符数组的索 |