/translateInclude
Ten przełącznik nakazuje kompilatorowi traktowanie #include
jako import
plików nagłówkowych, które zostały wbudowane w pliki jednostki nagłówka (.ifc
) i które są określone w wierszu polecenia za pomocą /headerUnit
polecenia .
W przypadku użycia z elementem /scanDependencies
lub /sourceDependencies-directives
, kompilator wyświetla listy jako zaimportowane jednostki nagłówków w wygenerowanym pliku zależności nagłówki, które są zarówno zawarte w źródle, jak i mają odpowiedni wpis w header-units.json
pliku. Te informacje o zależnościach są używane przez system kompilacji do generowania skompilowanych plików jednostek nagłówka .ifc
. Po skompilowaniu jednostek nagłówka są one traktowane przez kompilator jako import
zamiast #include
.
Plik header-units.json
jest konsultowany tylko wtedy, gdy /translateInclude
zostanie określony. Aby uzyskać więcej informacji na temat formatu i przeznaczenia header-units.json
pliku, zobacz header-units.json
.
#include
Jeśli plik nie znajduje się na liście w header-units.json
pliku, jest on traktowany jako normalny #include
.
Aby zapoznać się z przykładem użycia tego przełącznika, zobacz Przewodnik: kompilowanie i importowanie jednostek nagłówków w programie Microsoft Visual C++.
Składnia
/translateInclude
Uwagi
/translateInclude
jest dostępny w programie Visual Studio 2019 w wersji 16.10 lub nowszej.
/translateInclude
wymaga /std:c++20 lub nowszego.
Aby ustawić tę opcję kompilatora w programie Visual Studio
Aby włączyć element /translateInclude
, w oknie dialogowym właściwości projektu ustaw pozycję Translate Includes (Tłumaczenie dołączania) na Import:
W okienku po lewej stronie właściwości projektu wybierz pozycję Właściwości>konfiguracji C/C++>General.
Zmień listę rozwijaną Translate Includes to Import na Tak.
Wybierz przycisk OK lub Zastosuj , aby zapisać zmiany.
Zobacz też
/headerUnit
(Użyj jednostki nagłówka IFC).
/exportHeader
(Utwórz jednostki nagłówka)
/reference
(Użyj nazwanego modułu IFC)
/scanDependencies
/sourceDependencies-directives
Przewodnik: kompilowanie i importowanie jednostek nagłówków w programie Microsoft Visual C++