C语言格式书写规范.docxVIP

精品文档 精品文档 PAGE PAGE28 精品文档 PAGE 要：简要描绘本文件的内容 精品文档 C语言书写规范指南 第1章文件结构 每个C程序往常分为两个文件。一个文件用于保存程序的声明（ declaration ），称为头 文件。另一个文件用于保存程序的实现（ implementation ），称为定义（ definition ）文 件。 C程序的头文件以“ .h”为后缀，C程序的定义文件以“ .c”为后缀。 1.1版权和版本的声明 版权和版本的声明位于头文件和定义文件的开头（参见示例 1-1），主要内容有： 1）版权信息。 2）文件名称，表记符，纲要。 3）目前版本号，作者/改正者，达成日期。 4）版本历史信息。 /* *Copyright(c)2001, 吉林大学物理学院无线电 *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/#endif构生理 。 【1-2-2 】用#include filename.h 格式来引用准的文件（器将从准目 开始搜索）。 【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，此省略。 #ifndef SCL_SPI_H // 防备SCL_SPI.h被重复引用 #define SCL_SPI_H #include p30f6014A.h // 引用准的文件 ? #include “SCL_CAN.”h //引用非准的文件 ? voidFunction1( ?);//全局函数声明 ? externunsignintvalue;// 全局量声明 #endif 示例1-2C头文件的结构 . 精品文档 1.3定义文件的结构 定文件有三部分内容： 1）定文件开的版和版本声明（参示例1-1）。 2）一些文件的引用。 3）程序的体（包括数据和代）。 假定文件的名称 SCL_SPI.c，定文件的构参示例 1-3。 版和版本声明示例1-1，此省略。 #include“SCL_SPI.h”//引用文件 ? 全局量定 unsignintvalue=0x10; 全局函数的体 void Function1(?) { ? } 示例1-3C定义文件的结构 1.4头文件的作用 早期的程言如Basic、Fortran没有文件的观点，C言的初学者然会用使用文件，但经常不明其理。里文件的作用略作解： （1）通文件来用功能。在好多合，源代不便（或不准）向用宣布，只需向用提供文件和二制的即可。用只需要按照文件中的接口声明来用功能，而不必关心接口怎么的。器会从中提取相的代。 2）文件能加型安全。如果某个接口被或被使用，其方式与文件中的声明不一致，器就会指出，一的能大大减程序、改的担。 . 精品文档 1.5目录结构 如果一个件的文件数目比多（如超十个），往常将文件和定文件分保存于不同的目，以便于。 比如可将文件保存于  include  目，将定文件保存于  source  目（能够是多目 ）。 如果某些文件是私有的，它不会被用的程序直接引用，没有必要公然其“声明”。 了加信息藏，些私有的文件能够和定文件寄存于同一个目。 第2章程序的版式 版式然不会影响程序的功能，但会影响可性。程序的版式追求清晰、美，是程序格的重要组成因素。 能够把程序的版式比“法”。好的“法”可人程序了如指掌，看得致勃勃。差的程序“法”如螃蟹爬行，人看得索然无味，更令者有加。程序学程序的“法”，弥大学算机教育的破绽，在很有必要。 2.1空行 空行起着分开程序段落的作用。空行得体（不多也不少）将使程序的布局更为清晰。空行不会浪内存，然打印含有空行的程序是会多消耗一些，但是得。所以不要舍不得用空行。 【2-1-1 】