第 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” 格式來引用非標準庫的頭文件(編譯器將從用戶的工作目錄開始搜索)。
2 【建議 1-2-1 】 頭文件中只存放“聲明”而不存放“定義”
在 C++ 語法中,類的成員函數可以在聲明的同時被定義,并且自動成為內聯函數。這雖然會帶來書寫上的方便,但卻造成了風格不一致,弊大于利。建議將成員函數的定義與聲明分開,不論該函數體有多么小。 [1] [2] 下一頁
|