Freigeben über

#include-Anweisung

  • Artikel

Präprozessordirektive, die den Inhalt der angegebenen Datei an dem Punkt, an dem die Direktive angezeigt wird, in das Quellprogramm einfügt.

#include "filename"
< dateiname #include>

Parameter

Element Beschreibung
filename Dateiname der einzuschließenden Datei, optional vorangestellt durch eine Verzeichnisspezifikation. Der Dateiname muss eine vorhandene Datei angeben.

Hinweise

Die #include-Direktive bewirkt, dass die Direktive durch den gesamten Inhalt der angegebenen Datei ersetzt wird. Der Präprozessor beendet die Suche, sobald er eine Datei mit dem angegebenen Namen findet. Wenn Sie eine vollständige, eindeutige Pfadspezifikation für die Datei angeben, durchsucht der Präprozessor nur den angegebenen Pfad.

Hinweis

Das Effektcompilertool verfügt über einen integrierten Includehandler, der den Schalter /I verwendet. Beim Ausführen des Compilers über die API können Sie jedoch einen angepassten Includehandler bereitstellen, indem Sie die ID3DXInclude-Schnittstelle implementieren.

Der Unterschied zwischen den beiden Syntaxformen ist die Reihenfolge, in der der Präprozessor nach Headerdateien sucht, wenn der Pfad unvollständig angegeben ist, wie in der folgenden Tabelle gezeigt.

Syntaxformat Präprozessorsuchmuster
#include "filename" Sucht nach der Includedatei:
  1. im selben Verzeichnis wie die Datei, die die #include-Anweisung enthält.
  2. in den Verzeichnissen aller Dateien, die eine #include-Direktive für die Datei enthalten, die die #include-Direktive enthält.
  3. in Pfaden, die von der Compileroption /I angegeben werden, in der Reihenfolge, in der sie aufgelistet sind.

  4. in Pfaden, die von der UMGEBUNGsvariablen INCLUDE angegeben werden, in der Reihenfolge, in der sie aufgelistet werden.

    HINWEIS:
    Die INCLUDE-Umgebungsvariable wird in einer Entwicklungsumgebung ignoriert. Informationen zum Festlegen der Includepfade für Ihr Projekt finden Sie in der Dokumentation Ihrer Entwicklungsumgebung.
< dateiname #include> Sucht nach der Includedatei:
  1. in Pfaden, die von der Compileroption /I angegeben werden, in der Reihenfolge, in der sie aufgelistet sind.

  2. in Pfaden, die von der UMGEBUNGsvariablen INCLUDE angegeben werden, in der Reihenfolge, in der sie aufgelistet werden.

    HINWEIS:
    Die INCLUDE-Umgebungsvariable wird in einer Entwicklungsumgebung ignoriert. Informationen zum Festlegen der Includepfade für Ihr Projekt finden Sie in der Dokumentation Ihrer Entwicklungsumgebung.

Beispiele

Das folgende Beispiel bewirkt, dass der Präprozessor die #include-Direktive durch den Inhalt von stdio.h ersetzt. Da im Beispiel das Format mit spitzen Klammern verwendet wird, sucht der Präprozessor nur in den Verzeichnissen, die durch die Compileroption /I und die Umgebungsvariable INCLUDE aufgeführt sind.

#include <stdio.h>

Weitere Informationen