c程序的书写格式.doc

c 程序的书写格式 ? c++程序的书写格式2010-05-18 17：03文件结构文件头注释所有C++的源文件均必须包含一个规范的文件头，文件头包含了该文件的名称、功能概述、作者、版权和版本历史信息等内容。标准文件头的格式为：/*！@file*PRE模块名：文件所属的模块名称文件名：文件名相关文件：与此文件相关的其它文件文件实现功能：描述该文件实现的主要功能作者：作者部门和姓名版本：当前版本号--备注：其它说明--修改记录：日期版本修改人修改内容YYYY/MM/DD X.Y作者或修改者名修改内容/PRE*/如果该文件有其它需要说明的地方，还可以专门为此扩展一节：/*！@file*PRE模块名：文件所属的模块名称文件名：文件名相关文件：与此文件相关的其它文件文件实现功能：描述该文件实现的主要功能作者：作者部门和姓名版本：当前版本号--备注：其它说明--修改记录：日期版本修改人修改内容YYYY/MM/DD X.Y作者或修改者名修改内容/PRE**项目1-项目1.1-项目1.2==*项目2-项目2.1-项目2.2.*/每行注释的长度都不应该超过80个半角字符。还要注意缩进和对其，以利阅读。关于文件头的完整例子，请参见：文件头例子关于文件头的模板，请参见：文件头注释模板头文件头文件通常由以下几部分组成：文件头注释每个头文件，无论是内部的还是外部的，都应该由一个规范的文件头注释作为开始。预处理块为了防止头文件被重复引用，应当用ifndef/define/endif结构产生预处理块。函数和类/结构的声明等声明模块的接口需要包含的内联函数定义文件(如果有的话)如果类中的内联函数较多，或者一个头文件中包含多个类的定义(不推荐)，可以将所有内联函数定义放入一个单独的内联函数定义文件中，并在类声明之后用#include指令把它包含进来。头文件的编码规则：引用文件的格式用#include filename.h格式来引用标准库和系统库的头文件(编译器将从标准库目录开始搜索)。用#includefilename.h格式来引用当前工程中的头文件(编译器将从该文件所在目录开始搜索)。分割多组接口(如果有的话)如果在一个头件中定义了多个类或者多组接口(不推荐)，为了便于浏览，应该在每个类/每组接口间使用分割带把它们相互分开。关于头文件的完整例子，请参见：头文件例子内联函数定义文件如上所述，在内联函数较多的情况下，为了避免头文件过长、版面混乱，可以将所有的内联函数定义移到一个单独的文件中去，然后再用#include指令将它包含到类声明的后面。这样的文件称为一个内联函数定义文件。按照惯例，应该将这个文件命名为filename.inl，其中filename与相应的头文件和实现文件相同。内联函数定义文件由以下几部分组成：文件头注释每内联函数定义文件都应该由一个规范的文件头注释作为开始内联函数定义内联函数的实现体内联函数定义文件的编码规则：分割多组接口(如果有的话)如果在一个内联函数定义文件中定义了多个类或者多组接口的内联函数(不推荐)，必须在每个类/每组接口间使用分割带把它们相互分开。文件组成中为什么没有预处理块?与头文件不同，内联函数定义文件通常不需要定义预处理块，这是因为它通常被包含在与其相应的头文件预处理块内。关于内联函数定义文件的完整例子，请参见：内联函数定义文件例子实现文件实现文件包含所有数据和代码的实现体。实现文件的格式为：文件头注释每个实现文件都应该由一个规范的文件头注释作为开始对配套头文件的引用引用声明了此文件实现的类、函数及数据的头文件对一些仅用于实现的头文件的引用(如果有的话)将仅与实现相关的接口包含在实现文件里(而不是头文件中)是一个非常好的编程习惯。这样可以有效地屏蔽不应该暴露的实现细节，将实现改变对其它模块的影响降低到最少。程序的实现体数据和函数的定义实现文件的编码规则：分割每个部分在本地(静态)定义和外部定义间，以及不同接口或不同类的实现之间，应使用分割带相互分开。关于实现文件的完整例子，请参见：实现文件例子文件的组织结构由于项目性质、规模上存在着差异，不同项目间的文件组织形式差别很大。但文件、目录组织的基本原则应当是一致的：使外部接口与内部实现尽量分离；尽可能清晰地表达软件的层次结构…为此提供两组典型项目的文件组织结构范例作为参考：功能模块/库的文件组织形式显而易见，编写功能模块和库的主要目的是为其它模块提供一套完成特定功能的API，这类项目的文件组织结构通常如下图所示：其中：contrib当前项目所依赖的所有第三方软件，可以按类别分设子目录。doc项目文档include声明外部接口的所有头文件和内联定义文件。lib编译好的二进制库文件，可以按编译器、平台分设子目录。makefile用于编译项目的makefile文件和project文