c语言编写规范定义.pdfVIP

Ｃ语言编码规范－－第一篇 目 录 1.文件结构（ 4 条规则＋ 6 条建议） ... 1 1.1 版权和版本的声明 ... 1 1.2 头文件的结构 ... 2 1.3 定义文件的结构 ... 3 1.4 头文件和定义文件使用（ 4 条规则＋ 6 条建议） ... 3 2.程序版式（ 34 条规则＋ 2 条建议） ... 4 2.1 空行（ 4 条规则） ... 4 2.2 代码行（ 5 条规则＋ 1 条建议） ... 4 2.3 代码行内的空格（ 6 条规则＋ 1 条建议） ... 5 2.4 对齐（ 4 条规则） ... 6 2.5 长行拆分（ 2 条规则） ... 7 2.6 修饰符的位置（ 1 条规则） ... 8 2.7 注释（ 12 条规则） ... 8 3.标识符命名（ 15 条规则＋ 1 条建议） ... 8 4.常量（ 7 条规则） ... 10 4.1 const 与#define 的比较（ 2 条规则） ... 10 4.2 常量定义（ 5 条规则） ... 10 5.变量（ 11 条规则） ... 11 6.表达式和基本语句（ 17 条规则＋ 3 条建议） ... 11 6.1 运算符的优先级（ 1 条规则） ... 11 6.2 复合表达式（ 4 条规则） ... 12 6.3 if 语句布尔表达式（ 7 条规则） ... 12 6.4 循环语句（ 1 条规则＋ 3 条建议） ... 15 6.5 switch 语句（ 2 条规则） ... 16 6.6 goto 语句（ 1 条规则） ... 16 7.函数设计（ 16 条规则＋ 10 条建议） ... 16 7.1 注释规则（ 1 条规则） ... 16 7.2 函数的使用（ 1 条规则） ... 16 7.3 参数的规则（ 4 条规则＋ 2 条建议） ... 17 7.4 返回值的规则（ 6 条规则） ... 17 7.5 函数内部实现的规则（ 2 条规则） ... 17 7.6 其它建议（ 6 条建议） ... 18 7.7 使用断言（ 2 条规则＋ 2 条建议） ... 18 8.内存管理（ 5 条规则） ... 18 8.1 内存使用注意的问题（ 5 条规则） ... 18 9.其他规范及建议（ 27 条建议） ... 19 9.1 提高程序的效率（ 6 条建议） ... 19 9.2 编译问题（ 2 条建议） ... 19 9.3 兼容性问题（ 8 条建议） ... 19 9.4 性能问题（ 4 条建议） ... 19 9.5 其他一些有益的建议（ 7 条建议） ... 20 1.文件结构（ 4 条规则＋ 6 条建议） C 程序文件通常分为两类文件： 一类文件用于保存程序的声明（ declaration ），称为头文件。头文件以“ .h ”为后缀。 另一类文件用于保存程序的实现（ implementation ），称为定义（ definition ）文件。定义文 件以“ .c ”为后缀。对于简单的 C语言程序，一般在把头文件和程序定义文件放在一起，只有一 个 .c 定义文件即可。而对于复杂的程序，则多采用头文件包含的形式并通过多个定义文件实现。 1.1 版权和版本的声明 版权和版本的声明一般应该位于头文件和定义文件的开头（参见示例 1-1 ），主要内容包括： (1) 版权信息； (2) 文件名称、文件标识、摘要； (3) 当前版本号、作者 / 修改者、修改日期、修改描述等； (4) 版本历史信息、原作者、完成日期等。 /* * Copyright (c) 2004, 北大青鸟培训中心 * All rights reserved. * * 文件名称： filename.h * 文件标识：根据软件工程设置 * 摘要： 简要描述本文件的作用和内容等 */ // 下面其它的声明代码 … // 下面是原作者、版本、完成、日期和当前版本的信息 /* 当前版本： 1.0.1 * 作者： 修改者名字，修改