Condividi tramite


/headerName (Creare un'unità di intestazione dall'intestazione specificata)

Compilare il file di intestazione specificato in un'unità di intestazione (.ifc file).

Sintassi

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

Argomenti

header-filename
Nome di un file di intestazione che il compilatore deve compilare in un'unità di intestazione (.ifc file).

Osservazioni:

Le opzioni del /headerName:quote compilatore e /headerName:angle sono disponibili a partire da Visual Studio 2019 versione 16.10.

Le opzioni del /headerName compilatore, in tutti i moduli, richiedono l'opzione /std:c++20 del compilatore o versione successiva ,ad esempio /std:c++latest.
Se si specifica un'opzione /headerName , è necessario specificare /exportHeaderanche .

  • /headerName:quote cerca header-filename usando le stesse regole #include "header-filename" di e la compila come unità di intestazione (.ifc file).
  • /headerName:angle cerca header-filename usando le stesse regole #include <header-filename> di e la compila come unità di intestazione (.ifc file).

Per altre informazioni sulle regole di ricerca dei percorsi per i file inclusi tra virgolette o parentesi angolari, vedere #include direttiva.

Esempi

Dato un progetto che fa riferimento a un file di intestazione definito, m.hl'opzione del compilatore per compilarla in un'unità di intestazione è simile all'esempio seguente:

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

Le /headerName:quote opzioni e /headerName:angle fungono da flag e non richiedono un argomento. Gli esempi seguenti sono validi:

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

È possibile specificare più /headerName opzioni nella stessa riga di comando. Ogni argomento dopo l'elaborazione di un'opzione /headerName con le regole di ricerca di file di inclusione specificate per virgolette o parentesi angolari fino all'opzione successiva /headerName . Nell'esempio seguente vengono elaborate tutte le intestazioni come i due esempi della riga di comando precedenti nello stesso modo di prima. Cerca le intestazioni usando le regole di ricerca applicate come se fossero state specificate come: #include <vector>, #include <iostream>, #include "my-utilties.h"#include <algorithm>, e #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

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

Nota

In genere non è consigliabile impostare questa opzione nell'ambiente di sviluppo di Visual Studio. Viene impostato dal sistema di compilazione.

  1. Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per informazioni dettagliate, vedere Impostare il compilatore e le proprietà di compilazione.

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

  3. Selezionare la pagina delle proprietà Proprietà di configurazione>C/C++>Riga di comando.

  4. Modificare la proprietà Opzioni aggiuntive per aggiungere le /headerName:quote opzioni o /headerName:angle e i nomi file dell'intestazione a cui si applicano le opzioni. Scegliere quindi OK o Applica per salvare le modifiche.

Vedi anche

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