Compartir a través de


/Yc (Crear archivo de encabezado precompilado)

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

/Yc[filename]

Argumentos

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

Comentarios

Si se especifica /Yc sin ningún argumento, el compilador compila todo el código hasta el final del archivo base de código fuente o hasta el punto del archivo base en el que aparece un hdrstop. El archivo .pch resultante tiene el mismo nombre base que el archivo base de código fuente, a menos que se especifique otro nombre mediante el 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 se puede utilizar la opción /Fp (Dar nombre al archivo .Pch) para especificar el nombre del archivo de encabezado precompilado.

Si utiliza /Ycfilename, el compilador compila todo el código hasta el archivo especificado (incluido), para uso subsiguiente con la opción /Yu.

Si las opciones /Ycfilename y /Yu (Utilizar el archivo de encabezado precompilado)filename aparecen en la misma línea de comandos y ambas hacen referencia o implican al mismo nombre de archivo, /Ycfilename tiene prioridad. Esta característica simplifica la creación de archivos MAKE.

Para obtener más información acerca de los encabezados precompilados, vea:

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

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

  2. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para obtener información detallada, vea Cómo: Abrir páginas de propiedades del proyecto.

  3. Haga clic en la carpeta C/C++.

  4. Haga clic en la página de propiedades Encabezados precompilados.

  5. Modifique la propiedad Crear o usar PCH a través de archivo o Crear o utilizar encabezado precompilado.

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

Ejemplo

Observe el código siguiente:

#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 correspondiente a AFXWIN.h, RESOURCE.h y MYAPP.h en un archivo de encabezado precompilado denominado MYAPP.pch.

Vea también

Referencia

Opciones del compilador

Establecer las opciones del compilador