共用方式為


#include 指示詞

預處理器指示詞,將指定檔案的內容插入來來源程式出現在指示詞出現的位置。

#include 「filename
<#include檔案名>

參數

項目 描述
filename 要包含之檔案的檔案名,選擇性地前面加上目錄規格。 檔案名必須指定現有的檔案。

備註

#include 指示詞會使指定檔案的整個內容取代 指示詞。 預處理器會在找到具有指定名稱的檔案時立即停止搜尋;如果您指定檔案的完整明確路徑規格,預處理器只會搜尋指定的路徑。

注意

Effect-Compiler 工具具有使用 /I 參數的內建 Include 處理常式。 不過,從 API 執行編譯器時,您可以實作 ID3DXInclude 介面來提供自訂的 Include 處理常式。

這兩種語法表單之間的差異是預處理器在路徑未完整指定時搜尋標頭檔的順序,如下表所示。

語法形式 預處理器搜尋模式
#include filename 搜尋 include 檔案:
  1. 與包含 #include 指示詞之檔案相同的目錄中。
  2. 在包含 #include 指示詞之檔案之 #include 指示詞的任何檔案目錄中。
  3. 在 /I 編譯器選項所指定的路徑中,依列出它們的順序。
  4. 在 INCLUDE 環境變數所指定的路徑中,依列出它們的順序。

    注意:
    開發環境中會忽略 INCLUDE 環境變數。 如需如何設定專案包含路徑的資訊,請參閱開發環境的檔。


<#include檔案名> 搜尋 include 檔案:
  1. 在 /I 編譯器選項所指定的路徑中,依列出它們的順序。
  2. 在 INCLUDE 環境變數所指定的路徑中,依列出它們的順序。

    注意:
    開發環境中會忽略 INCLUDE 環境變數。 如需如何設定專案包含路徑的資訊,請參閱開發環境的檔。


範例

下列範例會使預處理器將 #include 指示詞取代為 stdio.h 的內容。 因為此範例使用角括弧格式,所以預處理器只會在 /I 編譯器選項和 INCLUDE 環境變數所列出的目錄中搜尋檔案。

#include <stdio.h>

另請參閱