软件编程规范和范例
软件编程规范

软件编程规范软件编程规范是一套旨在提高软件开发质量和可维护性的准则和规范。
它们定义了编程风格、命名约定、代码组织结构、注释规范等方面的规则,旨在提高代码的可读性、可理解性和可维护性。
下面是一些常见的软件编程规范:1. 命名约定变量、函数、类、文件等命名要具有描述性,使用有意义的名称,遵循驼峰命名法或下划线命名法。
避免使用单个字母或无意义的缩写。
2. 缩进和空格使用一致的缩进风格,通常是使用4个空格或者制表符。
在运算符两侧和逗号后添加空格,以提高可读性。
3. 注释规范在代码中添加清晰的注释,解释代码的逻辑和意图。
注释应该与代码一起更新,以保持同步。
注释长度应适中,不要过于冗长,但也不要过于简单。
4. 异常处理在必要的地方添加异常处理机制,以便在程序出错时能够恢复或处理异常情况。
避免使用捕捉所有异常的通配符异常处理语句,应该明确地捕获和处理特定类型的异常。
5. 函数和方法函数和方法应该尽可能地短小和单一责任原则。
函数和方法名应该具有描述性,不要使用虚词或无意义的名称。
6. 代码注重可重用性代码应该根据功能进行模块化和组织,以便可以被其他程序或模块重复使用。
避免使用全局变量和硬编码的常量,而是使用参数和配置文件来实现可配置性。
7. 类和对象类和对象应该具有清晰的结构和接口,并按照单一责任原则进行设计。
类和对象之间的关系应该清晰明确,避免过度耦合。
8. 设计模式应该根据实际需求选择合适的设计模式,以提高代码的可扩展性和可维护性。
常见的设计模式包括单例模式、工厂模式、观察者模式等。
9. 版本控制使用版本控制软件进行代码管理,定期提交代码,并为每个提交添加有意义的注释。
遵循版本控制的最佳实践,例如分支管理和代码审查。
10. 测试和调试编写测试代码来验证程序的正确性和健壮性。
使用调试工具来分析和解决程序的错误和异常情况。
以上只是一些常见的软件编程规范,具体的规范可能因编程语言、项目需求和团队约定而有所不同。
遵循软件编程规范可以提高代码质量和可维护性,减少程序错误和调试时间,有助于提高软件开发效率和团队协作效果。
软件编程操作规程

软件编程操作规程一、概述软件编程操作规程是指在软件开发过程中,对于编程操作的准则和要求的规范文档。
本规程旨在提高软件编程的效率、质量和一致性,确保软件项目的顺利进行和交付。
二、编程环境要求1. 操作系统:提供程序运行的基础环境,建议使用稳定可靠的操作系统,如Windows、Linux等。
2. 开发工具:选择适用的集成开发环境(IDE)或文本编辑器,如Eclipse、Visual Studio等,确保支持所选编程语言的开发工具。
3. 版本管理工具:使用版本管理工具进行代码版本控制和团队协作,如Git、SVN等。
三、命名规范1. 变量命名:采用有意义的命名,遵循驼峰命名法,尽量表达变量的用途和含义。
2. 函数命名:采用动词+名词的形式,准确描述函数的作用。
3. 类命名:采用名词或名词短语,首字母大写,对类的功能进行准确描述。
4. 常量命名:全大写,单词间用下划线连接,确保常量的可读性。
四、代码编写规范1. 缩进和空格:使用统一的缩进风格,推荐使用4个空格进行缩进,不使用Tab键。
2. 代码格式化:遵循统一的代码格式化风格,提高可读性。
可以使用自动化格式化工具,如Prettier、Eclipse等。
3. 注释规范:在关键代码处添加必要的注释,解释代码的用途、功能和实现细节。
4. 错误处理:程序中必须包含错误处理机制,对可能出现的异常、错误进行处理和记录。
5. 代码复用:避免写重复的代码,提取公共部分作为函数或模块进行复用。
6. 代码分块:合理划分代码块,提高代码的可维护性和可读性。
五、编程规范1. 变量声明:变量声明尽量靠近首次使用的位置,提高代码可读性。
2. 函数设计:函数尽量保持单一职责,遵循高内聚、低耦合的原则进行设计。
3. 错误处理:对可能发生的异常和错误进行处理,确保程序的健壮性。
4. 代码重构:对重复代码和冗余代码进行及时的重构,提高代码的可维护性和可读性。
5. 代码注释:关键代码处编写必要的注释,注明代码的功能、用途和实现细节。
程序代码规范范本

程序代码规范范本一、概述程序代码规范是一种约定俗成的编程规则,旨在提高代码的可读性、可维护性和可扩展性。
本范本将介绍常见的程序代码规范要求,帮助开发者编写出整洁、规范的程序代码。
二、命名规范1. 变量、函数和类的命名应清晰、简洁,并能准确描述其功能和用途。
2. 变量和函数名使用小写字母和下划线组合,如:variable_name, function_name。
3. 类名使用驼峰命名法,首字母大写,如:ClassName。
4. 常量名全部大写,使用下划线连接单词,如:CONSTANT_NAME。
三、缩进与空格1. 使用四个空格进行缩进,不使用Tab键。
2. 运算符两侧加空格,如:a + b。
3. 函数和类定义之间应有一个空格。
四、代码注释1. 使用单行注释或块注释对代码进行解释,使其易于理解。
2. 注释应简洁明了,描述代码意图和实现方式。
3. 在关键代码段落或复杂算法处添加注释,帮助他人理解和修改代码。
五、函数与类设计1. 函数应遵循单一职责原则,每个函数只负责一项具体任务。
2. 函数长度不宜过长,宜保持在20行以内,能够提高代码的可读性。
3. 类的设计应符合高内聚、低耦合原则,每个类只负责一个独立的功能模块。
4. 避免使用全局变量,尽量使用局部变量。
六、错误处理与异常1. 合理处理错误和异常,及时给出明确的错误提示信息。
2. 使用try-catch-finally语句块处理可能出现的异常情况。
3. 避免使用捕捉异常后什么也不做的空catch块。
七、代码格式化与排版1. 使用一致的代码缩进风格,保证代码的可读性。
2. 对代码进行适当的空行分隔,使其结构清晰可辨。
3. 对代码进行格式化,保证代码的一致性。
4. 尽量避免使用过长的代码行,超出屏幕范围时应进行换行。
八、代码复用与模块化1. 尽量避免出现重复的代码,可通过封装成函数或类实现复用。
2. 将功能相似的代码组织成模块,提高代码的可维护性。
3. 使用模块化开发,将程序拆分为多个独立的模块,便于并行开发和维护。
软件设计规范范文

软件设计规范范文一、命名规范命名是软件设计中最常见的操作之一,良好的命名规范可以增加代码的可读性和可理解性。
以下是一些常见的命名规范:1.类名:使用驼峰命名法,首字母大写。
2.方法名:使用驼峰命名法,首字母小写。
3.变量名:使用驼峰命名法,首字母小写。
4.常量名:使用大写字母和下划线命名法。
二、代码结构规范良好的代码结构可以使代码更易于阅读和理解,提高可维护性。
以下是一些常见的代码结构规范:1.类和方法要尽量保持单一职责,遵循“高内聚、低耦合”的原则。
2.代码块要适当缩进,类和方法之间要空行分隔。
3.代码要有适当的注释,解释功能、参数、返回值等。
三、错误处理规范良好的错误处理规范可以避免潜在的错误导致系统崩溃或数据丢失。
以下是一些常见的错误处理规范:1. 对于可能抛出异常的代码,要使用try-catch语句进行捕获处理。
2.在捕获异常时,要避免简单地打印错误信息,应该进行适当的处理或抛出更高层次的异常。
3. 对于不可恢复的错误,可以使用assert语句进行断言。
四、注释规范良好的注释规范可以提高代码的可读性和可理解性。
以下是一些常见的注释规范:1.每个文件要包含版权声明、作者、创建日期等基本信息。
2.类和方法要有适当的注释,解释功能、参数、返回值等。
3.在代码中适当地添加注释,解释关键算法或复杂逻辑的实现思路。
五、性能规范良好的性能规范可以提高系统的响应速度和吞吐量。
以下是一些常见的性能规范:1.尽量减少资源的占用,如内存和CPU。
2.避免频繁的IO操作,可以使用缓存或异步处理来提高效率。
3.对于复杂的计算或查询,要进行适当的优化,如使用索引或分片。
六、安全规范良好的安全规范可以保护系统和数据的安全性。
以下是一些常见的安全规范:1.对于用户输入的数据,要进行适当的验证和过滤,防止注入攻击。
2.使用安全的加密算法对敏感数据进行加密保存。
3.对系统的访问要进行权限控制,限制用户的访问权限。
总结:软件设计规范是确保软件系统质量的重要保证。
软件编程规范和范例

软件编程规范和范例2008-6-6目录1 排版 (3)2 注释 (8)规则2-7:避免在注释中使用缩写,特别是非常用缩写。
(10)3 标识符命名 (16)4 可读性 (19)5 变量、结构 (21)6 函数、过程 (28)建议6-14:避免使用无意义或含义不清的动词为函数命名。
(33)建议6-15:函数的返回值要清楚、明了,让使用者不容易忽视错误情况。
(33)7 可测性 (37)8 程序效率 (42)9 质量保证 (47)10 代码编辑、编译、审查 (54)11 代码测试、维护 (56)12 宏 (57)1 排版¹1-1:程序块要采用缩进风格编写,缩进的空格数为4个。
说明:对于由开发工具自动生成的代码可以有不一致。
¹1-2:相对独立的程序块之间、变量说明之后必须加空行。
示例:如下例子不符合规范。
if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;应如下书写if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;¹1-3:较长的语句(>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_valid (stat_item))&& (act_task_table[taskno].result_data != 0));¹1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。
华为软件编码规范

华为软件编程规范和范例〔一〕=====[排版] ]=======.〔二〕======[注释]=======.〔三〕=====[标识符命名]=======.〔四〕=====[可读性]======.〔五〕=====[变量、结构]=====.〔六〕=====[函数、过程]=====.〔七〕=====[可测性]=====.〔八〕=====[程序效率]=====.〔九〕=====[质量保证]=====.〔十〕=====[代码编辑、编译、审查]=====.〔十一〕=====[代码测试、维护]=====.〔十二〕=====[宏]=====.〔一〕========[ 排版]========== ¹1-1:程序块要采用缩进风格编写,缩进的空格数为4个说明:对于由开发工具自动生成的代码可以有不一致。
¹1-2:相对独立的程序块之间、变量说明之后必须加空行示例:如下例子不符合规范。
Int ni;if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;应如下书写Int ni;if (!valid_ni(ni)){... // program code}repssn_ind = ssn_data[index].repssn_index;repssn_ni = ssn_data[index].ni;¹1-3:较长的语句(>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_valid (stat_item))&& (act_task_table[taskno].result_data != 0));¹1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首示例:if ((taskno < max_act_task_number)&& (n7stat_stat_item_valid (stat_item))){... // program code}for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length)&& (j < NewKeyword.word_length); i++, j++){... // program code}for (i = 0, j = 0;(i < first_word_length) && (j < second_word_length);i++, j++){... // program code}¹1-5:若函数或过程中的参数较长,则要进行适当的划分示例:n7stat_str_compare((BYTE *) & stat_object,(BYTE *) & (act_task_table[taskno].stat_object),sizeof (_STAT_OBJECT));n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER+ index, stat_object );¹1-6:不允许把多个短语句写在一行中,即一行只写一条语句示例:如下例子不符合规范。
编程规范和范例
编程规范和范例编程规范是指约定了代码编写的标准和规则,旨在提高代码的可读性、可维护性、可扩展性和可重用性,同时也有助于团队成员之间的沟通和合作。
编程范例是指一种通用的编程模式,其思想和方法可以被广泛应用于不同的编程语言和场景中,有利于提高代码的质量和效率。
编程规范命名规范命名规范是最基本的编程规范之一,它可以提高代码的可读性和可维护性。
以下是一些常用的命名规范:•变量和函数名应该是有意义的、简明扼要的,可以用驼峰命名法(例如:myVariableName)或下划线命名法(例如:my_variable_name)。
•常量名应该全大写,可以用下划线连接(例如:MY_CONSTANT_NAME)。
•类名应该是名词,每个单词的首字母应该大写,可以用驼峰命名法或帕斯卡命名法(例如:MyClassName)。
代码风格规范代码风格规范是指一致的代码风格和格式,它可以提高代码的可读性和可维护性。
以下是一些常用的代码风格规范:•使用缩进来表示代码块,每个缩进位通常为4个空格。
•使用空格来分隔运算符和关键字,例如:x = y + z。
•使用空行来分隔代码块和函数,可以提高可读性。
注释规范注释规范是指明确和有用的注释,它可以提供额外的信息,有助于理解代码的含义。
以下是一些常用的注释规范:•在函数定义前写上函数说明,包括参数、返回值和函数作用等。
•在代码中添加必要的注释,解释函数或变量的意义和用法。
•使用注释来标记复杂的代码块,例如:// BEGIN 和 // END。
编程范例面向对象编程面向对象编程是一种对现实世界的建模方法,它将数据和行为封装为对象,对象间通过消息传递进行交互。
以下是面向对象编程的一些范例:•定义一个Person类,该类具有姓名、年龄和性别等属性,以及吃、睡、走等行为。
•定义一个Shape类,该类具有形状、大小、位置等属性,以及计算面积、周长等行为。
函数式编程函数式编程是一种将计算视为数学公式的编程方法,其核心思想是将程序分解为一系列独立的函数,每个函数都接受输入并产生输出。
华为编程规范全PDF
// 修改历史记录列表,每条修改记录应包括修改日期、修改
// 者及修改内容简述
1. Date:
Author:
Modification:
2. ... *************************************************/
¹2-3:源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块目的/功能、 主要函数及其功能、修改日志等。 示例:下面这段源文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包 含在内。
由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中没有必要再留空格, 如果语句已足够清晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不 必加空格,因为在 C/C++语言中括号已经是最清晰的标志了。 在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给操 作符留空格时不要连续留两个以上空格。 示例: (1) 逗号、分号只在后面加空格。 int a, b, c;
Version:
// 版本信息
Function List: // 主要函数及其功能
1. -------
History:
// 历史修改记录
<author> <time> <version > <desc>
David 96/10/12 1.0 build this moudle
***********************************************************/
for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length) && (j < NewKeyword.word_length); i++, j++)
编程规范实施方案范文
编程规范实施方案范文在软件开发过程中,编程规范是非常重要的一环。
它可以提高代码的可读性、可维护性,并且有助于团队合作。
因此,制定一套适合团队的编程规范实施方案显得至关重要。
本文将介绍一份编程规范实施方案范文,帮助团队建立起统一的编程规范,提高代码质量和开发效率。
一、命名规范。
在编程规范中,命名规范是非常重要的一部分。
良好的命名规范可以提高代码的可读性,降低理解和维护成本。
在命名变量、函数、类等标识符时,应该遵循一定的规范,比如使用驼峰命名法、统一的前缀等。
二、缩进与空格。
在编程中,良好的缩进和空格规范可以使代码更加清晰易读。
团队应该统一缩进的方式和空格的使用,比如是使用制表符还是空格来缩进,每级缩进几个空格等。
三、注释规范。
良好的注释可以使代码更加易读和易维护。
在编程规范中,应该规定注释的格式、位置和内容,以及注释的使用场景和注意事项。
四、代码风格。
统一的代码风格可以使团队成员之间的代码更加一致,减少不必要的沟通成本。
编程规范中应该包括代码的格式、结构、命名、注释等方面的规范要求,以及代码风格检查工具的使用。
五、异常处理规范。
异常处理是每个程序都需要考虑的问题。
在编程规范中,应该规定异常处理的方式、位置和注意事项,以及如何编写可靠的异常处理代码。
六、代码提交规范。
代码提交是团队协作中非常重要的一环。
在编程规范中,应该规定代码提交的格式、内容、频率和流程,以及代码提交的注意事项和规范要求。
七、测试规范。
良好的测试规范可以保证代码的质量和稳定性。
在编程规范中,应该规定测试的方式、范围和要求,以及测试用例的编写和执行规范。
八、版本控制规范。
版本控制是团队协作中必不可少的一部分。
在编程规范中,应该规定版本控制的流程、规范、标准,以及版本控制工具的使用和注意事项。
九、持续集成规范。
持续集成可以帮助团队更好地管理和交付代码。
在编程规范中,应该规定持续集成的流程、工具、规范和要求,以及持续集成的注意事项和最佳实践。
软件编程规范总结
软件编程规范总结软件编程规范是编写高质量、易于维护和可读性强的代码的基础。
规范化的编程风格有助于提高代码质量,减少软件缺陷,并降低开发团队协作成本。
在本文中,将总结一些常用的软件编程规范,包括命名规范、代码布局、注释规范、错误处理和异常处理规范等。
命名规范是编程中最基础和重要的规范之一。
良好的命名能够让代码更加易读、易于理解和维护。
在命名变量、函数和类名时,应使用具有描述性的名称,避免使用缩写、拼音和无意义的名称。
变量和函数名应该使用小写字母和下划线分隔,如:user_name。
类名应使用驼峰命名法,如:UserInfo。
代码布局是另一个重要的规范。
代码应该根据逻辑结构进行缩进,保持统一的缩进风格,一般使用4个空格进行缩进。
每条语句应占用一行,避免在一行中写多个语句。
在代码中添加适当的空行可以增加代码的可读性,也可以用来分隔不同功能的代码块。
注释规范是编程中必不可少的一部分。
注释应该简洁明了,清楚地解释代码的功能和用途。
注释应该与代码保持同步更新,避免无用的、过时的注释。
在需要特别解释的地方可以使用长注释,但应注意不要过度依赖注释,代码本身应该尽量自解释。
错误处理和异常处理规范是避免程序崩溃和保证程序可靠性的重要手段。
程序中应对可能发生的错误和异常进行处理,避免未处理的异常导致程序崩溃。
在捕获异常时,应对异常进行适当的处理,可以记录日志、回滚事务或提醒用户等。
除了上述规范之外,还有一些其他的编程规范也非常重要。
例如,避免使用全局变量,减少代码的耦合性;避免使用魔法数字,使用常量来代替;使用合适的数据结构和算法,提高程序的效率等。
在编写代码之前可以参考一些编码规范,如Google编码规范、Java编码规范等,遵循这些规范可以帮助开发人员写出更高质量的代码。
总之,软件编程规范是编写高质量代码的基础。
规范化的编程风格不仅有助于提高代码的可读性和可维护性,还能减少软件缺陷的产生,提高软件的质量。
开发人员应该在编写代码前遵循相应的规范,提高代码的一致性和可靠性。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
示例:如下例子不符合规范。 for (...) { ... // program code } if (...) { ... // program code } void example_fun( void ) { ... // program code }
示例:下面这段头文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含 在内。 /************************************************* Copyright (C), 1988-1999, Huawei Tech. Co., Ltd. File name: // 文件名 Author: Version: Date: // 作者、版本及完成日期 Description: // 用于详细说明此程序文件完成的主要功能,与其他模块 // 或函数的接口,输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表,每条记录应包括函数名及功能简要说明 1. .... History: // 修改历史记录列表,每条修改记录应包括修改日期、修改 // 作者及修改内容简述 1. Date: Author: Modification: 2. ... *************************************************/
通唐软件技术(湖南)有限公司
⒈ 排版
1-4:循环、判断等语句中若有较长的表达式或语句,则要进行适应的划 分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首
示例: if ((taskno < max_act_task_number) && (n7stat_stat_item_valid (stat_item))) { ... // program code } for (i = 0, j = 0; (i < BufferKeyword[word_index].word_length) && (j < NewKeyword.word_length); i++, j++) { ... // program code } for (i = 0, j = 0; (i < first_word_length) && (j < second_word_length); i++, j++) { ... // program code }
通唐软件技术(湖南)有限公司
⒈ 排版
1-5:若函数或过程中的参数较长,则要进行适当的划分
示例: n7stat_str_compare((BYTE *) & stat_object, (BYTE *) & (act_task_table[taskno].stat_object), sizeof (_STAT_OBJECT)); n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object );
通唐软件技术(湖南)有限公司
⒈ 排版
应如下书写。 for (...) { ... // program code } if (...) { ... // program code } void example_fun( void ) { ... // program code }
通唐软件技术(湖南)有限公司
⒈ 排版
示例: (1) 逗号、分号只在后面加空格。 int a, b, c; (2)比较操作符, 赋值操作符"="、 "+=",算术操作符"+"、"%",逻辑操作符"&&"、 "&",位域操作符"<<"、"^"等双目操作符的前后加空格。 if (current_time >= MAX_TIME_VALUE) a = b + c; a *= 2; a = b ^ 2; (3)"!"、"~"、"++"、"--"、"&"(地址运算符)等单目操作符前后不加空格。 *p = 'a'; // 内容操作"*"与内容之间 flag = !isEmpty; // 非操作"!"与内容之间 p = &mem; // 地址操作"&" 与内容之间 i++; // "++","--"与内容之间 (4)"->"、"."前后不加空格。 p->id = pid; // "->"指针前后不加空格 (5) if、for、while、switch等与后面的括号间应加空格,使if等关键字更为突出、 明显。 if (a >= b && c > d) ½ 1-1:一行程序以小于80字符为宜,不要写得过长。
⒈ 排版
1-9:函数或过程的开始、结构的定义及循环、判断等语句中的代
码都要采用缩进风格,case语句下的情况处理语句也要遵从语句 缩进要求
通唐软件技术(湖南)有限公司
⒈ 排版
1-10:程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占
一行并且位于同一列,同时与引用它们的语句左对齐。在函数体 的开始、类的定义、结构的定义、枚举的定义以及if、for、do、 while、switch、case语句中的程序都要采用如上的缩进方式
通唐软件技术(湖南)有限公司
⒈ 排版
1-3:较长的语句(>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_valid (stat_item)) && (act_task_table[taskno].result_data != 0));
Hale Waihona Puke 通唐软件技术(湖南)有限公司
⒈ 排版
1-11:在两个以上的关键字、变量、常量进行对等操作时,它们
之间的操作符之前、之后或者前后要加空格;进行非对等操作时, 如果是关系密切的立即操作符(如->),后不应加空格。
说明:采用这种松散方式编写代码的目的是使代码更加清晰 由于留空格所产生的清晰性是相对的,所以,在已经非常清晰的语句中 没有必要再留空格,如果语句已足够清晰则括号内侧(即左括号后面和右 括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括 号已经是最清晰的标志了。 在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在 局部不加空格。给操作符留空格时不要连续留两个以上空格。
⒈ 排版
1-7:if、for、do、while、case、switch、default等语句自占一行,
且if、for、do、while等语句的执行语句部分无论多少都要加括号 {}
示例:如下例子不符合规范。 if (pUserCR == NULL) return; 应如下书写: if (pUserCR == NULL) { return; }
⒈ 排版
1-1:程序块要采用缩进风格编写,缩进的空格数为4个
说明:对于由开发工具自动生成的代码可以有不一致。
通唐软件技术(湖南)有限公司
⒈ 排版
1-2:相对独立的程序块之间、变量说明之后必须加空行
示例:如下例子不符合规范。 Int ni; if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni; 应如下书写 Int ni; if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index; repssn_ni = ssn_data[index].ni;
通唐软件技术(湖南)有限公司
⒈ 排版
1-6:不允许把多个短语句写在一行中,即一行只写一条语句