第1 章 文件結(jié)構(gòu)

     每個C++/C 程序通常分為兩個文件。一個文件用于保存程序的聲明（declaration ），
稱為頭文件。另一個文件用于保存程序的實現(xiàn)（implementation ），稱為定義（definition）
文件。
     C++/C 程序的頭文件以“.h”為后綴，C 程序的定義文件以“.c”為后綴，C++程序
的定義文件通常以“.cpp”為后綴（也有一些系統(tǒng)以“.cc”或“.cxx”為后綴）。

1.1  版權(quán)和版本的聲明

     版權(quán)和版本的聲明位于頭文件和定義文件的開頭（參見示例1-1），主要內(nèi)容有：
 （1）版權(quán)信息。
 （2 ）文件名稱，標(biāo)識符，摘要。
 （3 ）當(dāng)前版本號，作者/修改者，完成日期。
 （4 ）版本歷史信息。

    /*

    * Copyright (c) 2001,上海貝爾有限公司網(wǎng)絡(luò)應(yīng)用事業(yè)部
    * All rights reserved.

    *

    * 文件名稱：filename.h

    * 文件標(biāo)識：見配置管理計劃書
    * 摘     要：簡要描述本文件的內(nèi)容

    *

    * 當(dāng)前版本：1.1

    * 作     者：輸入作者（或修改者）名字
    * 完成日期：2001年7月20日

    *

    * 取代版本：1.0
    * 原作者 ：輸入原作者（或修改者）名字
    * 完成日期：2001年5月10日

    */

                                   示例1-1 版權(quán)和版本的聲明
1.2  頭文件的結(jié)構(gòu)

  頭文件由三部分內(nèi)容組成：
 （1）頭文件開頭處的版權(quán)和版本聲明（參見示例1-1）。
 （2 ）預(yù)處理塊。
 （3 ）函數(shù)和類結(jié)構(gòu)聲明等。
     假設(shè)頭文件名稱為 graphics.h，頭文件的結(jié)構(gòu)參見示例1-2。
1.3  定義文件的結(jié)構(gòu)

     定義文件有三部分內(nèi)容：
 （1） 定義文件開頭處的版權(quán)和版本聲明（參見示例1-1）。
 （2 ） 對一些頭文件的引用。
 （3 ） 程序的實現(xiàn)體（包括數(shù)據(jù)和代碼）。
     假設(shè)定義文件的名稱為 graphics.cpp，定義文件的結(jié)構(gòu)參見示例1-3。

    // 版權(quán)和版本聲明見示例1-1，此處省略。

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

    …

    // 全局函數(shù)的實現(xiàn)體

    void Function1(…)

    {

      …

    }

    // 類成員函數(shù)的實現(xiàn)體
1.5    目錄結(jié)構(gòu)

     如果一個軟件的頭文件數(shù)目比較多（如超過十個），通常應(yīng)將頭文件和定義文件分
別保存于不同的目錄，以便于維護。
     例如可將頭文件保存于include        目錄，將定義文件保存于source  目錄（可以是多級
目錄）。
     如果某些頭文件是私有的，它不會被用戶的程序直接引用，則沒有必要公開其“聲
明”。為了加強信息隱藏，這些私有的頭文件可以和定義文件存放于同一個目錄。