/exportHeader (Creare unità di intestazione)

  • Articolo

Indica al compilatore di creare le unità di intestazione specificate dagli argomenti di input. Il compilatore genera unità di intestazione come file IFC (.ifc).

Sintassi

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

Argomenti

L'argomento di /exportHeader è un'opzione /headerName della riga di comando che specifica il nome, header-name, del file di intestazione da esportare.

Osservazioni:

/exportHeader è disponibile a partire da Visual Studio 2019 versione 16.10.

L'opzione /exportHeader del compilatore richiede l'abilitazione dell'opzione /std:c++20 del compilatore o successiva , ad esempio /std:c++latest.

Un'opzione /exportHeader del compilatore può specificare il numero di argomenti header-name necessari per la compilazione. Non è necessario specificarli separatamente.

Il compilatore abilita in modo implicito il nuovo preprocessore quando viene usata questa opzione. Ciò significa che /Zc:preprocessor viene aggiunto alla riga di comando dal compilatore se nella riga di comando viene usata qualsiasi forma di /exportHeader . Per rifiutare esplicitamente l'implicito /Zc:preprocessor, usare: /Zc:preprocessor-

Per impostazione predefinita, il compilatore non produce un file oggetto quando viene compilata un'unità di intestazione. Per produrre un file oggetto, specificare l'opzione del /Fo compilatore. Per altre informazioni, vedere (Nome file oggetto).For more information, see /Fo (Object File Name).

Può risultare utile usare l'opzione /showResolvedHeadercomplementare . L'opzione /showResolvedHeader stampa un percorso assoluto nel file in cui l'argomento header-name viene risolto.

/exportHeader può gestire più input contemporaneamente, anche in /MP. È consigliabile usare /ifcOutput <directory> per creare un file separato .ifc per ogni compilazione.

Esempi

Per creare un'unità di intestazione, <vector> ad esempio, potrebbe essere simile alla seguente:

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

La compilazione di un'intestazione di progetto locale, ad esempio "utils/util.h" , potrebbe essere simile alla seguente:

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

Per impostare l'opzione del compilatore nell'ambiente di sviluppo di Visual Studio

In genere non è consigliabile impostare questa opzione nell'ambiente di sviluppo di Visual Studio, a meno che non si usi un'estensione diversa per i file di intestazione. Per impostazione predefinita, il sistema di compilazione applica questa opzione ai file compilati con estensione .h o senza estensione.

  1. Per applicare l'opzione /exportHeader a un file in modo esplicito nell'IDE, selezionare il file in Esplora soluzioni. Fare clic con il pulsante destro del mouse per aprire il menu di scelta rapida e scegliere Proprietà per aprire la finestra di dialogo Pagine delle proprietà.

  2. Impostare l'elenco a discesa Configurazione su Tutte le configurazioni. Impostare l'elenco a discesa Piattaforma su Tutte le piattaforme.

  3. Aprire la pagina delle proprietà Proprietà>di configurazione C/C++>Advanced.

  4. Usare il controllo a discesa per modificare la proprietà Compile As in Compile as (/exportHeader) in Compilazione come unità di intestazione C++. Scegliere OK o Applica per salvare le modifiche.

Vedi anche

/headerName (Creare un'unità di intestazione dall'intestazione specificata)
/headerUnit (Usare l'unità di intestazione IFC)
/reference (Usare il modulo denominato IFC)
/translateInclude (Tradurre direttive di inclusione in direttive import)