/headerName (Crear una unidad de encabezado a partir del encabezado especificado)

Compile el archivo de encabezado especificado en una unidad de encabezado (archivo .ifc).

Sintaxis

/headerName:quote header-filename
/headerName:angle header-filename

Argumentos

header-filename
Nombre de un archivo de encabezado que el compilador debe compilar en una unidad de encabezado (archivo .ifc).

Comentarios

Las /headerName:quote opciones del compilador y /headerName:angle están disponibles a partir de la versión 16.10 de Visual Studio 2019.

Las /headerName opciones del compilador, en todos sus formularios, requieren la /std:c++20 opción del compilador o posterior (como /std:c++latest).
Si especifica una /headerName opción, también debe especificar /exportHeader.

• /headerName:quote busca header-filename con las mismas reglas que #include "header-filename" y la compila como una unidad de encabezado (archivo .ifc).
• /headerName:angle busca header-filename con las mismas reglas que #include <header-filename> y la compila como una unidad de encabezado (archivo .ifc).

Para obtener más información sobre las reglas de búsqueda de rutas de acceso para archivos incluidos entre comillas o corchetes angulares, consulte #include la directiva .

Ejemplos

Dado un proyecto que hace referencia a un archivo de encabezado que define, m.hla opción del compilador para compilarlo en una unidad de encabezado tiene un aspecto similar al de este ejemplo:

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

Las /headerName:quote opciones y /headerName:angle actúan como una marca y no necesitan un argumento. Son válidos los siguientes ejemplos:

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Puede especificar varias /headerName opciones en la misma línea de comandos. Cada argumento después de procesar una /headerName opción con las reglas de búsqueda de archivos de inclusión especificadas para comillas o corchetes angulares hasta la siguiente /headerName opción. En el ejemplo siguiente se procesan todos los encabezados como los ejemplos de línea de comandos anteriores de la misma manera que antes. Busca los encabezados mediante las reglas de búsqueda aplicadas como si se hubieran especificado como: #include <vector>, #include <iostream>, #include <algorithm>, , #include "my-utilties.h"y #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

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

Nota:

Normalmente no debe establecer esta opción en el entorno de desarrollo de Visual Studio. La establece el sistema de compilación.

1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

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

3. Seleccione la página de propiedades Propiedades de configuración>C/C++>Línea de comandos.

4. Modifique la propiedad Opciones adicionales para agregar las /headerName:quote opciones o /headerName:angle y los nombres de archivo de encabezado a los que se aplican las opciones. A continuación, haga clic en Aceptar o en Aplicar para guardar los cambios.

Consulte también

/exportHeader (creación de unidades de encabezado)
/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)