/I (Dodatkowe katalogi dołączania)

Dodaje katalog do listy katalogów przeszukanych pod kątem plików dołączanych.

Składnia

/Ikatalog

Argumenty

katalog
Katalog do dodania do listy katalogów wyszukanych plików dołączanych. Odstęp między katalogami /I i jest opcjonalny. Katalogi zawierające spacje muszą być ujęte w cudzysłowy. Katalog może być ścieżką bezwzględną lub ścieżką względną.

Uwagi

Aby dodać więcej niż jeden katalog, użyj tej opcji więcej niż raz. Katalogi są przeszukiwane tylko do momentu znalezienia określonego pliku dołączania.

Tej opcji można użyć w tym samym wierszu polecenia co opcja (/X Ignoruj standardowe ścieżki dołączania)).

Dyrektywę #include można określić w postaci podwójnego cudzysłowu (lub pierwszego lokalnego), na przykład #include "local.h". Można go również określić w nawiasie kątowym (lub w postaci include-path-first), na przykład #include <iostream>.

Katalogi kompilatora wyszukują w następującej kolejności:

1. Jeśli dyrektywa jest określona #include przy użyciu formularza podwójnego cudzysłowu, najpierw wyszukuje katalogi lokalne. Wyszukiwanie rozpoczyna się w tym samym katalogu co plik zawierający dyrektywę #include . Jeśli nie można odnaleźć pliku, wyszukuje go w katalogach aktualnie otwartych plików dołączanych w odwrotnej kolejności, w której zostały otwarte. Wyszukiwanie rozpoczyna się w katalogu pliku dołączania nadrzędnego i jest kontynuowane w górę przez katalogi wszystkich dziadków dołączania plików.

2. #include Jeśli dyrektywa jest określona w formularzu nawiasu kątowego lub wyszukiwanie w katalogu lokalnym nie powiodło się, wyszukuje katalogi określone przy użyciu /I opcji w kolejności, w jakiej są określone w wierszu polecenia.

3. Katalogi określone w zmiennej środowiskowej INCLUDE .

Aby ustawić tę opcję kompilatora w środowisku programowania Visual Studio

1. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać szczegółowe informacje, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilowania w programie Visual Studio).

2. Wybierz stronę właściwości Właściwości>konfiguracji C/C++>General.

3. Zmodyfikuj właściwość Dodatkowe katalogi dołączania . W tej właściwości można określić więcej niż jeden katalog. Katalogi muszą być oddzielone średnikami (;).

Aby programowo ustawić tę opcję kompilatora

• Zobacz: AdditionalIncludeDirectories.

Przykład

Następujące polecenie wyszukuje pliki dołączane main.c żądane w następującej kolejności: Najpierw, jeśli określono przy użyciu podwójnych cudzysłowów, przeszukiwane są pliki lokalne. Następnie wyszukiwanie będzie kontynuowane \include w katalogu, a następnie w \my\include katalogu, a na koniec w katalogach przypisanych do zmiennej środowiskowej INCLUDE w kolejności od lewej do prawej.

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

Zobacz też

Opcje kompilatora MSVC
Składnia wiersza polecenia kompilatora MSVC