Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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).
Syntax
/exportHeader /headerName:angleheader-name
/exportHeader /headerName:quoteheader-name
/exportHeaderfull path to header file
Arguments
El argumento para /exportHeader es una /headerName opción de línea de comandos que especifica el nombre, header-name, del archivo de encabezado que se va a exportar.
Observaciones
/exportHeader está disponible a partir de la versión 16.10 de Visual Studio 2019.
La /exportHeader opción del compilador requiere habilitar la /std:c++20 opción del compilador o posterior (como /std:c++latest).
Una /exportHeader opción del compilador puede especificar tantos argumentos de nombre de encabezado como requiera la compilación. No es necesario especificarlos por separado.
El compilador habilita implícitamente el nuevo preprocesador cuando se usa esta opción. Es decir, /Zc:preprocessor el compilador agrega a la línea de comandos si se usa alguna forma de en la línea de /exportHeader comandos. Para no participar en el implícito /Zc:preprocessor, 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 /Fo opción del compilador. Para obtener más información, vea /Fo (Nombre de archivo de objeto).
Es posible que le resulte útil usar la opción /showResolvedHeadercomplementaria . La /showResolvedHeader opción imprime una ruta de acceso absoluta al archivo al que se resuelve el header-name argumento.
/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.
Examples
Para compilar una unidad de encabezado como <vector> podría ser similar a la siguiente:
cl . . . /std:c++latest /exportHeader /headerName:angle vector
Compilar un encabezado de proyecto local como "utils/util.h" podría ser similar al siguiente:
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.
Para aplicar la
/exportHeaderopción a un archivo explícitamente en el IDE, seleccione el archivo en el 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.Establezca la lista desplegable Configuración en Todas las configuraciones. Establezca la lista desplegable Plataforma en Todas las plataformas.
Abra la página de propiedades> De configuraciónC/C++>Advanced.
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 (Crear una unidad de encabezado a partir del encabezado especificado)
/headerUnit (Use el IFC de unidad de encabezado)
/reference (Use ifC del módulo con nombre)
/translateInclude (Traducir directivas include en directivas de importación)