C语言代码规范
- 格式：ppt
- 大小：2.09 MB
- 文档页数：27
下载文档原格式
合集下载
C语言代码规范
C语言代码规范C语言是一种广泛应用于编程领域的高级编程语言，具有跨平台、效率高、灵活性强等优点。
编写规范合乎标准的C语言代码有助于提高代码的可读性、可维护性和可移植性。
本文将介绍一些常用的C语言代码规范，以帮助开发者编写高质量的C语言程序。
一、代码格式1. 缩进：使用四个空格进行缩进，不要使用制表符。
这样可以保证在不同编辑器或显示器上显示的代码缩进一致。
2. 行长度限制：每行代码应尽量保持在80个字符以内，超过限制的代码可以进行适当换行。
换行时要注意保持代码的清晰可读性，一般可以采用缩进来表达代码的层次关系。
3. 大括号：大括号的位置应该和相关语句对齐，且起始的大括号应该放在语句所在行的末尾，而不是单独另起一行。
4. 空格和空行：在适当的情况下使用空格和空行可以提高代码的可读性。
例如，在运算符和操作数之间使用空格，不同的代码块之间使用空行进行分割等。
二、命名规范1. 变量名：使用有意义的变量名，尽量避免使用单个字符或简单的缩写表示变量。
变量名应该忠实地反映其所代表的含义。
2. 函数名：函数名应使用动词和名词的组合，具体描述函数的功能。
函数名应该清晰地表达其所完成的操作或所返回的结果。
3. 常量名：常量名使用全大写字母，并使用下划线进行分隔。
例如，MAX_LENGTH。
4. 类型名：类型名使用首字母大写的驼峰命名法，例如，StudentInfo。
5. 宏定义名：宏定义名使用全大写字母，并使用下划线进行分隔。
例如，PI。
三、注释规范1. 单行注释：使用"//"进行单行注释，注释符号后面应该留一个空格。
注释应该清晰明了，解释代码的用途或特殊处理等。
2. 多行注释：使用"/*"和"*/"进行多行注释。
多行注释通常用于解释一整块代码的功能或原理等。
3. 函数注释：在每个函数定义的上方加上函数注释，注释中应该包含函数的功能描述、输入参数的说明、返回值的含义以及可能抛出的异常等信息。
c语言代码规范
c语言代码规范C语言是一种通用的编程语言，广泛应用于嵌入式系统、操作系统、驱动程序以及各种应用程序的开发中。
为了提高代码的可读性、可维护性和可移植性，制定一套严格的代码规范是非常必要的。
1. 缩进与空格：- 使用4个空格进行缩进，不要使用Tab键。
- 在运算符两侧以及逗号后加上一个空格。
2. 命名规范：- 变量、函数和类型的命名采用小驼峰命名法，例如myVariable。
- 全局变量以g_开头，静态变量以s_开头。
- 宏定义全部大写，并用下划线分隔单词。
3. 函数定义：- 函数名应该能够描述函数的功能。
- 函数名应该以动词开头，使用小驼峰命名法。
- 函数的参数列表应该明确指明参数的类型和名称。
4. 注释：- 在每个函数之前添加简要的注释，说明函数的功能、参数和返回值。
- 在复杂的代码块中添加必要的注释，解释代码的逻辑和目的。
5. 头文件：- 头文件应该包含必要的宏定义、类型定义和函数声明，不要包含具体的函数实现。
- 头文件应该有相应的宏定义来防止多次包含。
6. 文件结构：- 文件应该按照功能模块进行组织，每个功能模块放在一个独立的文件中。
- 文件中的代码应该按照逻辑顺序进行排列，函数之间使用空行进行分隔。
7. 魔法数值：- 不要直接在代码中出现魔法数值，应该使用常量或者宏来表示。
- 大多数情况下，常量应该在文件的头部定义，并加上相应的注释。
8. 错误处理：- 对于可能出现错误的函数调用，应该检查返回值并进行相应的错误处理。
- 错误处理可以是返回特定的错误码或者抛出异常，但应该保持一致。
9. 括号和空行：- 括号应该与控制语句在同一行，并在括号内留出空格。
- 在函数和控制语句之间应该使用适当的空行进行分隔，提高可读性。
10. 可移植性：- 不要使用与平台相关的特性或者语法。
- 使用标准的数据类型和函数接口，避免使用非标准扩展。
- 避免使用与编译器相关的优化选项。
以上是一些常用的C语言代码规范，可以根据具体的项目需求进行适当调整。
c语言编程的书写规则
c语言编程的书写规则C语言编程的书写规则主要遵循以下规范：1. 缩进和空格：缩进和空格的使用可以使代码更易读。
通常，运算符两侧、逗号之后、控制语句（如if、for、while等）前后应添加空格。
在函数和括号的开头和结尾，通常应有空行。
2. 命名规则：变量和函数名应简洁且有意义。
通常，变量名和函数名以小写字母开头，后续单词的首字母大写，如 `myVariable`。
3. 注释：注释应简洁明了，解释代码的作用或目的，而不是解释代码是如何工作的。
注释应放在代码的上方或旁边，与代码保持一定距离。
4. 函数：函数应该尽可能短小，只做一件事情。
函数应具有描述性的名称，参数列表应清晰，并应包含返回类型。
5. 大括号：在C语言中，大括号 `{}` 用于定义代码块。
每一个独立的语句块都应该使用大括号。
6. 控制结构：控制结构（如if-else、for、while等）应该清晰明了，控制语句应只包含必要的逻辑。
7. 类型定义：类型定义应清晰明了，如果有必要，可以使用typedef来定义新的类型名称。
8. 预处理器指令：预处理器指令（如include、define等）应放在源文件的顶部。
9. 避免魔法数字和字符串：魔法数字和字符串（硬编码的值）会使代码难以理解和维护。
如果需要在代码中使用特定的值，应将其定义为常量或宏。
10. 避免全局变量：全局变量会使代码难以理解和维护，并可能导致意外的副作用。
尽可能使用局部变量。
11. 错误处理：在可能失败的操作后，应检查错误并相应地处理它们。
以上只是一些基本的C语言编程规则，实际编写代码时可能还需要考虑更多因素，如代码的可读性、可维护性、性能等。
C语言编程规范与代码Review
C语言编程规范与代码Review C语言是一门广泛使用的编程语言，为了保证程序的可读性、可维护性和可移植性，编程人员需要遵守一定的编程规范。
本文将介绍一些常见的C语言编程规范，并讨论代码Review的重要性和方法。
一、命名规范在C语言编程中，合适的命名规范能够使程序更易读懂。
以下是一些常见的命名规范建议：1. 变量命名应具有描述性，能够清晰表达其用途；2. 使用有意义的函数名，能够准确表达函数的功能；3. 使用驼峰命名法或下划线命名法，保持命名的一致性；4. 避免使用单字符作为变量名或函数名，除非其在特定情况下具有明确含义。
二、缩进与对齐缩进和对齐是保持代码结构清晰的重要手段。
在C语言编程中，以下规则需要注意：1. 使用适当的缩进来区分不同层次的代码块；2. 使用合适的空格或制表符对齐代码，使其更易读；3. 在函数定义和条件语句等代码块中，使用花括号将其包裹起来，保持结构的清晰性。
三、注释规范良好的注释能够提供代码的解释和说明，使他人更容易理解你的代码。
以下是一些注释规范的建议：1. 在关键代码处添加注释，解释其功能和作用；2. 注释应具有简洁明了的语言，避免使用复杂的技术术语；3. 避免无意义的注释，注释应与代码相辅相成；4. 在函数和文件的开头，提供一份概览性的注释，说明其用途和使用方法。
四、错误处理良好的错误处理能够提高程序的稳定性和可靠性。
以下是一些错误处理的原则：1. 检查输入参数的合法性，防止潜在的错误发生；2. 避免使用魔术数值，使用宏定义或常量来表示特定的含义；3. 使用合适的异常处理机制，如返回错误码或抛出异常。
五、代码Review的重要性代码Review是一种通过检查、审查和评估代码来提高代码质量的过程。
代码Review的重要性体现在以下几个方面：1. 代码Review有助于发现和纠正潜在的代码错误和缺陷；2. 代码Review可以促进编程规范的遵守和统一性的维护；3. 通过代码Review，团队成员之间可以相互学习和交流，提高编程能力。
c 编程规范
c 编程规范C 编程规范是用来规范 C 语言程序代码风格和编写规范的一系列准则。
遵循 C 编程规范可以提高代码的可读性、可维护性，减少错误和 bug 的发生。
以下是一些常见的 C 编程规范建议：1. 代码缩进：缩进应该使用相同数量的空格符或制表符，一般为 4 个空格或一个制表符。
缩进可以使代码结构更清晰，便于阅读。
2. 命名规范：变量、函数和常量的命名应该具有描述性，能够准确反映其用途和含义。
使用驼峰命名法或下划线命名法是常见的命名风格。
注意避免使用与 C 语言关键字相同的名称。
3. 注释规范：代码中应该包含必要的注释，用于解释代码的逻辑、实现细节和算法。
注释应该清晰明了，不要出现拼写错误或过多的冗余信息。
4. 函数长度：函数的长度应该适中，不要过长。
一般来说，一个函数应该只负责一个具体的功能，如果函数过长应该考虑分割成多个子函数。
5. 模块化设计：程序应该使用模块化的设计原则，将功能相似或相关的代码块组织成不同的模块或文件。
这样可以提高代码的可维护性和可重用性。
6. 错误处理：程序应该正确处理各种可能发生的错误和异常情况。
避免简单地使用错误代码或忽略错误，而是采取适当的错误处理措施，例如返回错误码或抛出异常。
7. 变量声明：变量应该在使用前先声明，并且尽量在被使用的代码块的起始处进行声明。
声明时应给予适当的初始值，以避免使用未初始化的变量。
8. 代码复用：避免重复的代码和冗余的逻辑。
可以通过编写可重用的函数、使用循环和条件语句等方式来提高代码的复用性和可读性。
9. 括号的使用：括号的使用是保证代码逻辑准确性的重要方式之一。
建议在 if、for、while、switch 等语句块的使用中，使用括号来明确代码块的范围，以避免出现逻辑错误。
10. 代码格式：代码应该有一致的格式，用以增加可读性。
应避免使用过长的代码行，一般建议每行代码长度不超过 80 个字符。
综上所述，C 编程规范是编写高质量、可维护代码的基本准则。
C语言编程规范
C语言编程规范1. 基本要求1.1 程序结构清析，简单易懂，单个函数的程序行数不得超过100行。
1.2 打算干什么，要简单，直接了当，代码精简，避免垃圾程序。
1.3 尽量使用标准库函数和公共函数。
1.4 不要随意定义全局变量，尽量使用局部变量。
1.5 使用括号以避免二义性。
2.可读性要求2.1 可读性第一，效率第二。
2.2 保持注释与代码完全一致。
2.3 每个源程序文件，都有文件头说明，说明规格见规范。
2.4 每个函数，都有函数头说明，说明规格见规范。
2.5 主要变量（结构、联合、类或对象）定义或引用时，注释能反映其含义。
2.7 常量定义（DEFINE）有相应说明。
2.8 处理过程的每个阶段都有相关注释说明。
2.9 在典型算法前都有注释。
2.10 利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位，定义Tab为6个字节。
2.11 循环、分支层次不要超过五层。
2.12 注释可以与语句在同一行，也可以在上行。
2.13 空行和空白字符也是一种特殊注释。
2.14 一目了然的语句不加注释。
2.15 注释的作用范围可以为：定义、引用、条件分支以及一段代码。
2.16 注释行数（不包括程序头和函数头说明部份）应占总行数的1/5 到1/3 。
3. 结构化要求3.1 禁止出现两条等价的支路。
3.2 禁止GOTO语句。
3.3 用IF 语句来强调只执行两组语句中的一组。
禁止ELSE GOTO 和ELSE RETURN。
3.4 用CASE 实现多路分支。
3.5 避免从循环引出多个出口。
3.6 函数只有一个出口。
3.7 不使用条件赋值语句。
3.8 避免不必要的分支。
3.9 不要轻易用条件分支去替换逻辑表达式。
4. 正确性与容错性要求4.1 程序首先是正确，其次是优美4.2 无法证明你的程序没有错误，因此在编写完一段程序后，应先回头检查。
4.3 改一个错误时可能产生新的错误，因此在修改前首先考虑对其它程序的影响。
4.4 所有变量在调用前必须被初始化。
C语言编程规范与风格
C语言编程规范与风格C语言是一种广泛使用的编程语言，它的编程规范与风格对于保证代码的可读性、可维护性和可扩展性至关重要。
本文将介绍一些关键的C语言编程规范与风格，并提供一些实践建议。
1. 代码缩进代码缩进是C语言中非常重要的一个方面，它可以使代码结构清晰，易于阅读。
推荐使用4个空格或者制表符来进行代码缩进。
2. 命名规范为了让代码更易读和理解，命名规范应具有一定的规则性和描述性。
变量、函数和常量的命名应具有一定的规范，比如使用驼峰命名法（camelCase）或者下划线法（underscore_case）。
3. 注释注释是代码中的重要组成部分，可以使代码更易读和理解。
应该在代码中适当地使用注释，解释代码的功能、用途和注意事项。
注释应该清晰、简洁且易于理解。
4. 函数设计函数是C语言中重要的组织单元，应该遵循一定的设计原则来编写函数。
函数应该具有良好的命名，功能单一且高内聚。
函数的参数应该明确且合理，避免过多的参数传递。
函数的返回值应该清晰地说明其含义。
5. 条件语句和循环语句条件语句和循环语句是C语言中常用的流程控制语句，应该遵循一定的格式和风格。
条件语句的括号应该与关键字紧挨着，条件表达式应该适当地加上括号，以增加代码的可读性。
循环语句的条件表达式应该明确且易于理解，循环体应该具有合适的缩进。
6. 数据类型和变量声明在C语言中，数据类型和变量声明是非常重要的。
应该根据需要选择合适的数据类型，尽量避免使用过长或过短的数据类型。
变量声明应该在函数开头或者合适的位置进行，尽量避免使用全局变量。
7. 引入头文件C语言中的头文件对代码的模块化和可维护性非常重要。
在代码中应该适当引入所需要的头文件，避免使用过多的全局引入。
头文件应该具有合适的宏定义和条件编译，以提高代码的可复用性。
8. 错误处理在编程过程中，错误处理是非常重要的一部分。
应该养成检查错误和处理错误的习惯，合理运用条件语句和错误码，以便更好地调试和修复代码。
c语言编程规范
c语言编程规范C语言是一种广泛使用的编程语言，为了使代码可读性强，易于维护，编写出高质量的C语言代码，需要遵守一些编程规范。
1. 命名规范：- 使用有意义的变量和函数名称，避免使用缩写或不明确的名称。
- 变量和函数名称使用小驼峰式命名，以单词首字母小写，后续的单词首字母大写。
- 宏常量使用全部大写字母，并用下划线分隔单词。
2. 注释规范：- 使用注释来解释代码的逻辑、功能或者算法，提高代码的可读性。
- 在函数开头可以用注释来描述函数的输入、输出及功能。
- 注释应该与代码对齐，避免过长或过短，同时避免注释代码。
3. 缩进和空格规范：- 使用合适的缩进，增加代码的可读性。
- 使用4个空格作为一次缩进，而不是使用Tab字符。
- 在运算符和逗号后加一个空格，使代码更易读。
- 在大括号前加一个空格，与控制流语句对齐。
4. 代码结构规范：- 将相关功能的代码块放在一起，便于阅读和维护。
- 逻辑层次清晰，函数和类方法要尽量短小，每个函数的功能单一、复用性强。
- 相关联的变量放在一起声明，并按照类型顺序排序。
- 避免过长的行，推荐每行代码不超过80个字符。
5. 错误处理规范：- 在代码中检查错误并进行适当的处理，避免代码崩溃或者产生不可预料的结果。
- 使用错误码或者异常来处理错误，避免使用魔法数字。
- 使用合适的方式记录错误信息，方便调试和定位问题。
6. 动态内存管理规范：- 在使用动态内存分配时，需要及时释放分配的资源，避免内存泄漏。
- 需要注意避免指针悬挂和使用已经释放的内存。
7. 注重效率和安全性：- 在编写代码时注重代码的性能和效率，避免使用低效的算法。
- 在处理用户输入或者系统API调用时，需要对输入进行有效性检查，避免安全漏洞。
8. 一致性和规范性：- 保持代码的一致性和规范性，遵循编程规范，方便团队协作和代码维护。
- 遵循公司或项目的编码规范，保持团队的代码风格一致。
以上是C语言编程规范的一些基本要点，通过遵守这些规范，可以提高代码的可读性、可维护性和代码质量，使得代码更加规范和高效。
c语言编码规范
c语言编码规范1. 定义要求（1）C语言编码规范是指以C语言为基础的各大编程规范，它包含了C语言编写编程风格，命名规范，编程结构规范，编程语句规范等，让C语言编程更加规范、整洁。
2. 风格规范（1）关键字需大写书写，函数名、变量名等由于字母的组合，需要全部小写，每个单词首字母大写；（2）变量名不同部分用下划线相隔，如count_day；（3）变量名、宏定义尽量以字母为主，如类似变量temp1，应以temp_num或tmp_num标出；（4）如果是boolean变量，用is_，has_，can_，should_等来开头；（5）结构体变量名以st_开头，指针变量以p_开头；（6）变量命名规避使用数字或关键字作为变量名，变量有一定的含义。
3.命名规则（1）变量名称需要清晰容易识别，最大限度的体现变量定义的含义；（2）动词开头的函数名，如GetValue()；（3）禁止使用拼音代替英文原语的单词，如使用Genarate代替Generate；（4）宏定义加上宏定义的作用，方便查阅，如#define MAX_NUM 10;4.编码规范（1）大括号{}要和函数声明、if语句、循环等放在同一行，同一行必须以分号结束；（2）避免使用复杂的表达式，尽量简化表达式，提高程序执行效率；（3）函数的入口参数必须在一行完成，不允许一行就只声明一个参数；（4）使用空行表示程序模块，增加程序可读性；（5）赋值操作、声明操作分开，以便于断点调试及阅读。
5.注释规范（1）注释需要给出功能说明、操作提示等，不只是单纯的注释源码，使代码更易理解；（2）代码块开头加一个注释表明代码块作用，方便阅读；（3）函数声明后增加功能注释，注释必须完整，包括函数的功能简介，参数说明，返回值等；（4）注释中禁止出现脏话、宗教意象、广告语等。
C语言代码规范(编程规范)
什么叫规范？在C语言中不遵守编译器的规定，编译器在编译时就会报错，这个规定叫作规则。
但是有一种规定，它是一种人为的、约定成俗的，即使不按照那种规定也不会出错，这种规定就叫作规范。
虽然我们不按照规范也不会出错，但是那样代码写得就会很乱。
大家刚开始学习C语言的时候，第一步不是说要把程序写正确，而是要写规范。
因为如果你养成一种非常不好的写代码的习惯，代码就会写得乱七八糟，等到将来工作面试的时候，这样的习惯可能会让你失去机会。
那么代码如何写才能写得很规范呢？代码的规范化不是说看完本节内容后就能实现的。
它里面细节很多，而且需要不停地写代码练习，不停地领悟，慢慢地才能掌握的一种编程习惯。
所以大家不要想着一下子就能把代码规范化的所有知识全部掌握，也不要想着一下子就能把代码写规范，这是不太可能的。
有很多知识，比如为什么代码要这样写，为什么不能那样写，作为一个初学者你是很难弄明白的。
有很多规范是为了在程序代码量很大的时候，便于自己阅读，也便于别人阅读。
所以刚开始的时候有很多规范你不知道为什么要那样规定，你就单纯地模仿就行了。
等将来敲代码敲得时间长了，你就会感觉到那样写是很有好处的。
代码规范化的第一个好处就是看着很整齐、很舒服。
假如你现在用不规范的方式写了一万行代码，现在能看得懂，但等过了三个月你再回头看时就很吃力了，更不要说给别人看了。
所以代码要写规范，比如加注释就是代码规范化的一个思想。
在一般情况下，根据软件工程的思想，我们的注释要占整个文档的20%以上。
所以注释要写得很详细，而且格式要写得很规范。
第二个好处是，把代码写规范则程序不容易出错。
如果按照不规范的格式输入代码的话，很容易出错。
而代码写规范的话即使出错了查错也会很方便。
格式虽然不会影响程序的功能，但会影响可读性。
程序的格式追求清晰、美观，是程序风格的重要构成元素。
代码规范化基本上有七大原则，体现在空行、空格、成对书写、缩进、对齐、代码行、注释七方面的书写规范上。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
五、程序效率
5-1：通过对系统数据结构的划分与组织的改进，以及对程序算法的优化来提高空间效率。 示例：如下记录学生学习成绩的结构不合 理。 typedef unsigned char BYTE; typedef unsigned short WORD; typedef struct STUDENT_SCORE_STRU { BYTE name[8]; BYTE age; BYTE sex; BYTE class; BYTE subject; float score; } STUDENT_SCORE; 因为每位学生都有多科学习成绩，故如上结 构将占用较大空间。应如下改进（分为两个 结构）， 总的存贮空间将变小，操作也变得更方便。 typedef struct STUDENT_STRU { BYTE name[8]; BYTE age; BYTE sex; BYTE class; } STUDENT; typedef struct STUDENT_SCORE_STRU { WORD student_index; BYTE subject; float score; } STUDENT_SCORE;
一、排版
1-6：较长的语句（>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));
up / down get / release start / stop show / hide increment / decrement create / destroy
四、可读性
4-1：注意运算符的优先级，并用括号明确表达式的操作顺序，避免使用默认优先级。 说明：防止阅读程序时产生误解，防止因默认的优先级与设计思想不符而导致程序出错。 示例：下列语句中的表达式 word = (high << 8) | low -----------------(1) if ((a | b) && (a & c)) ------------------(2) if ((a | b) < (c & d)) -------------------(3) 如果书写为 high << 8 | low a | b && a & c a | b < c & d 由于 high << 8 | low = ( high << 8) | low, a | b && a & c = (a | b) && (a & c)， (1)(2)不会出错，但语句不易理解； a | b < c & d = a | （b < c） & d，(3)造成了判断条件出错。
4-4：不要使用难懂的技巧性很高的语句，除非很有必要时。 示例：如下表达式，考虑不周就可能 出问题，也较难理解。 * stat_poi ++ += 1; * ++ stat_poi += 1; 应分别改为如下。 *stat_poi += 1; stat_poi++; // 此二语句功能相当于“ * stat_poi ++ += 1; ” ++ stat_poi; *stat_poi += 1; // 此二语句功能相当于“ * ++ stat_poi += 1; ”
三、标识符命名
3-4：在同一软件产品内，应规划好接口部分标识符（变量、结构、函数及常量）的命名， 防止编译、链接时产生冲突。 3-5：用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。 说明：下面是一些在软件中常用的反义词组。 add / remove begin / end insert / delete first / last open / close put / get lock / unlock min / max old / new next / previous source / target send / receive source / destination cut / paste 示例： int min_sum; int max_sum; int add_user( BYTE *user_name ); int delete_user( BYTE *user_name );
二、注释
2-2：函数头部应进行注释，列出：函数的目的/功能、输入参数、输出参数、返回值、调 用关系（函数、表）等。 示例： /************************************************* Function: // 函数名称 Description: // 函数功能、性能等的描述 Calls: // 被本函数调用的函数清单 Called By: // 调用本函数的函数清单 Table Accessed: // 被访问的表（此项仅对于牵扯到数据库操作的程序） Table Updated: // 被修改的表（此项仅对于牵扯到数据库操作的程序） Input: // 输入参数说明，包括每个参数的作 // 用、取值说明及参数间关系。 Output: // 对输出参数的说明。 Return: // 函数返回值的说明 Others: // 其它说明 *************************************************/
二、注释
说明：注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不 能太少，注释语言必须准确、易懂、简洁。 2-1：文件头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、 功能、修改日志等。 示例： /*************************************************************************** Copyright: 1988-1999, Huawei Tech. Co., Ltd. File name: 文件名 Description: 用于详细说明此程序文件完成的主要功能，与其他模块或函数的接口，输出 值、取值范围、含义及参数间的控制、顺序、独立或依赖等关系 Author: 作者 Version: 版本 Date: 完成日期 History: 修改历史记录列表， 每条修改记录应包括修改日期、修改 者及修改内容简述。 *****************************************************************************/
Trunk[index].trunk_state = 1;
... // program code }
{
Trunk[index].trunk_state = TRUNK_PASS; ... // program code }
四、可读性
4-3：源程序中关系较为紧密的代码应尽可能相邻 示例：以下代码布局不太合理。 rect.length = 10; char_poi = str; rect.width = 5; 若按如下形式书写，可能更清晰一些。 rect.length = 10; rect.width = 5; // 矩形的长与宽关系较密切， 放在一起。 char_poi = str;
C语言编程规范
目录
1 排版 5 程序效率
2
注释
6
内存管理
宏定义 其它
7 3 标识符命名 8 4 程序可读性
一、排版
1-1：程序块要采用缩进风格编写，缩进的空格数一般为4 个。 1-2：相对独立的程序块之间，变量说明之后要加空行。
示例：如下例子不符合规范。 if (!valid_ni(ni)) { ... // program code } repssn_ind= ssn_data[index].repssn_index;
推荐写法 for (...) { ... // program code }
if (...) { ... // program code }
一、排版
1-4：不要把多个短语句写在一行中，即一行只写一条语句。 示例：如下例子不符合规范。 rect.length = 0; rect.width = 0; 应如下书写 rect.length = 0; rect.width = 0; 1-5：if、for、do、while、case、switch、default 等语句要各自占一行，且if、for、 do、while等语句的执行语句部分无论多少都要加括号{}。 示例：如下例子不符合规范。 if (pUserCR == NULL) return; 应如下书写： if (pUserCR == NULL) { return; }
四、可读性
4-2：避免使用不易理解的数字，用有意义的标识来替代。涉及物理状态或者含有物理意义 的常量，不应直接使用数字，必须用有意义的枚举或宏来代替。