/exportHeader (Utwórz jednostki nagłówka)

  • Artykuł

Informuje kompilator o utworzeniu jednostek nagłówka określonych przez argumenty wejściowe. Kompilator generuje jednostki nagłówka jako pliki IFC (.ifc).

Składnia

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Argumenty

Argument /exportHeader/headerName to opcja wiersza polecenia określająca nazwę , header-namepliku nagłówka do wyeksportowania.

Uwagi

/exportHeader Program jest dostępny od wersji 16.10 programu Visual Studio 2019.

Opcja kompilatora /exportHeader wymaga włączenia lub nowszej /std:c++20 opcji kompilatora (np /std:c++latest. ).

Jedna /exportHeader opcja kompilatora może określać tyle argumentów nazwy nagłówka, ile wymaga kompilacja. Nie trzeba ich określać oddzielnie.

Kompilator niejawnie włącza nowy preprocesor, gdy ta opcja jest używana. Oznacza to, że jest dodawany do wiersza polecenia przez kompilator, /Zc:preprocessor jeśli jakakolwiek forma /exportHeader jest używana w wierszu polecenia. Aby zrezygnować z niejawnego /Zc:preprocessorelementu , użyj: /Zc:preprocessor-

Domyślnie kompilator nie tworzy pliku obiektu podczas kompilowania jednostki nagłówka. Aby utworzyć plik obiektu, określ opcję kompilatora /Fo . Aby uzyskać więcej informacji, zobacz /Fo (Nazwa pliku obiektu).

Warto użyć opcji /showResolvedHeaderuzupełniającej . Opcja /showResolvedHeader wyświetla ścieżkę bezwzględną do pliku, do których header-name argument jest rozpoznawany.

/exportHeader może obsługiwać wiele danych wejściowych jednocześnie, nawet w obszarze /MP. Zalecamy /ifcOutput <directory> utworzenie oddzielnego .ifc pliku dla każdej kompilacji.

Przykłady

Aby utworzyć jednostkę nagłówka, taką jak <vector> może wyglądać następująco:

cl . . . /std:c++latest /exportHeader /headerName:angle vector

Kompilowanie nagłówka projektu lokalnego, takiego jak "utils/util.h" może wyglądać następująco:

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

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

Zwykle nie należy ustawiać tej opcji w środowisku programistycznym programu Visual Studio, chyba że używasz innego rozszerzenia dla plików nagłówkowych. Domyślnie system kompilacji stosuje tę opcję do skompilowanych plików z .h rozszerzeniem lub bez rozszerzenia.

  1. Aby zastosować /exportHeader opcję do pliku jawnie w środowisku IDE, wybierz plik w Eksplorator rozwiązań. Kliknij prawym przyciskiem myszy, aby otworzyć menu kontekstowe i wybierz polecenie Właściwości , aby otworzyć okno dialogowe Strony właściwości.

  2. Ustaw listę rozwijaną Konfiguracja na Wszystkie konfiguracje. Ustaw listę rozwijaną Platforma na Wszystkie platformy.

  3. Otwórz stronę właściwości>konfiguracji C/C++>Advanced.

  4. Za pomocą kontrolki listy rozwijanej zmodyfikuj właściwość Kompiluj jako skompiluj jako jednostkę nagłówka języka C++ (/exportHeader). Wybierz przycisk OK lub Zastosuj , aby zapisać zmiany.

Zobacz też

/headerName (Utwórz jednostkę nagłówka z określonego nagłówka)
/headerUnit (Użyj jednostki nagłówka IFC)
/reference (Użyj nazwanego modułu IFC)
/translateInclude (Tłumaczenie dyrektyw dołączania do dyrektyw importu)