Share via


hdrstop

Proporciona un control adicional sobre los nombres de archivo de la precompilación y sobre la ubicación en la que se guarda el estado de la compilación.

#pragma hdrstop [( "filename" )]  

Comentarios

El nombre de archivo es el nombre del archivo de encabezado precompilado a utilizar o crear (dependiendo de si /Yu o /Yc está especificado).Si el nombre de archivo no contiene una especificación de ruta, el archivo de encabezado precompilado se asume que está en el mismo directorio que el archivo de código fuente.

Si el C. o archivo de C++ contiene un pragma de hdrstop cuando se compila con /Yc, el compilador guarda el estado de la compilación hasta la ubicación de pragma.No guardan estado integrada de ningún código que siga el pragma.

Utilice el nombre de archivo para llamar al archivo de encabezado precompilado en el que se guarda el estado compilada.un espacio entre hdrstop y el nombre de archivo es opcional.El nombre de archivo especificado en pragma de hdrstop es una cadena y es por consiguiente en las restricciones de cualquier cadena de c o C++.En particular, debe encerrarla entre comillas y utilizar el carácter de escape (barra diagonal inversa) para especificar nombres de directorio.Por ejemplo:

#pragma hdrstop( "c:\\projects\\include\\myinc.pch" )

El nombre del archivo de encabezado precompilado se determina según las reglas siguientes, en orden de prioridad:

  1. El argumento de la opción del compilador /Fp

  2. El argumento del nombre de archivo a #pragma hdrstop

  3. El nombre base del archivo de código fuente con una extensión de .PCH

Para las opciones /Yc y /Yu, si ni de las dos opciones de compilación ni de pragma de hdrstop especifica un nombre de archivo, el nombre base del archivo de código fuente se utiliza como el nombre base del archivo de encabezado precompilado.

También puede utilizar los comandos de preprocesamiento de realizar el reemplazo macro como sigue:

#define INCLUDE_PATH "c:\\progra~`1\\devstsu~1\\vc\\include\\"
#define PCH_FNAME "PROG.PCH"
.
.
.
#pragma hdrstop( INCLUDE_PATH PCH_FNAME )

Las siguientes reglas rigen donde el pragma de hdrstop puede estar:

  • Debe aparecer fuera de los datos o declaración de función o definición.

  • Debe especificarse en el archivo de código fuente, no en un archivo de encabezado.

Ejemplo

#include <windows.h>                 // Include several files
#include "myhdr.h"

__inline Disp( char *szToDisplay )   // Define an inline function
{
    ...                              // Some code to display string
}
#pragma hdrstop

En este ejemplo, el pragma de hdrstop se produce después de que se hayan incluido dos archivos y una función inline se ha definido.Esto puede, tener el principio ser una posición impar para el pragma.Observe, sin embargo, ese utilizar las opciones manuales de precompilación, /Yc y /Yu, con pragma de hdrstop permite que se precompile los archivos de código fuente completo (incluso el código insertado.El compilador de Microsoft no está restringido a precompilar sólo las declaraciones de datos.

Vea también

Referencia

Directivas de pragma y la palabra clave de __Pragma