Udostępnij za pośrednictwem

/headerName (Utwórz jednostkę nagłówka z określonego nagłówka)

  • Artykuł

Skompiluj określony plik nagłówka do jednostki nagłówka (.ifc pliku).

Składnia

/headerName:quote header-filename
/headerName:angle header-filename

Argumenty

header-filename
Nazwa pliku nagłówka, który kompilator powinien skompilować do jednostki nagłówka (.ifc pliku).

Uwagi

Opcje kompilatora /headerName:quote i /headerName:angle są dostępne od wersji 16.10 programu Visual Studio 2019.

Opcje kompilatora /headerName we wszystkich ich formularzach wymagają opcji kompilatora lub nowszego /std:c++20 (na przykład /std:c++latest).
Jeśli określisz /headerName opcję, musisz również określić wartość /exportHeader.

  • /headerName:quote wyszukuje header-filename przy użyciu tych samych reguł co #include "header-filename" i kompiluje je jako jednostkę nagłówka (.ifc plik).
  • /headerName:angle wyszukuje header-filename przy użyciu tych samych reguł co #include <header-filename> i kompiluje je jako jednostkę nagłówka (.ifc plik).

Aby uzyskać więcej informacji na temat reguł wyszukiwania ścieżek dla dołączonych plików w cudzysłowie lub nawiasach kątowych, zobacz #include dyrektywę.

Przykłady

Biorąc pod uwagę projekt, który odwołuje się do pliku nagłówka, który definiuje , m.hopcja kompilatora do skompilowania go do jednostki nagłówka wygląda podobnie do tego przykładu:

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

Opcje /headerName:quote i /headerName:angle działają jak flaga i nie wymagają argumentu. Następujące przykłady są prawidłowe:

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Można określić wiele /headerName opcji w tym samym wierszu polecenia. Każdy argument po przetworzeniu /headerName opcji z określonymi regułami wyszukiwania plików dołączania dla cudzysłowów lub nawiasów kątowych do następnej /headerName opcji. Poniższy przykład przetwarza wszystkie nagłówki co poprzednie dwa przykłady wiersza polecenia w taki sam sposób jak poprzednio. Wyszukuje nagłówki przy użyciu zastosowanych reguł wyszukiwania tak, jakby zostały określone jako: #include <vector>, , #include <iostream>#include <algorithm>, #include "my-utilties.h"i #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

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

Uwaga

Zwykle nie należy ustawiać tej opcji w środowisku programistycznym programu Visual Studio. Jest on ustawiany przez system kompilacji.

  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. Ustaw listę rozwijaną Konfiguracja na Wszystkie konfiguracje. Ustaw listę rozwijaną Platforma na Wszystkie platformy.

  3. Wybierz stronę Właściwości>konfiguracji C/C++>Wiersza polecenia.

  4. Zmodyfikuj właściwość Opcje dodatkowe, aby dodać /headerName:quote opcje lub /headerName:angle i nazwy plików nagłówka, do których mają zastosowanie opcje. Następnie wybierz przycisk OK lub Zastosuj , aby zapisać zmiany.

Zobacz też

/exportHeader (Utwórz jednostki 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)