Partilhar via


/exportHeader (Criar unidades de cabeçalho)

Diz 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

Arguments

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

Observações

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

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

Uma /exportHeader opção de compilador pode especificar quantos argumentos de nome de cabeçalho sua compilação exigir. Não é necessário especificá-los separadamente.

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

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

Pode ser útil utilizar a opção /showResolvedHeadercomplementar. A /showResolvedHeader opção imprime um caminho absoluto para o arquivo para o qual o header-name argumento resolve.

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

Examples

Para criar uma unidade de cabeçalho, como <vector> pode parecer:

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

Criando um cabeçalho de projeto local como "utils/util.h" pode se parecer com:

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

Para definir essa opção de 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 /exportHeader opção a 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 a lista suspensa Configuração como Todas as configurações. Defina a lista suspensa Plataforma como Todas as plataformas.

  3. Abra a página de propriedades Configuration Properties>C/C++>Advanced .

  4. Use o controle suspenso para modificar a propriedade Compile As para Compile as C++ Header Unit (/exportHeader). Escolha OK ou Aplicar para salvar as alterações.

Consulte também

/headerName (Crie uma unidade de cabeçalho a partir do cabeçalho especificado)
/headerUnit (Use a unidade de cabeçalho IFC)
/reference (Use o módulo nomeado IFC)
/translateInclude (Traduzir incluir diretivas em diretivas de importação)