#include 指示詞
預處理器指示詞,將指定檔案的內容插入來來源程式出現在指示詞出現的位置。
#include 「filename」 |
---|
<#include檔案名> |
參數
項目 | 描述 |
---|---|
filename | 要包含之檔案的檔案名,選擇性地前面加上目錄規格。 檔案名必須指定現有的檔案。 |
備註
#include 指示詞會使指定檔案的整個內容取代 指示詞。 預處理器會在找到具有指定名稱的檔案時立即停止搜尋;如果您指定檔案的完整明確路徑規格,預處理器只會搜尋指定的路徑。
注意
Effect-Compiler 工具具有使用 /I 參數的內建 Include 處理常式。 不過,從 API 執行編譯器時,您可以實作 ID3DXInclude 介面來提供自訂的 Include 處理常式。
這兩種語法表單之間的差異是預處理器在路徑未完整指定時搜尋標頭檔的順序,如下表所示。
語法形式 | 預處理器搜尋模式 |
---|---|
#include 「filename」 | 搜尋 include 檔案:
|
<#include檔案名> | 搜尋 include 檔案:
|
範例
下列範例會使預處理器將 #include 指示詞取代為 stdio.h 的內容。 因為此範例使用角括弧格式,所以預處理器只會在 /I 編譯器選項和 INCLUDE 環境變數所列出的目錄中搜尋檔案。
#include <stdio.h>