/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:
En el panel izquierdo de las páginas de propiedades del proyecto, seleccione Propiedades de configuración>C/C++>General.
Cambie la lista desplegable Traducir inclusiones en importaciones a Sí.
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++