/I (Zusätzliche Includeverzeichnisse)

  • Artikel

Fügt der Liste der Verzeichnisse, die nach eingeschlossenen Dateien gesucht werden, ein Verzeichnis hinzu.

Syntax

/Iverzeichnis

Argumente

verzeichnis
Das Verzeichnis, das der Liste der Verzeichnisse hinzugefügt werden soll, die nach eingeschlossenen Dateien gesucht werden sollen. Der Abstand zwischen /I und Verzeichnis ist optional. Verzeichnisse, die Leerzeichen enthalten, müssen in doppelte Anführungszeichen eingeschlossen werden. Ein Verzeichnis kann ein absoluter Pfad oder ein relativer Pfad sein.

Hinweise

Wenn Sie mehrere Verzeichnisse hinzufügen möchten, verwenden Sie diese Option mehrmals. Verzeichnisse werden nur durchsucht, bis die angegebene Includedatei gefunden wird.

Sie können diese Option in derselben Befehlszeile wie die Option (/X (Standardeinschließpfade ignorieren)) verwenden.

Eine #include Direktive kann z #include "local.h". B. in Form eines doppelten Anführungszeichens (oder lokal-first) angegeben werden. Oder es kann in einem Winkel-Klammer-Formular (oder include-path-first) angegeben werden, #include <iostream>z. B. .

Der Compiler durchsucht Verzeichnisse in der folgenden Reihenfolge:

  1. Wenn die #include Direktive mit doppeltem Anführungszeichen-Formular angegeben wird, durchsucht sie zuerst lokale Verzeichnisse. Die Suche beginnt im selben Verzeichnis wie die Datei, die die #include Direktive enthält. Wenn die Datei nicht gefunden werden kann, durchsucht sie in den Verzeichnissen der aktuell geöffneten Dateien in umgekehrter Reihenfolge, in der sie geöffnet wurden. Die Suche beginnt im Verzeichnis der übergeordneten Includedatei und wird nach oben durch die Verzeichnisse aller Includedateien der zweiten übergeordneten Ebene fortgesetzt.

  2. Wenn die #include Direktive in eckigen Klammern angegeben ist oder wenn die lokale Verzeichnissuche fehlgeschlagen ist, durchsucht sie Verzeichnisse, die mithilfe der /I Option angegeben werden, in der Reihenfolge, in der sie in der Befehlszeile angegeben sind.

  3. In der Umgebungsvariable INCLUDE angegebene Verzeichnisse.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Weitere Informationen erhalten Sie unter Set C++ compiler and build properties in Visual Studio (Festlegen der Compiler- und Buildeigenschaften (C++) in Visual Studio).

  2. Navigieren Sie zur Eigenschaftenseite Konfigurationseigenschaften>C/C++>Allgemein.

  3. Ändern Sie die Eigenschaft "Additional Include Directories ". Sie können in dieser Eigenschaft mehrere Verzeichnisse gleichzeitig angeben. Verzeichnisse müssen durch ein Semikolon (;) getrennt werden.

So legen Sie diese Compileroption programmgesteuert fest

Beispiel

Der folgende Befehl sucht nach den in der folgenden Reihenfolge angeforderten main.c Includedateien: Wenn sie mithilfe von doppelten Anführungszeichen angegeben werden, werden lokale Dateien durchsucht. Als Nächstes wird die \include Suche im Verzeichnis, dann im \my\include Verzeichnis und schließlich in den Verzeichnissen fortgesetzt, die der INCLUDE Umgebungsvariablen zugewiesen sind, von links nach rechts.

CL /I \include /I\my\include main.c

Siehe auch

MSVC-Compileroptionen
Syntax für die MSVC-Compilerbefehlszeile