OSSD研发规范-VC-v1.5.docVIP

浪潮通信信息系统有限公司OSSD 文 档 编 号 文档版本 密级 OSSD-YFGF-VC-15 V 1.5 文档名称：OSSD研发规范 VC 共 页 OSSD研发规范 VC (仅供内部使用) V 1.5.0  浪潮通信信息系统有限公司 2009-8-27 版 本 历 史 版本/状态 作者 参与者 起止日期 备注 V1.5 宋志钢 2009-7-18 目 录 TOC \o 1-3 \h \z \u HYPERLINK \l _Toc239163925 1. 工程设置规范 PAGEREF _Toc239163925 \h 3 HYPERLINK \l _Toc239163926 1.1. 工程命名规则 PAGEREF _Toc239163926 \h 3 HYPERLINK \l _Toc239163927 1.2. 工程的目录结构设置 PAGEREF _Toc239163927 \h 3 HYPERLINK \l _Toc239163928 1.3. 集成环境内的项目目录设置 PAGEREF _Toc239163928 \h 4 HYPERLINK \l _Toc239163929 1.4. 项目修改记录追踪 PAGEREF _Toc239163929 \h 5 HYPERLINK \l _Toc239163930 2. 文件设置规范 PAGEREF _Toc239163930 \h 5 HYPERLINK \l _Toc239163931 2.1. 文件生成 PAGEREF _Toc239163931 \h 5 HYPERLINK \l _Toc239163932 2.2. 头部注释 PAGEREF _Toc239163932 \h 5 HYPERLINK \l _Toc239163933 2.3. 文件规格化功能键 PAGEREF _Toc239163933 \h 6 HYPERLINK \l _Toc239163934 3. 函数使用规范 PAGEREF _Toc239163934 \h 6 HYPERLINK \l _Toc239163935 3.1. 函数名的约定 PAGEREF _Toc239163935 \h 6 HYPERLINK \l _Toc239163936 3.2. 函数注释 PAGEREF _Toc239163936 \h 6 HYPERLINK \l _Toc239163937 4. 变量命名规则 PAGEREF _Toc239163937 \h 7 HYPERLINK \l _Toc239163938 4.1. 注释风格 PAGEREF _Toc239163938 \h 11 HYPERLINK \l _Toc239163939 4.2. 常量命名和宏定义 PAGEREF _Toc239163939 \h 11 HYPERLINK \l _Toc239163940 5. 代码规范 PAGEREF _Toc239163940 \h 12 工程设置规范 工程命名规则 ?????在VC++之中，项目名为最后可执行文件名，所以项目名最好以最终的可执行文件名一致。 工程的目录结构设置 ?????为保证VC项目的备份方便、快捷，将所有该项目有关的文件全部放到统一的目录之下，为每个项目在该目录之下建立一个目录，项目之间的公共部分建立在public目录之下，项目所需要的基础库根据所需要的基础库数目分别建立不同的目录，项目相关的测试程序都统一放在TEST目录之下。 举例说明： Work系统有两个模块mod1和mod2，两个模块有一部分共用代码，在工程开发过程之中编写了三个测试程序TEST1、TEST2、TEST3，Work系统开发过程之中用到了第三方公用模块Third_Mod，则该系统的目录设置如下： ?一级目录 二级目录 三级目录 备注 WORK mod1 Debug VC集成环境生成的调试版本目录 Release VC集成环境生成的发行版本目录 Res VC集成环境生成的资源文件目录 Include 所属mod1的头文件 Source 所属mod2的头文件 mod2 Debug VC集成环境生成的调试版本目录 Release VC集成环境生成的发行版本目录 Res VC集成环境生成的资源文件目录 Include 所属mod1的头文件 Source 所属mod2的头文件 PUBLIC Include Mod1和mod2公用的头文件 Source Mod1和mod2公用的源代码文件 Lib Mod1和mod2公用的库文件 TEST Test1 测试项目一 Test2 测试项目三 Test3 测试项目三 Third_Mod 第三方公用模