次の方法で共有

#include ディレクティブ

  • [アーティクル]

指定したファイルの内容を、ディレクティブが表示されるポイントのソース プログラムに挿入するプリプロセッサ ディレクティブ。

"filename" を #include する
<#include ファイル名>

パラメーター

アイテム 説明
ファイル名 インクルードするファイルのファイル名。必要に応じて、ディレクトリ指定の前に置きます。 ファイル名は、既存のファイルを指定する必要があります。

解説

#include ディレクティブは、指定したファイルの内容全体で ディレクティブを置き換えます。 プリプロセッサは、指定した名前のファイルが見つかるとすぐに検索を停止します。ファイルの完全で明確なパス指定を指定すると、プリプロセッサは指定されたパスのみを検索します。

Note

Effect-Compiler Tool には、/I スイッチを使用する組み込みのインクルード ハンドラーがあります。 ただし、API からコンパイラを実行する場合は、ID3DXInclude インターフェイスを実装することで、カスタマイズされたインクルード ハンドラーを提供できます。

2 つの構文形式の違いは、次の表に示すように、パスが不完全に指定されたときにプリプロセッサがヘッダー ファイルを検索する順序です。

構文形式 プリプロセッサ検索パターン
"filename" を #include する インクルード ファイルを検索します。
  1. は、#include ディレクティブを含むファイルと同じディレクトリに格納されます。
  2. #include ディレクティブを含むファイルの #include ディレクティブを含むファイルのディレクトリ内。
  3. /I コンパイラ オプションで指定されたパス内で、それらが一覧表示される順序で指定されます。

  4. は、INCLUDE 環境変数によって指定されたパス内で、それらが一覧表示される順序で指定されます。

    注:
    INCLUDE 環境変数は、開発環境では無視されます。 プロジェクトのインクルード パスを設定する方法については、開発環境のドキュメントを参照してください。
<#include ファイル名> インクルード ファイルを検索します。
  1. /I コンパイラ オプションで指定されたパス内で、それらが一覧表示される順序で指定されます。

  2. は、INCLUDE 環境変数によって指定されたパス内で、それらが一覧表示される順序で指定されます。

    注:
    INCLUDE 環境変数は、開発環境では無視されます。 プロジェクトのインクルード パスを設定する方法については、開発環境のドキュメントを参照してください。

例

次の例では、プリプロセッサが #include ディレクティブを stdio.h の内容に置き換えます。 この例では山かっこ形式を使用するため、プリプロセッサは /I コンパイラ オプションと INCLUDE 環境変数で一覧表示されているディレクトリでのみファイルを検索します。

#include <stdio.h>

関連項目