/Yc (Crear archivo de encabezado precompilado)
Actualización: noviembre 2007
Indica al compilador que cree un archivo de encabezado precompilado (.pch) que represente el estado de compilación en un instante 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
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.
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.
Haga clic en la carpeta C/C++.
Haga clic en la página de propiedades Encabezados precompilados.
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.