C语言格式书写规范.docx

《C语言格式书写规范.docx》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、要：简要描述本文件的内容,.C语言书写规范指南第1章文件结构每个C程序通常分为两个文件。一个文件用于保存程序的声明（declaration），称为头文件。另一个文件用于保存程序的实现（implementation），称为定义（definition）文件。C程序的头文件以“.h”为后缀，C程序的定义文件以“.c”为后缀。1.1版权和版本的声明版权和版本的声明位于头文件和定义文件的开头（参见示例1-1），主要内容有：（1）版权信息。（2）文件名称，标识符，摘要。（3）当前版本号，作者/修改者，完成日期。（4）版本历史信息。/**Copyright(c)2001

2、,吉林大学物理学院无线电*Allrightsreserved.**文件名称：filename.h*文件标识：*摘**当前版本：1.1*作者：输入作者（或修改者）名字*完成日期：2007年7月20日**取代版本：1.0*原作者：输入原作者（或修改者）名字*完成日期：2007年5月10日*/示例1-1版权和版本的声明;..,.1.2头文件的结构文件由三部分内容成：（1）文件开的版和版本声明（参示例1-1）。（2）理。（3）函数和构声明等。假文件名称SCL_SPI.h，文件的构参示例1-2。【1-2-1】了防止文件被重复引用，当用#ifndef/#define/

3、#endif构生理。【1-2-2】用#include格式来引用准的文件（器将从准目开始搜索）。【1-2-3】用#include“filename.h”格式来引用非准的文件（器将从用的工作目开始搜索）。【1-2-4】#include后面使用TAB控制排版。【1-2-5】文件中只存放“声明”而不存放“定”【1-2-6】全局量在文件中声明,在.c文件中定.hexternintvalue;声明。.cintvalue=0x10;定。【1-2-7】局部量在.c中定(static)unsignedintvalue;定。//版和版本声明示例1-1，

4、此省略。#ifndefSCL_SPI_H//防止SCL_SPI.h被重复引用#defineSCL_SPI_H#include//引用准的文件⋯#include“SCL_CAN.h”//引用非准的文件⋯voidFunction1(⋯);//全局函数声明⋯externunsignintvalue;//全局量声明#endif示例1-2C头文件的结构;..,.1.3定义文件的结构定文件有三部分内容：（1）定文件开的版和版本声明（参示例1-1）。（2）一些文件的引用。（3）程序的体（包括数据和代）。假定文件的名称SCL_SPI.c，定文件的

5、构参示例1-3。//版和版本声明示例1-1，此省略。#include“SCL_SPI.h”//引用文件⋯//全局量定unsignintvalue=0x10;//全局函数的体voidFunction1(⋯){⋯}示例1-3C定义文件的结构1.4头文件的作用早期的程言如Basic、Fortran没有文件的概念，C言的初学者然会用使用文件，但常常不明其理。里文件的作用略作解：（1）通文件来用功能。在很多合，源代不便（或不准）向用公布，只要向用提供文件和二制的即可。用只需要按照文件中的接口声明来用功能，而不必关心接口怎么的。器会从中提取相的代。（2）文件能加型安全

6、。如果某个接口被或被使用，其方式与文件中的声明不一致，器就会指出，一的能大大减程序、改的担。;..,.1.5目录结构如果一个件的文件数目比多（如超十个），通常将文件和定文件分保存于不同的目，以便于。例如可将文件保存于include目，将定文件保存于source目（可以是多目）。如果某些文件是私有的，它不会被用的程序直接引用，没有必要公开其“声明”。了加信息藏，些私有的文件可以和定文件存放于同一个目。第2章程序的版式版式然不会影响程序的功能，但会影响可性。程序的版式追求清晰、美，是程序格的重要构成因素。可以把程序的版式比“法”。好的“法”可人程序一目

7、了然，看得致勃勃。差的程序“法”如螃蟹爬行，人看得索然无味，更令者有加。程序学程序的“法”，弥大学算机教育的漏洞，在很有必要。2.1空行空行起着分隔程序段落的作用。空行得体（不多也不少）将使程序的布局更加清晰。空行不会浪内存，然打印含有空行的程序是会多消耗一些，但是得。所以不要舍不得用空行。【2-1-1】在每个函数定束之后都要加空行。参示例2-1（a）【2-1-2】在一个函数体内，揖上密切相关的句之不加空行，其它地方加空行分隔。参示例2-1（b）//空行voidFunction1(⋯){⋯}//空行voidFunction2(⋯){⋯}示例2-1(a)函数

8、之间的空行;..,.//空行while(condition){st