Udostępnij za pośrednictwem


/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ą /headerUnitpolecenia .

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:

  1. W okienku po lewej stronie właściwości projektu wybierz pozycję Właściwości>konfiguracji C/C++>General.

  2. Zmień listę rozwijaną Translate Includes to Import na Tak.

    Zrzut ekranu przedstawiający okno dialogowe Strony właściwości z wyróżnioną właściwością Translate Includes to Import.

  3. 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++