1 / 18
文档名称:

C语言的编码标准.docx

格式:docx   大小:109KB   页数:18页
下载后只包含 1 个 DOCX 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

C语言的编码标准.docx

上传人:小雄 2022/2/22 文件大小:109 KB

下载得到文件列表

C语言的编码标准.docx

文档介绍

文档介绍:C语言编码标准
.关于命名标准
1对命名的一般方针
1) 进行命名的时候
在充分把握对象数据(变量、函数、etc)的内容的基础上,再进行能明确显示其内容 的名命名。
2) 要实行不需要注释的命名
3) 命名满足不了上述1、2条件尾整理定义。
5) 在多个源文件的调出的共同函数,按照功能整理,制作只定义共同函数的共同函数文件 函数。但是,共同函数有很多,一个源文件归纳不了时,按照功能分为几个源文件。
3 对源文件的注释框
源文件注释框按照以下的例子,记叙所有的项目。适当的记叙项目没有时,记述为“无”。
注释英语、日语都可以。
. 对各种说明、定义的标准
1制作包含文件的规定
1) 包含文件名全部用小写字母命名。
2) 包含文件由以下项目构成,除以下项目外不写其它项目。但没必要写以下全部项目。
・包含文件用注解框(必须写)
宏定义(没有时可省略)
型说明(没有时可省略) JA A_&
・构造体说明(没有时可省略)
函数保留说明(没有时可省略)
.extern说明(没有时可省略)
3) 在注解框上写在读取该包含文件前需要读取的包含文件。
4) 包含文件内的定义、说明可在多个源文件内使用。
5) 包含文件内各种数据的定义、说明格式按源文件的标准。
6) 包含文件内希望不包含其他文件。
2 在包含文件内进行定义的mask常数/状态常数的规定
1) 进行flag等bitdata的mask的常数(以后叫mask常数)和表示bit状态的常数(以后 叫状态常数)必须在包含文件内进行宏定义。
2) mask常数和状态常数对于用户定义的bit必须按组定义。而且,不管使不使用也一起定 义相反的mask常数和状态常数。但是对于从CD ROM读入的数据中的bit,只定义 mask常数即可。
3) 只有一个mask常数用直接值定义。和它有关联的各种常数用逻辑式进行定义(如用于 检测它的状态和相反状态的mask常数、根据该mask常数应测出的状态常数等)。
4) 和mask常数、状态常数一起定义mask运算对象的变量(以后叫静态变量)和bit宽。
5) mask常数的命名规则
在名字的最后加"_MASK”
取静太变量和逻辑语时测出上述状态以外所有状态的mask常数,在上述mask常数前 加 “NOT”(NOT_状态—MASK)
不能在mask常数名中加表示bit位置的数据( ~_2bit_MASK)o
为测出一个状态定义一个mask常数。不能把用一个mask常数测出多个状态作为目的。
对mask常数不能进行明确表示应测出的状态的命名时,有可能为测出多个状态而进行 mask常数定义。这时按各自目的分开讨论。
6) 状态常数的命名规则
定义根据和上边命名的一个mask常数的逻辑运算应测出的表示一个状态的状态常数不 能把多个状态用一个状态常数表示。
・对于一个状态常数定义一个表示取反状态的状态常数时,为了明确表示它们是互相取反 状态,在状态常数名前加“NOT”。
3包含文件内的屏蔽定数/状态定数定义的例子
(反例)在源文件中记录下的编码
4关于源文件中包含文件节的格式的规定
1) 在一个源文件中使用的包含文件全部以“包含文件节”包含。但是,函数的extern说明 被保存的包含文件要以全局函数的extern说明节包含。
2) 在“包含文件节”的标题要设有表示节开始的注释框。
3) 把包含文件节分割为以下的种类:
・C语言标准的头文件
・E1系统共同的头文件
・任务组共同的头文件
・模型共同的头文件
・任务共同的头文件
4) 定义归纳为各个种类进行,并在各个种类的段落上附加说明以及空格行。
5) 各个各类定义的顺序按以上的顺序。
6) 对E1系统共同的头文件以下付与显示其使用目的的注释。
7) “#include”全部用小写字母记述。
8) 展开的个组文件的标题要对刘到同一列上。
5 宏定义和预处理器命名格式的规定
1) 在多个源文件上使用的宏全部包含文件内定义。根据[处理标准]决定保存在哪一层。
2) 在一个源文件内使用或在一个函数内使用的宏癸源文件内的“宏定义section"上定义。
3) 在“宏定义sectionr的开头设一个明确setion开始的注解框。
4) 关联性强的宏归纳在一个地方定义。
5) 所有的预处理器命名从第一列开始写。但是在“#if”的嵌套内部的预处理器命令语句 缩进“一个空格”。在预处理器命令之间的,用通常的C语言写的code和按上下文件 的C语言写的code部分进行宿进。
6) 所有的预处理器命名用小写字母写。
7) 定义的宏名全都写在同一个栏上。
8) 被宏定义的原常数(字符串)和关联的常数排头放在同一列上。
9