编码的规范和建议.docVIP

TOC \o 1-5 \h \z HYPERLINK 上七 *1* S s夕 %j %i* S 上上 *1^ *1^1*^ ^1% ^4* ^7** 修改人 〈时间 版本 〈描述 ************************************************************************/ 2-7类的版式 2-7-1类的方法声明排在数据声明前，构造函数排在其他方法前，公有成员排在保护成 2-7-1 员前，保护成员排在私有成员前。 2-7-2类的成员变量一定声明成私有成员. 2-7-3成员变量的使用推荐使用Get...,Set... 2-7-4成员变量初始化使用类构造函数():变量名(值) 2-7-5外部不使用的函数的一定定义成私有 第3章命名规则 3-1共性规则 1-1标识符应当直观且可以拼读，可望文知意，不必进行“解码”。 标识符最好采用英文单词或英组合，便于记忆和阅读。切忌使用汉语拼音来命名。 程序中的英文单词一般不会太复杂，用词应当准确。例如不要把Currentvalue写成 Now Value。 1-2标识符的长度应当符合“min-length max-informationn原则。 一般来说，长名字能更好地表达含义，所以函数名、变量名、类名长达十儿个字符 不足为怪。那么名字是否越长约好？不见得！例如变量名maxval就比 maxValueUntilOverflow好用。单字符的名字也是有用的,常见的如i, j, k, m, n, x, y, z 等，它们通常可用作函数内的局部变量。 1-3命名规则尽量与所采用的操作系统或开发工具的风格保持一致。 采用Windows应用程序的标识符通常采用“大小写”混排的方式,如AddChild0除 了变量名. 1-4作为一种简化的手段，可以使用一些常见单词的缩写作为符号名的前缀或后! 一般使用后缀可读性更强一些，但一些已广泛使用的习惯则除外。 例如,startPnt就比ptStart可读性更强,pObj则比objPtr nJ能更可读。 1-5类名、变量名一般采用名词或者名词性短语，函数名一般采用动词或谓词结构。 例如： class Box; float oldValue; void DisplayO; bool HasMoneyO; 1-6全局函数的名字应当使用“动词”或者“动词+名词”(动宾词组)。类的成员函 数可以只使用“动词”，而省略掉的指代类本身的名词。 例如： DrawBox(); //全局函数 box-Draw(); //类的成员函数 1-7用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。 例如： int minVaiue; int maxValue; int SetValue(...); int GetValue(...); 3-1-8程序中不要出现仅靠大小写区分的相似的标识符。 例如; ? ? int x, X; void foo(in t x); void Foo (float x); 3-1-9尽量避免名字中出现数字编号，除非逻辑上的确需要编号。 当某儿个变量确实具有某些逻辑上的顺序性时，可以使用数字编号。 3-1-10对话框类加前缀Dig 3-2简单的Windows应用程序命名规则 3-2-1类名和函数名用大写字母开头的单词组合而成。 3-2-2变量和参数用小写字母开头的单词组合而成。 3-2-3宏全用大写的字母，用下划线分割单词。 3-2-4静态变量加前缀s_ （表示static）,类的数据成员加前缀m_ （表示member）。不 使用全局变量， 3-2-5为了防止某一软件库中的一些标识符和其它软件库中的冲突，可以为各种标识符 加上能反映软件性质的前缀。 例如三维图形标准OpenGL的所有库函数均以gl开头，所有常量（或宏定义）均以 GL开头。 3~3常见前后缀 3-3-1 MFC常见类型的前 3-3-1 MFC常见类型的前 3-3-2布尔型使用B00L 类型 前缀 Array ar CStringArray sa BOOL/bool b UINT/short n int ■ 1 LONG/long 1 WORD w DWORD dw float f double d char c charVTCHAR* psz LPTSTR/LPCTSTR lpsz CString str COLORREF cr LP... (e.g.LPLOGPALETTE) Ip POINT/CPoint pt H...(e.g.HANDLE/HGLOBAL) h 3-3-3 VC中…些控件的前缀。 目标 前缀 ComboBox cmb Dialog dig Edit edt ListBox 1st Picture p