Compartilhar via


/translateInclude

Essa opção instrui o compilador a tratar #include como import para arquivos de cabeçalho que foram incorporados em arquivos de unidade de cabeçalho (.ifc) e que são especificados na linha de comando com /headerUnit.

Quando usado com /scanDependencies ou /sourceDependencies-directives, o compilador lista como unidades de cabeçalho importadas no arquivo de dependência gerado esses cabeçalhos que estão incluídos na origem e têm uma entrada correspondente em um arquivo header-units.json. Essas informações de dependência são usadas pelo sistema de build para gerar arquivos .ifc de unidade de cabeçalho compilados. Depois que as unidades de cabeçalho são criadas, elas são tratadas pelo compilador como import em vez de #include.

O arquivo header-units.json só é consultado quando /translateInclude é especificado. Para mais informações sobre o formato e a finalidade do arquivo header-units.json, confira header-units.json.

Se um arquivo #include não estiver listado no arquivo header-units.json, ele será tratado como normal #include.

Para um exemplo de como essa opção é usada, confira Guia passo a passo: compilar e importar unidades de cabeçalho no Microsoft Visual C++.

Sintaxe

/translateInclude

Comentários

/translateInclude está disponível no Visual Studio 2019 versão 16.10 ou posterior.
/translateInclude requer /std:c++20 ou posterior.

Para definir essa opção do compilador no Visual Studio

Para habilitar /translateInclude, na caixa de diálogo propriedades do projeto, defina Converter inclusões em importações:

  1. No painel esquerdo das páginas de propriedades do projeto, selecione Propriedades de configuração>C/C++>Geral.

  2. Altere o menu suspenso Converter inclusões em Importações para Sim.

    Captura de tela da caixa de diálogo Páginas de Propriedade com a propriedade Converter inclusões em importações destacada.

  3. Escolha OK ou Aplicar para salvar as alterações.

Confira também

/headerUnit (Use IFC da unidade de cabeçalho).
/exportHeader (Criar unidades de cabeçalho)
/reference (Use o módulo IFC nomeado)
/scanDependencies
/sourceDependencies-directives
Passo a passo: Compilar e importar unidades de cabeçalho no Microsoft Visual C++