高质量C /C编程指南---第1章 文件结构


第1章 文件结构

每个C /C按次伟年夜分为两个文件。一个文件用于保管按次的声明(declaration),称为头文件。另一个文件用于保管按次的完成(implementation),称为界说(definition)文件。

C /C按次的头文件以“.h”为后缀,C按次的界说文件以“.c”为后缀,C 按次的界说文件伟年夜以“.cpp”为后缀(也有一些体系以“.cc”或“.cxx”为后缀)。

1.1 版权和版本的声明

版权和版本的声明位于头文件和界说文件的收尾(参见教例1-1),重要内容有:

(1)版权信息。

(2)文件称呼,标识符,摘要。

(3)今后版本号,作者/修正者,完成日期。

(4)版本汗青信息。

 

/*

* Copyright (c) 2001,上海贝尔有限公司网络使用奇观部

* All rights reserved.

*

* 文件称呼:filename.h

* 文件标识:见设置装备放置办理设计书

* 摘    要:简明描画本文件的内容

*

* 今后版本:1.1

* 作    者:输出作者(或修正者)名字

* 完成日期:2001年7月20日

*

* 取代版本:1.0

* 原作者  :输出原作者(或修正者)名字

* 完成日期:2001年5月10日

*/

 

示例1-1 版权和版本的声明

1.2 头文件的结构

头文件由三部分外容构成:

(1)头文件收尾处的版权和版本声明(参见教例1-1)。

(2)预处置惩罚块。

(3)函数和类结构声明等。

假定头文件称呼为 graphics.h,头文件的结构参见教例1-2。

 

l         【端方1-2-1为了防备头文件被重复援用,该当用ifndef/define/endif结构发作预处置惩罚块。

l         【端方1-2-2用 #include <filename.h> 把戏来援用标准库的头文件(编译器将从标准库目录初阶搜索)。

l         【端方1-2-3用 #include “filename.h” 把戏来援用非标准库的头文件(编译器将从用户的任务目录初阶搜索)。

²        【提倡1-2-1头文件中只存放“声明”而不存放“界说”

在C 语法中,类的成员函数可以在声明的同时被界说,并且主动成为内联函数。这固然会带来书写上的等闲,但却形成了风格不不同,弊年夜于利。提倡将成员函数的界说与声明分隔隔离分手,非论该函数体有多么小。

²        【提倡1-2-2不倡议运用全局变量,尽量不要在头文件中泛起象extern int value 这类声明。

 

// 版权和版本声明见教例1-1,此处省略。

 

#ifndef   GRAPHICS_H  // 防备graphics.h被重复援用

#define   GRAPHICS_H

 

#include <math.h>     // 援用标准库的头文件


#include “myheader.h”   // 援用非标准库的头文件


void Function1(…);   // 全局函数声明


>             // 类结构声明

{


};

#endif

示例1-2 C /C头文件的结构

 

1.3 界说文件的结构

界说文件有三部分外容:

(1)       界说文件收尾处的版权和版本声明(参见教例1-1)。

(2)       对一些头文件的援用。

(3)       按次的完成体(包罗数据和代码)。

假定界说文件的称呼为 graphics.cpp,界说文件的结构参见教例1-3。

 

// 版权和版本声明见教例1-1,此处省略。

 

#include “graphics.h”     // 援用头文件


 

// 全局函数的完成体

void Function1(…)

{


}

 

// 类成员函数的完成体

void Box::Draw(…)

{


}

示例1-3 C /C界说文件的结构

1.4 头文件的浸染

早期的编程语言如Basic、Fortran没有头文件的观点,C /C语言的初学者固然会用运用头文件,但经常不明其理。这里仇家文件的浸染略作解释:

(1)经由甚文件来挪用库功用。在许多场所,源代码便利(或禁绝)向用户颁布揭橥,只需向用户供应头文件和二进制的库即可。用户只需求依照头文件中的接口声明来挪用库功用,而不用关切接口怎样完成的。编译器会从库中提取响应的代码。

(2)头文件能加强');圭臬安详反省。假定某个接口被完成或被运用时,其体式把戏与头文件中的声明不不同,编译器就会指犯错误,这一庞年夜的端方能年夜年夜加重按次员调试、改错的担负。

1.5 目录结构

假定一个软件的头文件数目对照多(如跨越十个),伟年夜应将头文件和界说文件划分保管于不同的目录,以便于维护。

比方可将头文件保管于include目录,将界说文件保管于source目录(可以是多级目录)。

假定某些头文件是公有的,它不会被用户的按次间接援用,则没有必要地下其“声明”。为了加强');信息隐蔽,这些公有的头文件可以和界说文件存放于一致个目录。



版权声明:原创作品,答应转载,转载时请务必以超链接方法标明文章 原始来由 、作者信息和本声明。否则将穷究功令责任。

关注微信公众号

注意!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系我们删除。



 
粤ICP备14056181号  © 2014-2020 ITdaan.com