/exportHeader (Crear unidades de encabezado)

  • Artículo

Indica al compilador que cree las unidades de encabezado especificadas por los argumentos de entrada. El compilador genera unidades de encabezado como archivos IFC (.ifc).

Sintaxis

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Argumentos

El argumento para /exportHeader es una opción de línea de comandos /headerName que especifica el nombre, header-name, del archivo de encabezado que se va a exportar.

Comentarios

/exportHeader está disponible a partir de la versión 16.10 de Visual Studio 2019.

La opción /exportHeader del compilador requiere habilitar la opción /std:c++20 del compilador o una posterior (como /std:c++latest).

Una opción del compilador /exportHeader puede especificar tantos argumentos de nombre de encabezado como requiera la compilación. No es necesario especificarlos por separado.

El compilador habilita de forma implícita el nuevo preprocesador cuando se usa esta opción. Es decir, el compilador agrega /Zc:preprocessor a la línea de comandos si se usa alguna forma de /exportHeader en la línea de comandos. Para inhabilitar el /Zc:preprocessor implícito, use: /Zc:preprocessor-

De forma predeterminada, el compilador no genera un archivo de objeto cuando se compila una unidad de encabezado. Para generar un archivo de objeto, especifique la opción /Fo del compilador. Para obtener más información, vea /Fo(Nombre del archivo objeto).

Es posible que le resulte útil usar la opción complementaria /showResolvedHeader. La opción /showResolvedHeader imprime una ruta de acceso absoluta al archivo en el que se resuelve el argumento header-name.

/exportHeader puede controlar varias entradas a la vez, incluso en /MP. Se recomienda usar /ifcOutput <directory> para crear un archivo independiente .ifc para cada compilación.

Ejemplos

Para compilar una unidad de encabezado como <vector>:

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

La creación de un encabezado de proyecto local, como "utils/util.h", podría ser algo parecido a esto:

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

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

Normalmente no debe establecer esta opción en el entorno de desarrollo de Visual Studio a menos que use una extensión diferente para los archivos de encabezado. De forma predeterminada, el sistema de compilación aplica esta opción a los archivos compilados que tienen una .h extensión o ninguna extensión.

  1. Para aplicar la /exportHeader opción a un archivo explícitamente en el IDE, seleccione el archivo en Explorador de soluciones. Haga clic con el botón derecho para abrir el menú contextual y seleccione Propiedades para abrir el cuadro de diálogo Páginas de propiedades.

  2. Establezca la lista desplegable Configuración en Todas las configuraciones. Establezca la lista desplegable Plataforma en Todas las plataformas.

  3. Abra la página de propiedades>De configuración C/C++>Advanced.

  4. Use el control desplegable para modificar la propiedad Compilar como para compilar como unidad de encabezado de C++ (/exportHeader). Haga clic en Aceptar o en Aplicar para guardar los cambios.

Consulte también

/headerName (Creación de una unidad de encabezado a partir del encabezado especificado)
/headerUnit (uso de IFC de unidad de encabezado)
/reference (uso de IFC de módulo con nombre)
/translateInclude (traducción de directivas include a directivas import)