由于一直在命名方面很亂,這次決定好好規範下。
轉載至:http://blog.sina.com.cn/s/blog_52cbfc3f0100fdy6.html
匈牙利命名法是一種程式設計時的命名規範。基本原則是:變量名=屬性+類型+對象描述。其中每一對象的名稱都要求有明确含義,可以取對象名字全稱或名字的一部分。命名要基于容易記憶容易了解的原則。目前在Windows程式開發和MFC程式開發中常用的命名規則是匈牙利命名法。下面就是HN命名法的一般規則。
屬性部分
全局變量 g_
const常量 c_
c++類成員變量 m_
靜态變量 s_
類型部分
指針 p
函數 fn
無效 v
句柄 h
長整型 l
布爾 b
浮點型(有時也指檔案) f
雙字 dw
字元串 sz
短整型 n
雙精度浮點 d
計數 c(通常用cnt)
字元 ch(通常用c)
整型 i(通常用n)
位元組 by
字 w
實型 r
無符号 u
描述部分
最大 Max
最小 Min
初始化 Init
臨時變量 T(或Temp)
源對象 Src
目的對象 Dest
這裡順便寫幾個例子:
(1) hwnd : h 是類型描述,表示句柄, wnd 是變量對象描述,表示視窗,是以 hwnd 表示視窗句柄;
(2) pfnEatApple : pfn 是類型描述,表示指向函數的指針, EatApple 是變量對象描述,是以它表示
指向 EatApple 函數的函數指針變量。
(3) g_cch : g_ 是屬性描述,表示全局變量,c 和 ch 分别是計數類型和字元類型,一起表示變量類
型,這裡忽略了對象描述,是以它表示一個對字元進行計數的全局變量。
小結:匈牙利命名法
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 可移植的無符号整型類型,它是unsigned int的同義詞
LRESULT 視窗程式傳回值的類型
LPARAM 聲明lParam所使用的類型,lParam是視窗程式的第四個參數
WPARAM 聲明wParam所使用的類型,wParam是視窗程式的第三個參數
LPVOID 一般指針類型,與(void *)相同,可以用來代替LPSTR
匈牙利程式設計命名規則
匈牙利命名法包括與下列命名有關的約定:變量、函數、類型和常量、類。
(1)變量的匈牙利命名法。
應用匈牙利命名法,所有的變量名都應該以字首+名字的形式出現。比如:
char* szName; //以0為結束符的符串,存儲的是名字變量
BOOL bCanExit; //布爾型變量,能退出嗎
DWORD dwMaxCount; //32位雙字變量,最大記數
(2)函數的匈牙利命名法。
與變量的命名不同的是,函數的命名不帶字首,函數中每一個單詞的開頭字母都要大寫。比如:
int ConvertNumber( int ix );
void ShowMessage( char* szMessage );
(3)類型和常量的匈牙利命名法。
所有的類型和常量命名都是大寫字母,比如:
#define MAX_NUM 256
typedef unsigned char UCHAR;
(4)類的匈牙利命名法。
類的命名規則是在名稱前面加上一個字母C,比如:
class CMyClass
{
public:
CMyClass();
~CMyClass();
…
private:
m_szName;
…
};
在對類的成員變量命名的時候,一般要在變量名前加上m_字首。一般來說,最好按照此規則來程式設計,這樣在以後讀程式或者修改程式時,能夠更快地了解變量的作用。