1.缩进 2.空行的使用 3.折行的使用 4.注释的位置5.如何进行命名 6.程序标号(大括号) 7.文件的整体结构 8.其它
1.缩进
首先要说的是缩进,缩进可以使得我们的文章更加的有层次感。通常情况下,我们不再使用tab键来缩进。因为不同的电脑可能会tab键所占的宽度不相同,如果使用的话可能无法达到预期的效果。因此,我们一般都使用4个空格键来进行缩进,以防意外的发生。
2.空格
空行也很重要,恰当的使用空行可以让我们的程序更加有条理性。我们一般在不同的逻辑段落添加空行。1.我们在每个函数之间要加上空行 2.判断语句前后加空行 3.在进行对变量和函数的说明时加空行对两者区分
3.折行
还有关于折行的使用。在每一行中我们最好不要超过80列,并且使用逻辑结构时,各个条件之间要要使用折行,并且内容尽量的对齐。
4. 命名
在命名时,我们尽量要让函数、变量和数据类型的名字更接近于我们自己的语言,尽量做到可以让别人一眼看出其作用。
1.在使用指针变量、全局变量和结构体时,注意在指针变量前加“p_“,在全局变量前加“g_“,结构体变量加后缀“_t“。这样可以有效的进行区分。
2.如果在一个变量中有多个单词,建议每个单词之间加下划线。
3.最好不要在变量名中掺杂大写字母。因为常量通常用大写字母表示。
4.如果想要对使用的变量名进行简化,建议使用以下的规则: (1).较短的单词可通过去掉“元音”形成缩写
(2).较长的单词可取单词的头几个字母形成缩写
(3).尽量使用公认的缩写。
示例:
temp-- tmp
lag–flg
message–msg
尽管有着这么多的规定,但是有时我们仍然会感觉变量名字不够用。所以建议在使用函数时,对函数中形参定义时在每个变量前加“函数名_变量名“进行区分。
更加要谨慎对全局变量的使用,在进行命名时要时时注意重名的情况。
5.注释
在以下几种情况我们需要进行注释。
1.文件开头需要注释段落
2.函数开头需要注释段落
3.全局变量需要详细注释
4.特殊功能的局部变量需要详细注释
5.变量bit域详细注释
6.为特殊功能的宏定义加注释
在进行注释时我们也要做到以下几点注意:
1.尽量使用 // 作为程序内部注释
2. //* ‐‐ *// 用于文件、函数头部注释段落
3.在不同条件下可能被使用的代码不能注释,用#if 0 ‐‐ #endif
6.文章的整体结构
当我们真正编写项目时要有以下几点:
1.版权声明
2.文件用途说明
3.编写和修改记录
4.#include 头文件
5.局部函数申明(只将会被外部引用的全局函数名称放在头文件里,其余的在c文件头部申明)
6.全局变量申明(不能放在头文件里,头文件里面用extern申明供外部访问的全局变量)
7.单个c程序长度少于300行,单个函数不要超过100行
7.其它规定
其实以上这些要求并不代表程序不这样写就不能运行。只是遵守这些规定能让我们更好的与他人进行交流。
所以,我们也要更加的重视自己书写语句的正确性,这点的重要性也很强