C代码编写规范.docVIP

目录 C代码编写规范 1 概述 5 规则 5 1.1 文件结构 5 1.1.1 文件扩展名 5 1.1.2 版权和版本的声明 5 1.1.3 头文件和定义文件结构 6 1.2 程序排版 9 1.2.1 概述 9 1.2.2 缩进、空行、空格与对齐 9 1.2.3 长行拆分 11 1.2.4 修饰符的位置 12 1.2.5 注释 12 1.2.6 可读性 14 1.2.7 自定义类型 15 1.2.8 预编译指令 16 1.3 命名规则 17 1.3.1 基本原则 17 1.3.2 具体命名原则 17 1.4 表达式和基本语句 19 1.4.1 表达式 19 1.4.2 基本语句 19 1.4.3 常量规则 20 1.4.4 变量规则 21 1.4.5 结构 22 1.5 函数规则 24 1.5.1 参数规则 24 1.5.2 返回值的规则 24 1.5.3 函数内部规则 25 1.5.4 函数使用方法 25 1.5.5 函数建议 27 1.5.6 断言 28 1.6 代码编辑、编译与审查 29 1.6.1 代码编辑 29 1.6.2 代码编译 29 1.6.3 代码审查 30 1.7 代码测试与维护 30 1.8 宏 31 1.9 程序效率 31 1.10 质量保证 33 附件 35 1.11 附件一 运算符顺序 35 1.12 附件二 英文常用缩写 36 概述 本文档的目的在于规范C代码撰写，所有软件工程师提交代码必须严格按照本文档执行。 规则 文件结构 文件扩展名 每个C程序分为两个文件。一个文件用于保存程序的声明(declaration)，为头文件。另一个文件用于保存程序的实现(implementation)，为定义(definition)文件。 C程序的头文件以“.h”为后缀，C程序的定义文件以“.c”为后缀。 版权和版本的声明 版权和版本的声明位于头文件和定义文件的开头。主要内容有： 版权信息； 文件名称，标识符，摘要； 当前版本号，作者/修改者，完成日期； 具体的定义如下： /* ***********************************Copyright (c)******************************** * *------------------------------------------------------------------------------- * 文 件 名: ???.c * 文件描述: ??? * * 作 者: (姓名、邮箱，QQ等) * 创建日期: 2009-12-01 * * 编译环境: Tornado2.0Wind River Workbench 3.0 TOOL=diab * 硬件环境: ATMEL AT91SAM9G20 fclk=400M *------------------------------------------------------------------------------- * 初始版本： V1.0 * *----------------------------------修改记录------------------------------------- * 修 改 人: 甲乙丙丁 * 修改日期: 2010.8.4 * 当前版本： V1.1 * 修改描述: 新增任务tidtaskTouchScreen *------------------------------------------------------------------------------- ******************************************************************************** */ 代码区 /* ******************************************************************************** * End Of File ********************************************************************************/ 注意： 版权版本信息和文件信息必须出现在文件的最开始； 其中修改者信息不止一项。当第一位修改者修改完成后，提交到版本库时，必须填写修改者姓名、修改日期、修改的版本号以及修改描述；当第二位修改者修改后，在提交到版本库之前，也必须填写相关修改信息； 所有文件必须以”End Of File”字样结束，文件最后空一行； 代码区与文件头、尾信息之间各空一