匈牙利命名法介绍

匈牙利命名法介绍

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"应当是一个函数的名字,该函数将使用类型为HwndXY的参数来初始化一个"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+2CHAR

chw, wt, wz, wtz

chszststz的宽字符(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) pointerhuge pointer。在32位世界里,这不再是个问题了。

rg

数组("range"变来)。例如"rgch"表示字符数组。同C/C++用法一样,这可以是一个分配好的数组的名字,也可以是指向数组的指针的名字。

i

基本类型数组的索引。例如"ich"表示字符数组的索