Visual C++ 编码规范Word格式.docx
《Visual C++ 编码规范Word格式.docx》由会员分享,可在线阅读,更多相关《Visual C++ 编码规范Word格式.docx(10页珍藏版)》请在冰点文库上搜索。
3.2项目目录设置
为保证VC项目的备份方便、快捷,可将所有该项目有关的文件全部放到统一的目录之下,为每个项目在该目录之下建立一个目录,项目之间的公共部分建立在public目录之下,项目所需要的基础库根据所需要的基础库数目分别建立不同的目录,项目相关的测试程序都统一放在TEST目录之下。
下表显示了一个软件工程PSS系统的目录设置表:
PSS系统简介:
PSS系统有两个模块PSS_mod1和PSS_mod2,两个模块有一部分共用代码,在工程开发过程之中编写了三个测试程序PSS_TEST1、PSS_TEST2、PSS_TEST3,PSS系统开发过程之中用到了第三方公用模块Third_Mod,则该系统的目录设置如下:
一级目录
二级目录
三级目录
备注
WORK
PSS_mod1
Debug
VC集成环境生成的调试版本目录
Release
VC集成环境生成的发行版本目录
Res
VC集成环境生成的资源文件目录
Include
所属mod1的头文件
Source
所属mod2的头文件
PSS_mod2
PUBLIC
Mod1和mod2公用的头文件
Mod1和mod2公用的源代码文件
Lib
Mod1和mod2公用的库文件
TEST
PSS_Test1
测试项目一
PSS_Test2
测试项目三
PSS_Test3
Third_Mod
第三方公用模块
3.3集成环境内的项目目录设置
每个项目在VC编成编辑环境的设置都采用相对路径的设置,不可采用绝对路径,保证其备份到光盘设备后,恢复到硬盘后,不需要再过多的设置就可直接编译。
同样在用#include语句时不要太多的目录搜索,如下所示:
#include“../../../somehead.h”
改成:
#include“somehead.h”
然后在项目设置(ProjectSetting)中加入该头文件的所在目录。
3.4集成环境内的模块划分
在VC项目集成环境之下,Project视图中的FileView视图,对于每个项目的子模块都建立相应的文件夹,以对不同的子模块进行区分,比如说PSS_mod1就可建立如下几个模块:
核心数据结构、底层通用平台、界面处理模块、底层工作线程,其中底层通用平台又可划分为CJ60开发包、RCC通讯平台等等。
4文件风格
4.1文件生成
对于规范的VC派生类,尽量用ClassWizard生成文件格式,避免用手工制作的头文件/实现文件。
无论是MFC源文件还是由AppWizard生成的文件,会发现在这些类中有以下注释;
//Constructors
//Attributes
//Operations
//Overridables
//Implementation
每一次类都至少有一个//Implementation,在不同的位置MFC做不同的处理,在编写代码时最好与MFC这种风格一致。
4.2文件头部注释
文件头部注释主要是表明该文件的一些信息,其格式如下:
///////////////////////////////////////////////////////////////////////////////////////////
//文件名:
//创建者:
//创建时间:
//内容描述:
4.3空行约定
文件之中不得存在无规则的空行,比如说连续十个空行,一般来讲函数与函数之前的空行为2-3行,在函数体内部,在逻辑上独立的两个函数块可适当空行,一般为1-2行。
4.4文件规格化功能键
源文件在编写完毕时,VisualC++提供Alt+F8功能键,进行文件规格化,常使用该按键可使得文件保持规格化(注,Alt+F8功能键对连续两个CASE语句则会发生处理错误,不能规格化)。
5函数风格
5.1函数注释
ClassWizard自动生成的函数,如消息响应函数,则不必太多的注释和解释;
对于自行编写的函数,若是系统关键函数,则必须在函数实现部分的上方标明该函数的信息,格式如下:
//函数名:
//编写者:
//参考资料:
//功能:
//输入参数:
//输出参数:
//备注:
5.2代码缩进
每一个嵌套的函数块,使用一个TAB缩进(可以设定为4个空格),大括号必须放在条件语句的下一行,单独成一行,便于匹对:
if(condition)
{
while(condition)
}
5.3函数命名
“动词”、“动词+名词”,如:
drawBox()
6变量风格
变量尽量采用匈牙利命名法,同时结合VC的原则;
一般情况下,变量的取名方式为:
<
scope>
prefix>
qualifier>
有关项目的全局变量必须用g_开始,类成员变量用m_,局部变量若函数较大则可考虑用l_用以显示说明其是局部变量。
前缀
类型
例子
g_
GlobalVariable
g_Servers
C
Classorstructure
CDocument,CPrintInfo
m_
Membervariable
m_pDoc,m_nCustomers
VisualC++常用前缀列表:
描述
ch
char
8-bitcharacter
chGrade
TCHAR
16-bitcharacterif_UNICODEisdefined
chName
b
BOOL
Booleanvalue
bEnabled
n
int
Integer(sizedependentonoperatingsystem)
nLength
UINT
Unsignedvalue(sizedependentonoperatingsystem)
w
WORD
16-bitunsignedvalue
wPos
l
LONG
32-bitsignedinteger
lOffset
dw
DWORD
32-bitunsignedinteger
dwRange
p
*
Ambientmemorymodelpointer
pDoc
lp
FAR*
Farpointer
lpDoc
lpsz
LPSTR
32-bitpointertocharacterstring
lpszName
LPCSTR
32-bitpointertoconstantcharacterstring
LPCTSTR
32-bitpointertoconstantcharacterstringif_UNICODEisdefined
h
handle
HandletoWindowsobject
hWnd
lpfn
(*fn)()
callbackFarpointertoCALLBACKfunction
lpfnAbort
Windows对象名称缩写:
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
hPalette;
CPalette*
pPalette;
HRGN
hRgn;
CRgn*
pRgn;
HMENU
hMenu;
CMenu*
pMenu;
hCtl;
CStatic*
pStatic;
CButton*
pBtn;
CEdit*
pEdit;
CListBox*
pListBox;
CComboBox*
pComboBox;
VisualC++常用宏定义命名列表:
符号类型
符号例子
范围
IDR_
标识多个资源共享的类型
IDR_MAINFRAME
1to0x6FFF
IDD_
对话框资源(Dialog)
IDD_SPELL_CHECK
HIDD_
基于对话框的上下文帮助(ContextHelp)
HIDD_SPELL_CHECK
0x20001to0x26FF
IDB_
位图资源(Bitmap)
IDB_COMPANY_LOGO
IDC_
光标资源(Cursor)
IDC_PENCIL
IDI_
图标资源(Icon)
IDI_NOTEPAD
ID_
IDM_
工具栏或菜单栏的命令项
ID_TOOLS_SPELLING
0x8000to0xDFFF
HID_
命令上下文帮助(CommandHelpcontext)
HID_TOOLS_SPELLING
0x18000to0x1DFFF
IDP_
消息框提示文字资源
IDP_INVALID_PARTNO
8to0xDFFF
HIDP_
消息框上下文帮助(Message-boxHelpcontext)
HIDP_INVALID_PARTNO
0x30008to0x3DFFF
IDS_
字符串资源(String)
IDS_COPYRIGHT
1to0x7FFF
对话框内的控制资源(Control)
IDC_RECALC
7注释风格
单行注释用双斜杠进行注释;
多行注释用/**/进行注释;
在封存的某一版本的源代码之中不得存在由于调试而留下的大篇的注释。
注释一行不要太多,一般60个字符以内(保证VC集成编辑环境的可见区域之内),如有超过,则换行处理。