Partilhar via


/headerUnit (Usar unidade de cabeçalho IFC)

Importa uma unidade de cabeçalho. Informa ao compilador onde localizar o arquivo .ifc (a representação binária da unidade de cabeçalho) para o cabeçalho especificado.

Sintaxe

/headerUnit header-filename=ifc-filename
/headerUnit:quote header-filename=ifc-filename
/headerUnit:angle header-filename=ifc-filename

Argumentos

header-filename
Durante import header-name; o compilador é resolvido em header-name para um arquivo no disco. Use header-filename para especificar esse arquivo. Depois de correspondido, o compilador abre o IFC correspondente nomeado para ifc-filename importação.

ifc-filename
O nome de um arquivo que contém informações de unidade de cabeçalho compiladas. Para importar mais de uma unidade de cabeçalho, adicione uma opção /headerUnit separada para cada arquivo.

Comentários

A opção /headerUnit do compilador requer /std:c++20 ou posterior.

A opção do compilador /headerUnit está disponível no Visual Studio 2019 versão 16.10 ou posterior.

Quando o compilador encontra import "file"; ou import <file>; esta opção do compilador ajuda o compilador a encontrar a unidade de cabeçalho compilada (.ifc) para o arquivo de cabeçalho especificado. O caminho para esse arquivo pode ser expresso destas maneiras:

  • /headerUnit pesquisa a unidade de cabeçalho compilada no diretório atual ou no local especificado por ifc-filename.

  • /headerUnit:quote pesquisa o arquivo de unidade de cabeçalho compilado usando as mesmas regras que #include "file".

  • /headerUnit:angle pesquisa o arquivo de unidade de cabeçalho compilado usando as mesmas regras que #include <file>.

O compilador não pode mapear um único header-name para vários arquivos .ifc. Você pode mapear vários header-name argumentos para um único .ifc. O conteúdo do .ifc é importado como se fosse apenas o cabeçalho especificado por header-name.

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

Se você desabilitar o novo pré-processador, mas um arquivo compilado importar uma unidade de cabeçalho, o compilador relatará um erro.

Exemplos

Dado um projeto que faz referência a dois arquivos de cabeçalho e suas unidades de cabeçalho, conforme listado nesta tabela:

Arquivo de cabeçalho Arquivo IFC
C:\utils\util.h C:\util.h.ifc
C:\app\app.h C:\app\app.h.ifc

As opções do compilador para referenciar as unidades de cabeçalho para esses arquivos de cabeçalho específicos teriam esta aparência:

cl ... /std:c++latest /headerUnit C:\utils\util.h=C:\util.h.ifc /headerUnit:quote app.h=app.h.ifc

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. Ela é definida pelo sistema de build.

Confira também

/exportHeader (Criar unidades de cabeçalho)
/headerName (Criar uma unidade de cabeçalho com base no cabeçalho especificado)
/reference (Use o módulo IFC nomeado)
/translateInclude (converter diretivas de inclusão em diretivas de importação)