Compartilhar via

/exportHeader (Criar unidades de cabeçalho)

  • Artigo

Informa ao compilador para criar as unidades de cabeçalho especificadas pelos argumentos de entrada. O compilador gera unidades de cabeçalho como arquivos IFC (.ifc).

Sintaxe

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

Argumentos

O argumento para /exportHeader é uma opção de linha de comando /headerName que especifica o nome, header-name, do arquivo de cabeçalho a ser exportado.

Comentários

/exportHeader está disponível a partir do Visual Studio 2019 versão 16.10.

A opção do compilador /exportHeader exige que você habilite a opção do compilador /std:c++20 ou posterior (como /std:c++latest).

Uma opção do compilador /exportHeader pode especificar tantos argumentos de nome de cabeçalho quantos forem necessários em seu build. Você não precisa especificá-los separadamente.

O compilador habilita implicitamente o novo pré-processador quando essa opção é usada. Ou seja, /Zc:preprocessor será adicionado à linha de comando pelo compilador se qualquer forma de /exportHeader for usada na linha de comando. Para recusar o uso de /Zc:preprocessor implícito, use: /Zc:preprocessor-

Por padrão, o compilador não produz um arquivo-objeto quando uma unidade de cabeçalho é compilada. Para produzir um arquivo-objeto, especifique a opção do compilador /Fo. Para obter mais informações, confira /Fo (Nome do arquivo-objeto).

Você pode achar útil usar a opção complementar /showResolvedHeader. A opção /showResolvedHeader imprime um caminho absoluto no arquivo no qual o argumento header-name é resolvido.

/exportHeader pode lidar com várias entradas ao mesmo tempo, mesmo em /MP. Recomendamos que você use /ifcOutput <directory> para criar um arquivo .ifc separado para cada compilação.

Exemplos

A criação de uma unidade de cabeçalho, como <vector>, deverá ter essa aparência:

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

A criação de um cabeçalho de projeto local, como "utils/util.h", poderá parecer:

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

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

Normalmente, você não deve definir essa opção no ambiente de desenvolvimento do Visual Studio, a menos que use uma extensão diferente para seus arquivos de cabeçalho. Por padrão, o sistema de compilação aplica essa opção a arquivos compilados que têm uma .h extensão ou nenhuma extensão.

  1. Para aplicar a opção a /exportHeader um arquivo explicitamente no IDE, selecione o arquivo no Gerenciador de Soluções. Clique com o botão direito do mouse para abrir o menu de contexto e selecione Propriedades para abrir a caixa de diálogo Páginas de propriedades.

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

  3. Abra a página de propriedades C/C++>Advanced das Propriedades>de Configuração.

  4. Use o controle suspenso para modificar a propriedade Compile As para Compilar como Unidade de Cabeçalho C++ (/exportHeader). Escolha OK ou Aplicar para salvar as alterações.

Confira também

/headerName (Compilar uma unidade de cabeçalho com base no cabeçalho especificado)
/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)