匈牙利命名法

系统性

整体性

可读性

条理性

有注释

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

前缀类型中文说明
aArray数组
bBOOL(int)布尔(整数)
byUnsigned Char(Byte)无符号字符(字节)
cChar字符(字节)
cbCount of Bytes字节数
crColor Reference Value颜色(参考)值
cxCount of x(Short)x的集合(短整数)
fFlags(usually multiple bit values)标志(一般是有多位的数值)
fnFunction函数
g_Global全局的
hHandle句柄
iInteger整数
lLong长整数
lpLong Pointer长指针
m_Data Member of a Class一个类的数据成员
nShort Integer短整数
pPointer指针
sString字符串
szZero Terminated String以零结尾的字符串
tmText Metric文本规则
uUnsigned Integer无符号整数
ulUnsigned Long(ULONG)无符号长整数
wWORD(Unsigned Short)无符号短整数
x,yx, y Coordinates (Short)坐标值(短整数)
vVoid
常用前缀

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

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

VC常用前缀列表:

前缀类型描述例子
chchar8位字符chGrade
chTCHAR16位Unicode集字符chName
bBOOL布尔变量bEnable
nint整型nLength
nUINT无符整型nLength
wWORD16位无符号整型wPos
lLong32位有符号整型lOffset
dwDWORD32位无符号整型dwRange
p*指针变量,内存模块指针(Ambient memory model point)pDoc
lpFar*长指针lpDoc
lpszLPSTR32位字符串指针lpszName
lpszLPCSTR32位常量字符串指针lpszName
lpszLPCTSTR32位Unicode集常量指针lpszName
hhandleWindows对象句柄hWnd
lpfn(*fn)() 回调函数指针 Callback Far pointer to CALLBACK functionlpfnAbort
VC常用前缀列表:

MFC、句柄、控件及结构的命名规范:

Windows类型样本变量MFC类样本变量
HWNDhWndCWnd*pWnd
HDLGhDlgCDialog*pDlg
HDChDCCDC*pDC
HGDIOBJhGdiObjCGdiObject*pGdiObj
HPENhPenCPen*pPen
HBRUSHhBrushCBrush*pBrush
HFONThFontCFont*pFont
HBITMAPhBitmapCBitmap*pBitmap
HPALETTEhPaltteCPalette*pPalette
HRGNhRgnCRgn*pRgn
HMENUhMenuCMenu*pMenu
HWNDhCtlCState*pState
HWNDhCtlCButton*pButton
HWNDhCtlCEdit*pEdit
HWNDhCtlCListBox*pListBox
HWNDhCtlCComboBox*pComboBox
HWNDhCtlCScrollBar*pScrollBar
HSZhszStrCStringpStr
POINTptCPointpt
SIZEsizeCSizesize
RECTrectCRectrect
MFC、句柄、控件及结构的命名规范:

一般前缀命名规范:

前缀类型实例
C类或结构Cdocument, CPrintInfo
m_成员变量m_pDoc, m_nCustomers
一般前缀命名规范:

变量命名规范:

前缀类型描述实例
chchar8位字符chGrade
chTCHAR如果_UNICODE定义,则为16位字符chName
bBOOL布尔值bEnable
nint整型(其大小依赖于操作系统)nLength
nUINT无符号值(其大小依赖于操作系统)nHeight
wWORD16位无符号值wPos
lLONG32位有符号整型lOffset
dwDWORD32位无符号整型dwRange
p*指针pDoc
lpFAR*远指针lpszName
lpszLPSTR32位字符串指针lpszName
lpszLPCSTR32位常量字符串指针lpszName
lpszLPCTSTR如果_UNICODE定义,则为32位常量字符串指针lpszName
hhandleWindows对象句柄hWnd
lpfncallback指向CALLBACK函数的远指针 
变量命名规范:

应用程序符号命名规范

前缀符号类型实例范围
IDR_不同类型的多个资源共享标识IDR_MAIINFRAME1~0x6FFF
IDD_对话框资源IDD_SPELL_CHECK1~0x6FFF
HIDD_对话框资源的Help上下文HIDD_SPELL_CHECK0x20001~0x26FF
IDB_位图资源IDB_COMPANY_LOGO1~0x6FFF
IDC_光标资源IDC_PENCIL1~0x6FFF
IDI_图标资源IDI_NOTEPAD1~0x6FFF
ID_来自菜单项或工具栏的命令ID_TOOLS_SPELLING0x8000~0xDFFF
HID_命令Help上下文HID_TOOLS_SPELLING0x18000~0x1DFFF
IDP_消息框提示IDP_INVALID_PARTNO8~0xDEEF
HIDP_消息框Help上下文HIDP_INVALID_PARTNO0x30008~0x3DEFF
IDS_串资源IDS_COPYRIGHT1~0x7EEF
IDC_对话框内的控件IDC_RECALC8~0xDEEF
应用程序符号命名规范

Microsoft MFC宏命名规范:

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

库标识符命名法:

标识符值和含义
uANSI(N)或Unicode(U)
d调试或发行:D = 调试,忽略标识符为发行。
库标识符命名法

静态库版本命名规范:

描述
NAFXCWD.LIB调试版本:MFC静态连接库
NAFXCW.LIB发行版本:MFC静态连接库
UAFXCWD.LIB调试版本:具有Unicode支持的MFC静态连接库
UAFXCW.LIB发行版本:具有Unicode支持的MFC静态连接库
静态库版本命名规范

动态连接库命名规范:

名称类型
_AFXDLL唯一的动态连接库(DLL)版本
WINAPIWindows所提供的函数
动态连接库命名规范

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
Windows.h中新的命名规范

已发布

分类

来自

标签:

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

这个站点使用 Akismet 来减少垃圾评论。了解你的评论数据如何被处理