/Yc (Crear archivo de encabezado precompilado)

  • Artículo

Indica al compilador que cree un archivo de encabezado precompilado (.pch) que represente el estado de la compilación en un momento determinado.

Sintaxis

/Yc
/Ycfilename

Argumentos

filename
Especifica un archivo de encabezado (.h). Cuando se usa este argumento, el compilador compila todo el código hasta el archivo .h incluido.

Comentarios

Cuando se especifica /Yc sin un argumento, el compilador compila todo el código hasta el final del archivo de origen base o hasta el punto del archivo base donde se produce una directiva hdrstop. El archivo .pch resultante tiene el mismo nombre base que el archivo de origen base a menos que especifique un nombre de archivo diferente mediante la pragma hdrstop o la opción /Fp.

El código precompilado se guarda en un archivo con un nombre creado a partir del nombre base del archivo especificado con la opción /Yc y una extensión .pch. También puede usar la opción /Fp (Nombre del archivo .Pch) para especificar un nombre del archivo de encabezado precompilado.

Si usa /Ycfilename, el compilador compila todo el código hasta el archivo especificado para su uso posterior con la opción /Yu (Usar archivo de encabezado precompilado).

Si las opciones /Ycfilename y /Yufilename se producen en la misma línea de comandos y en ambas referencias, o implican, el mismo nombre de archivo, /Ycfilename tiene prioridad. Esta característica simplifica la escritura de archivos Make.

Para obtener más información sobre los encabezados precompilados, consulte:

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

  1. Seleccione un archivo .cpp. El archivo .cpp debe #include el archivo .h que contiene la información de encabezado precompilado. El valor del proyecto /Yc se puede invalidar en el nivel de archivo.

  2. 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.

  3. Abra la página de propiedades Propiedades de configuración, C/C++, Encabezados precompilados.

  4. Modifique la propiedad Encabezado precompilado.

  5. Para establecer el nombre de archivo, modifique la propiedad Archivo de encabezado precompilado.

Para establecer esta opción del compilador mediante programación

Ejemplo

Observe el código siguiente:

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
// ...

Cuando este código se compila con el comando CL /YcMYAPP.H PROG.CPP, el compilador guarda todo el preprocesamiento para AFXWIN.h, RESOURCE.h y MYAPP.h en un archivo de encabezado precompilado llamado MYAPP.pch.

Consulte también

Opciones del compilador de MSVC
Sintaxis de la línea de comandos del compilador MSVC
Archivos de encabezado precompilados