变量(还包含宏)的命名规则,比較系统和彻底的有 Windows 编程中用到的匈牙利命名法。匈牙利命名法通过在变量名前面加上对应的小写字母的符号标识作为前缀,标识出变量的作用域,类型等。这些符号能够多个同一时候使用,顺序是先m_(成员变量),再指针,再简单数据类型,再其它。比如:m_lpszStr, 表示指向一个以0字符结尾的字符串的长指针成员变量。


有关匈牙利命名法的一点有意思的说明是它的名字的由来。这样的命名技术是由一位能干的 Microsoft 程序猿查尔斯·西蒙尼(Charles Simonyi) 提出的,他出生在匈牙利。在 Microsoft 公司中和他一起工作的人被教会使用这样的约定。这对他们来说一切都非常正常。但对那些 Simonyi 领导的项目组之外的人来说却感到非常奇特,他们觉得这是死板的表达方式,甚至说代有这样奇怪的外观是由于它是用匈牙利文写的。从此这样的命名方式就被叫做匈牙利命名法。匈牙利命名法关键是:标识符的名字以一个或者多个小写字母开头作为前缀;前缀之后的是首字母大写的一个单词或多个单词组合,该单词要指明变量的用途。


匈牙利命名法中经常使用的小写字母的前缀




前  缀



类  型



a



数组 (Array)



b



布尔值 (Boolean)



by



字节 (Byte)



c



有符号字符 (Char)



cb



无符号字符 (Char Byte,没有多少人用)



cr



颜色參考值 (ColorRef)



cx,cy



坐标差(长度 ShortInt)



dw



Double Word



fn



函数



h



Handle



i



整型



l



长整型 (Long Int)



lp



Long Pointer



m_



类的成员



n



短整型 (Short Int)



np



Near Pointer



p



Pointer



s



字符串型



sz



以null做结尾的字符串型 (String with Zero End)



w



Word



可是在不论什么情况下,都硬性规定使用匈牙利命名法是迂腐的。尤其是 Unix 编程,在使用没有变量名、keyword自己主动补齐功能的编辑器,如 vi 下,去敲入大写和小写混合的变量名是痛苦的。事实上仅仅要注意两个原则:1) 含义清晰,不易混淆; 2) 不和其他模块、系统API的命名空间相冲突就可以。

1.有意识的为变量名、宏名加上本模块的keyword,就不至于和其他模块、系统API的命名空间相冲突;比如: 宏的名称过短,如:DEBUG; 或_DEBUG,非常可能和别的模块,系统模块相冲突;

2.局部变量尤其是循环变量外,使用约定俗成的 i,j,k ,没有问题;

3.宏、常量、枚举enum,所实用大写字母;

4.全局变量加上前缀 "g",后面跟上首字母大写的单词;


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