c程序设计标准规范.docVIP

ANSI C/C++程序设计规范 文件编号： SDSI-QG-28 起草部门： 审 核 人： 批 准 人： 同意日期：20XX年4月 版本标识： 1.0版 目　　录 TOC \o 1-3 \h \z 1 目标 3 2 定义 3 3 程序设计要求 3 4 程序风格定义 4 4.1 编程风格 4 4.1.1 书写风格 4 4.1.2 程序结构 4 4.1.3 程序注释 5 4.1.4 申明 6 4.1.5 临时变量 6 4.2 部分规则及提议： 6 5 命名规范 6 5.1 具体定义 7 5.1.1 函数（Function） 7 5.1.2 变量命名规范 7 5.1.3 常见变量要求： 8 5.2 类定义规范 8 5.2.1 类命名 8 5.2.2 类注释 8 5.2.3 类申明 9 目标 为使整个系统保持统一和一致编程风格及技术，提升程序代码规范化程度，制订该部分规范。这些规范能够提升编码质量、增强可读性、提升排错轻易程度、加强可维护性、和提升代码可重用性和可移植性。 定义 程序块：是整个C/C++语言程序中完成某一细分功效含有相对独立性一段程序，其关键内容包含注释、变量定义及程序正文三部分组成。 子程序块：程序块中某一细分功效程序块称为子程序块。 临时变量：临时变量是每次赋值作用域较小，通常不应超出五行程序。临时变量名字本身只是说明了该变量是一个临时操作数，不含有任何意义，但在某一作用域内代表不一样具体含义。 程序设计要求 据所确定标准进行程序设计。 二、模块内耦合度要高，模块间耦合度要低。在修改一个模块时，尽可能不要对其它模块造成影响，若影响较大，有必需重新计划模块。 三、每个程序模块行数不限，但对于程序模块中相对独立性较高程序块最好作成函数，每个函数代码行数标准上不超出200行，常常使用函数最好做成函数库，必需确保在整个系统中同名函数有相同定义。 四、尽可能为程序块加上明确汉语注释。对于较复杂程序或算法需要注释文档，并在程序中注明注释文档及在文档中注明程序名。 开发规范 风格规范 缩进风格 概述 缩进用于提升代码可阅读性，缩进通常采取TAB键来控制缩进风格，但为了不一样TAB值问题，缩进采取空格缩进。在UE中，通常将TAB设置成为2个空格。 要求描述 程序采取缩进风格，在需要缩进地方使用2个空格进行缩进。 函数或过程开始、结构定义及循环、判定等语句中代码全部要采取缩进风格，case语句下情况处理语句也要遵从语句缩进要求。 示例 无 代码块分隔 概述 相对独立短代码、变量定义需要分隔开，在读代码时能够方便区分出独立代码。 要求描述 在代码之间、变量定义以后使用一行空行来分隔代码，用于区分代码。 示例 if (!valid_ni(ni)) { ... /* program code*/ } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni; 长语句分隔 概述 通常情况下屏幕长度能够容纳超出80例字符，但为适应多个屏幕（如VI），且一行过长大多数人心理无法承受，所以长语句要分隔。大多数情况下提议单行代码长度不要超出80个字符，通常情况下能够使用多种方法缩减单行代码。 要求描述 较长语句（80字符）要分成多行书写，长表示式要在低优先级操作符处划分新行，操作符放在新行之首，划分出新行要进行合适缩进，使排版整齐，语句可读。 示例 单条语句: perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN + STAT_SIZE_PER_FRAM * sizeof( _UL ); act_task_table[frame_id * STAT_TASK_CHECK_NUMBER + index].occupied = stat_poi[index].occupied; act_task_table[taskno].duration_true_or_false = SYS_get_sccp_statistic_state( stat_item ); report_or_not_flag = ((taskno MAX_ACT_TASK_NUMBER) (n7stat_stat_item_va