/headerName (Compilar uma unidade de cabeçalho com base no cabeçalho especificado)

Crie o arquivo de cabeçalho especificado em uma unidade de cabeçalho (arquivo .ifc).

Sintaxe

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

Argumentos

header-filename
O nome de um arquivo de cabeçalho que o compilador deve compilar em uma unidade de cabeçalho (arquivo .ifc).

Comentários

As /headerName:quote opções do compilador e /headerName:angle estão disponíveis a partir do Visual Studio 2019 versão 16.10.

As /headerName opções do compilador, em todas as suas formas, exigem a /std:c++20 opção do compilador ou posterior (como /std:c++latest).
Se você especificar uma /headerName opção, também deverá especificar /exportHeader.

• /headerName:quote pesquisa header-filename usando as mesmas regras que #include "header-filename" e compila-as como uma unidade de cabeçalho (arquivo .ifc).
• /headerName:angle pesquisa header-filename usando as mesmas regras que #include <header-filename> e compila-as como uma unidade de cabeçalho (arquivo .ifc).

Para obter mais informações sobre as regras de pesquisa de caminho para arquivos incluídos entre aspas ou colchetes angulares, consulte #include diretiva.

Exemplos

Dado um projeto que faz referência a um arquivo de cabeçalho que ele define chamado m.h, a opção do compilador para compilá-lo em uma unidade de cabeçalho é semelhante a este exemplo:

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

As /headerName:quote opções e /headerName:angle agem como um sinalizador e não precisam de um argumento. Os seguintes exemplos são válidos:

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

Você pode especificar várias /headerName opções na mesma linha de comando. Cada argumento após uma /headerName opção é processado com as regras de pesquisa de arquivo de inclusão especificadas para aspas ou colchetes angulares até a próxima /headerName opção. O exemplo a seguir processa todos os cabeçalhos como os dois exemplos de linha de comando anteriores da mesma maneira que antes. Ele procura os cabeçalhos usando as regras de pesquisa aplicadas como se tivessem sido especificados como: #include <vector>, #include <iostream>, #include <algorithm>, #include "my-utilties.h", 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

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

Observação

Normalmente, você não deve definir essa opção no ambiente de desenvolvimento do Visual Studio. Ela é definida pelo sistema de build.

1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

2. Defina o menu suspenso Configuração como Todas as Configurações. Defina a lista suspensa Plataforma como Todas as plataformas.

3. Selecione a página de propriedades Propriedades de Configuração>C/C++>Linha de Comando.

4. Modifique a propriedade Opções Adicionais para adicionar as /headerName:quote opções ou /headerName:angle e os nomes de arquivo de cabeçalho aos quais as opções se aplicam. Depois, escolha OK ou Aplicar para salvar as alterações.

Confira também

/exportHeader (Criar unidades de cabeçalho)
/headerUnit (Usar IFC da unidade de cabeçalho)
/reference (Use o módulo IFC nomeado)
/translateInclude (converter diretivas de inclusão em diretivas de importação)