C语言规范编程.pdf

第六节 ：C语言规范编程 一、c文件和头文件 1.c文件 1.每个 c 文件应该包含对应的头文件。 2.c 文件需要使用其他的 c 文件的函数应该包含对应的头文件，切忌头文件包含头文件 （除系统文件和配置文 件外）。 3.全局变量应该定义在 c 文件内部。 4.只在本 c 文件使用的函数，应该只在本 c 文件开头进行声明，不应该声明在头文件中。 2.头文件 1.所有头文件都应当使用 #define ，防止头文件被多重包含，如下格式：  #ifndef FILENAME_H__ #define FILENAME_H__   *******   #endif a.头文件的定义符号禁止用_和 __开头，是因为一般以_和”__开头的标识符为系统保留或者标准库使 用，在有些静态检查工具中，若全局可见的标识符以_开头会给出告警. b. 为了保证唯一性，更好的命名是 PROJ ECT NA ME_ PAT H_ FILENA ME_ H__ 2.每个 c 文件对应一个同名的头文件，用于声明对外开放的接口。 3.头文件中适合函数的声明，不应该放置函数的具体实现。 4.除了系统头文件和配置部头文件以外，禁止头文件循环包含。 5. .c .h禁止包含不用的头文件。 6.头文件中禁止定义变量，如果定义了，在被多个函数包含的时候就会报重复定义的错误。 7.只能通过包含头文件的方式使用其他 .c 提供的接口，禁止在 .c 中通过 extern 的方式使用外部 函数接口、 变量。 3.#include xxx.h 和 #include xxx.h 的区别 1. #include #include 引用的是编译器的类库路径里面的头文件。 假如你编译器定义的自带头文件引用在 C:\ Keil\c51\ INC\ 下面，则 #include 引用的就是 C:\ Keil\c51\ INC\stdio.h 这个头文件，不管你的项目在什么目录里， C:\ Keil\c51\ INC\stdio.h 这个路径就定下 来了，一般是引用自带的一些头文件，如： stdio.h、conio.h、string.h、stdlib.h 等等。 2. #include #include 引用的是你程序目录的相对路径中的头文件，找不到就回去系统路径下寻找。 假如你的项目目录是在 D:\ Proj ects\tmp\ ，则 #includemy.h 引用的就是 D:\ Proj ects\tmp\my.h 这个头文 件，一般是用来引用自己写的一些头文件。如果使用 #include ，它是会先在你项目的当前目录查找是否有 对应头文件，如果没有，它还是会在对应的引用目录里面查找对应的头文件。例如，使用 #include stdio.h 如果在你项目目录里面，没有 stdio.h 这个头文件，它还是会定位到 C:\ Keil\c51\ INC\stdio.h 这个头文件的。 二、标识符命名 1.除了常见的通用缩写以外，不使用单词缩写，禁止使用汉语拼音。 2.同一个代码应该保持命名风格一致。 3.尽量避免名字中出现数字编号，除非逻辑上的确需要编号。 4.命名风格： 4.1.驼峰式命名，如：lcdDisplayTime. 4.2.下划线形式命名，如：lcd_dis