第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。
1.3  定义文件的结构

     定义文件有三部分内容：
 （1） 定义文件开头处的版权和版本声明（参见示例1-1）。
 （2 ） 对一些头文件的引用。
 （3 ） 程序的实现体（包括数据和代码）。
     假设定义文件的名称为 graphics.cpp，定义文件的结构参见示例1-3。

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

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

    …

    // 全局函数的实现体

    void Function1(…)

    {

      …

    }

    // 类成员函数的实现体
1.5    目录结构

     如果一个软件的头文件数目比较多（如超过十个），通常应将头文件和定义文件分
别保存于不同的目录，以便于维护。
     例如可将头文件保存于include        目录，将定义文件保存于source  目录（可以是多级
目录）。
     如果某些头文件是私有的，它不会被用户的程序直接引用，则没有必要公开其“声
明”。为了加强信息隐藏，这些私有的头文件可以和定义文件存放于同一个目录。