高质量C++/C编程指南 -- 第1章文件结构-编程初步-福州电脑维修|上门维修维护|包年电脑维修|IT外包

高质量C++/C编程指南 -- 第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 格式来援用尺度库的头文件（编译器将从尺度库目录开始搜刮）。
l 【规则1-2-3】用 #include “filename.h” 格式来援用非尺度库的头文件（编译器将从用户的工作目录开始搜刮）。
2 【建议1-2-1】头文件中只寄存“声明”而不寄存“界说”
在C++ 语法中，类的成员函数可以在声明的同时被界说，并临时动成为内联函数。这固然会带来誊写上的方便，但却造成了气势派头不同等，弊大于利。建议将成员函数的界说与声明分开，不论该函数体有多么小。
2 【建议1-2-2】不提倡使用全局变量，只管即便不要在头文件中出征象extern int value 这类声明。
// 版权和版本声明见示例1-1，此处省略。
#ifndef GRAPHICS_H // 防止graphics.h被重复援用
#define GRAPHICS_H
#include // 援用尺度库的头文件
…
#include “myheader.h” // 援用非尺度库的头文件
…
void Function1(…); // 全局函数声明
…
class Box // 类结构声明
{
…
};
#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目录（可以是多级目录）。
要是某些头文件是公有的，它不会被用户的程序直接援用，则没有须要公开其“声明”。为了加强信息隐藏，这些公有的头文件可以和界说文件寄存于同一个目录。