/translateInclude

Este modificador indica al compilador que trate #include como import para los archivos de encabezado que se han integrado en archivos de unidad de encabezado (.ifc) y que se especifican en la línea de comandos con /headerUnit.

Cuando se usa con /scanDependencies o /sourceDependencies-directives, el compilador muestra como unidades de encabezado importadas en el archivo de dependencia generado esos encabezados que se incluyen en el origen y tienen una entrada correspondiente en un archivo header-units.json. El sistema de compilación usa esta información de dependencia para generar archivos .ifc de unidad de encabezado compilados. Una vez compiladas las unidades de encabezado, el compilador las trata como una directiva import en lugar de #include.

El archivo header-units.json solo se consulta cuando se especifica /translateInclude. Para más información sobre el formato y la finalidad del archivo header-units.json, consulte header-units.json.

Si un archivo #include no aparece en el archivo header-units.json, se trata como una directiva #include normal.

Para ver un ejemplo de cómo se usa este modificador, consulte Tutorial: Compilación e importación de unidades de encabezado en Microsoft Visual C++.

Sintaxis

/translateInclude

Comentarios

/translateInclude está disponible en Visual Studio 2019, versión 16.10 o posteriores.
/translateInclude requiere /std:c++20 o posterior.

Para establecer esta opción del compilador en Visual Studio

Para habilitar /translateInclude, en el cuadro de diálogo de propiedades del proyecto, establezca Traducir inclusiones en importaciones:

1. En el panel izquierdo de las páginas de propiedades del proyecto, seleccione Propiedades de configuración>C/C++>General.

2. Cambie la lista desplegable Traducir inclusiones en importaciones a Sí.

   

3. Haga clic en Aceptar o en Aplicar para guardar los cambios.

Consulte también

/headerUnit (Usar IFC de unidad de encabezado).
/exportHeader (creación de unidades de encabezado)
/reference (uso de IFC de módulo con nombre)
/scanDependencies
/sourceDependencies-directives
Tutorial: Compilación e importación de unidades de encabezado en Microsoft Visual C++