[轉]C++中的頭檔案和源檔案 .h & .cpp

頭檔案放聲明，源檔案放具體定義。 

原文:

http://www.cnblogs.com/lidabo/archive/2012/04/17/2454568.html

一、C++編譯模式

通常，在一個C++程式中，隻包含兩類檔案——.cpp檔案和.h檔案。其中，.cpp檔案被稱作C++源檔案，裡面放的都是C++的源代碼；而.h檔案則被稱作C++頭檔案，裡面放的也是C++的源代碼。

C+ +語言支援“分别編譯”（separate compilation）。也就是說，一個程式所有的内容，可以分成不同的部分分别放在不同的.cpp檔案裡。.cpp檔案裡的東西都是相對獨立的，在編 譯（compile）時不需要與其他檔案互通，隻需要在編譯成目标檔案後再與其他的目标檔案做一次連結（link）就行了。比如，在檔案a.cpp中定義 了一個全局函數“void a() {}”，而在檔案b.cpp中需要調用這個函數。即使這樣，檔案a.cpp和檔案b.cpp并不需要互相知道對方的存在，而是可以分别地對它們進行編譯， 編譯成目标檔案之後再連結，整個程式就可以運作了。

這是怎麼實作的呢？從寫程式的角度來講，很簡單。在檔案b.cpp中，在調用 “void a()”函數之前，先聲明一下這個函數“void a();”，就可以了。這是因為編譯器在編譯b.cpp的時候會生成一個符号表（symbol table），像“void a()”這樣的看不到定義的符号，就會被存放在這個表中。再進行連結的時候，編譯器就會在别的目标檔案中去尋找這個符号的定義。一旦找到了，程式也就可以 順利地生成了。

注意這裡提到了兩個概念，一個是“定義”，一個是“聲明”。簡單地說，“定義”就是把一個符号完完整整地描述出來：它是變 量還是函數，傳回什麼類型，需要什麼參數等等。而“聲明”則隻是聲明這個符号的存在，即告訴編譯器，這個符号是在其他檔案中定義的，我這裡先用着，你連結 的時候再到别的地方去找找看它到底是什麼吧。定義的時候要按C++文法完整地定義一個符号（變量或者函數），而聲明的時候就隻需要寫出這個符号的原型了。 需要注意的是，一個符号，在整個程式中可以被聲明多次，但卻要且僅要被定義一次。試想，如果一個符号出現了兩種不同的定義，編譯器該聽誰的？

這 種機制給C++程式員們帶來了很多好處，同時也引出了一種編寫程式的方法。考慮一下，如果有一個很常用的函數“void f() {}”，在整個程式中的許多.cpp檔案中都會被調用，那麼，我們就隻需要在一個檔案中定義這個函數，而在其他的檔案中聲明這個函數就可以了。一個函數還 好對付，聲明起來也就一句話。但是，如果函數多了，比如是一大堆的數學函數，有好幾百個，那怎麼辦？能保證每個程式員都可以完完全全地把所有函數的形式都 準确地記下來并寫出來嗎？

二、什麼是頭檔案

很顯然，答案是不可能。但是有一個很簡單地辦法，可以幫助程式員們省去記住那麼多函數原型的麻煩：我們可以把那幾百個函數的聲明語句全都先寫好，放在一個檔案裡，等到程式員需要它們的時候，就把這些東西全部copy進他的源代碼中。

這 個方法固然可行，但還是太麻煩，而且還顯得很笨拙。于是，頭檔案便可以發揮它的作用了。所謂的頭檔案，其實它的内容跟.cpp檔案中的内容是一樣的，都是 C++的源代碼。但頭檔案不用被編譯。我們把所有的函數聲明全部放進一個頭檔案中，當某一個.cpp源檔案需要它們時，它們就可以通過一個宏指令 “#include”包含進這個.cpp檔案中，進而把它們的内容合并到.cpp檔案中去。當.cpp檔案被編譯時，這些被包含進去的.h檔案的作用便發 揮了。

舉一個例子吧，假設所有的數學函數隻有兩個：f1和f2，那麼我們把它們的定義放在math.cpp裡：

/* math.cpp */

double f1()

{

    //do something here....

    return;

}

double f2(double a)

    //do something here...

    return a * a;

/* end of math.cpp */

并把“這些”函數的聲明放在一個頭檔案math.h中：

/* math.h */

double f1();

double f2(double);

/* end of math.h */

在另一個檔案main.cpp中，我要調用這兩個函數，那麼就隻需要把頭檔案包含進來：

/* main.cpp */

#include "math.h"

main()

    int number1 = f1();

    int number2 = f2(number1);

/* end of main.cpp */

這 樣，便是一個完整的程式了。需要注意的是，.h檔案不用寫在編譯器的指令之後，但它必須要在編譯器找得到的地方（比如跟main.cpp在一個目錄下）。 main.cpp和math.cpp都可以分别通過編譯，生成main.o和math.o，然後再把這兩個目标檔案進行連結，程式就可以運作了。

三、#include

#include 是一個來自C語言的宏指令，它在編譯器進行編譯之前，即在預編譯的時候就會起作用。#include的作用是把它後面所寫的那個檔案的内容，完完整整地、 一字不改地包含到目前的檔案中來。值得一提的是，它本身是沒有其它任何作用與副功能的，它的作用就是把每一個它出現的地方，替換成它後面所寫的那個檔案的 内容。簡單的文本替換，别無其他。是以，main.cpp檔案中的第一句（#include "math.h"），在編譯之前就會被替換成math.h檔案的内容。即在編譯過程将要開始的時候，main.cpp的内容已經發生了改變：

/* ~main.cpp */

/* end of ~main.cpp */

不多不少，剛剛好。同理可知，如果我們除了main.cpp以外，還有其他的很多.cpp檔案也用到了f1和f2函數的話，那麼它們也通通隻需要在使用這兩個函數前寫上一句#include "math.h"就行了。

四、頭檔案中應該寫什麼

通 過上面的讨論，我們可以了解到，頭檔案的作用就是被其他的.cpp包含進去的。它們本身并不參與編譯，但實際上，它們的内容卻在多個.cpp檔案中得到了 編譯。通過“定義隻能有一次”的規則，我們很容易可以得出，頭檔案中應該隻放變量和函數的聲明，而不能放它們的定義。因為一個頭檔案的内容實際上是會被引 入到多個不同的.cpp檔案中的，并且它們都會被編譯。放聲明當然沒事，如果放了定義，那麼也就相當于在多個檔案中出現了對于一個符号（變量或函數）的定 義，縱然這些定義都是相同的，但對于編譯器來說，這樣做不合法。

是以，應該記住的一點就是，.h頭檔案中，隻能存在變量或者函數的聲明， 而不要放定義。即，隻能在頭檔案中寫形如：extern int a;和void f();的句子。這些才是聲明。如果寫上int a;或者void f() {}這樣的句子，那麼一旦這個頭檔案被兩個或兩個以上的.cpp檔案包含的話，編譯器會立馬報錯。（關于extern，前面有讨論過，這裡不再讨論定義跟 聲明的差別了。）

但是，這個規則是有三個例外的。

一，頭檔案中可以寫const對象的定義。因為全局的const對象默 認是沒有extern的聲明的，是以它隻在目前檔案中有效。把這樣的對象寫進頭檔案中，即使它被包含到其他多個.cpp檔案中，這個對象也都隻在包含它的 那個檔案中有效，對其他檔案來說是不可見的，是以便不會導緻多重定義。同時，因為這些.cpp檔案中的該對象都是從一個頭檔案中包含進去的，這樣也就保證 了這些.cpp檔案中的這個const對象的值是相同的，可謂一舉兩得。同理，static對象的定義也可以放進頭檔案。

二，頭檔案中可 以寫内聯函數（inline）的定義。因為inline函數是需要編譯器在遇到它的地方根據它的定義把它内聯展開的，而并非是普通函數那樣可以先聲明再鍊 接的（内聯函數不會連結），是以編譯器就需要在編譯時看到内聯函數的完整定義才行。如果内聯函數像普通函數一樣隻能定義一次的話，這事兒就難辦了。因為在 一個檔案中還好，我可以把内聯函數的定義寫在最開始，這樣可以保證後面使用的時候都可以見到定義；但是，如果我在其他的檔案中還使用到了這個函數那怎麼辦 呢？這幾乎沒什麼太好的解決辦法，是以C++規定，内聯函數可以在程式中定義多次，隻要内聯函數在一個.cpp檔案中隻出現一次，并且在所有的.cpp文 件中，這個内聯函數的定義是一樣的，就能通過編譯。那麼顯然，把内聯函數的定義放進一個頭檔案中是非常明智的做法。

三，頭檔案中可以寫類 （class）的定義。因為在程式中建立一個類的對象時，編譯器隻有在這個類的定義完全可見的情況下，才能知道這個類的對象應該如何布局，是以，關于類的 定義的要求，跟内聯函數是基本一樣的。是以把類的定義放進頭檔案，在使用到這個類的.cpp檔案中去包含這個頭檔案，是一個很好的做法。在這裡，值得一提 的是，類的定義中包含着資料成員和函數成員。資料成員是要等到具體的對象被建立時才會被定義（配置設定空間），但函數成員卻是需要在一開始就被定義的，這也就 是我們通常所說的類的實作。一般，我們的做法是，把類的定義放在頭檔案中，而把函數成員的實作代碼放在一個.cpp檔案中。這是可以的，也是很好的辦法。 不過，還有另一種辦法。那就是直接把函數成員的實作代碼也寫進類定義裡面。在C++的類中，如果函數成員在類的定義體中被定義，那麼編譯器會視這個函數為 内聯的。是以，把函數成員的定義寫進類定義體，一起放進頭檔案中，是合法的。注意一下，如果把函數成員的定義寫在類定義的頭檔案中，而沒有寫進類定義中， 這是不合法的，因為這個函數成員此時就不是内聯的了。一旦頭檔案被兩個或兩個以上的.cpp檔案包含，這個函數成員就被重定義了。

五、頭檔案中的保護措施

考 慮一下，如果頭檔案中隻包含聲明語句的話，它被同一個.cpp檔案包含再多次都沒問題——因為聲明語句的出現是不受限制的。然而，上面讨論到的頭檔案中的 三個例外也是頭檔案很常用的一個用處。那麼，一旦一個頭檔案中出現了上面三個例外中的任何一個，它再被一個.cpp包含多次的話，問題就大了。因為這三個 例外中的文法元素雖然“可以定義在多個源檔案中”，但是“在一個源檔案中隻能出現一次”。設想一下，如果a.h中含有類A的定義，b.h中含有類B的定 義，由于類B的定義依賴了類A，是以b.h中也#include了a.h。現在有一個源檔案，它同時用到了類A和類B，于是程式員在這個源檔案中既把 a.h包含進來了，也把b.h包含進來了。這時，問題就來了：類A的定義在這個源檔案中出現了兩次！于是整個程式就不能通過編譯了。你也許會認為這是程式 員的失誤——他應該知道b.h包含了a.h——但事實上他不應該知道。

使用"#define"配合條件編譯可以很好地解決這個問題。在一 個頭檔案中，通過#define定義一個名字，并且通過條件編譯#ifndef...#endif使得編譯器可以根據這個名字是否被定義，再決定要不要繼 續編譯該頭文中後續的内容。這個方法雖然簡單，但是寫頭檔案時一定記得寫進去。

本文轉自火地晉部落格園部落格，原文連結：http://www.cnblogs.com/yelaiju/archive/2012/11/27/2790423.html，如需轉載請自行聯系原作者