Encabezado precompilado

Microsoft Visual C++ (versión 6.0 y posteriores ) puede precompilar cualquier código, no solo los encabezados. ^{[ 1 ]} Puede hacerlo de dos maneras: precompilando todo el código hasta un archivo cuyo nombre coincida con la opción o (cuando se especifica sin ninguna ) precompilando todo el código hasta la primera aparición de en el código ^{[ 2 ] [ 3 ]} La salida precompilada se guarda en un archivo con el nombre dado a la opción, con una extensión, o en un archivo con el nombre proporcionado por la opción. ^{[ 3 ]} La opción, subordinada a la opción si se usan juntas, hace que el compilador utilice el código ya precompilado de dicho archivo. ^{[ 3 ]}/Ycfilename/Ycfilename#pragma hdrstopfilename/Yc.pch/Fpfilename/Yu/Yc

pch.h(nombrado stdafx.hantes de Visual Studio 2017 ^{[ 4 ]} ) es un archivo generado por el asistente del IDE de Microsoft Visual Studio , que describe archivos de inclusión estándar del sistema y específicos del proyecto que se usan con frecuencia pero que casi nunca cambian.

Las siglas afx corresponden stdafx.ha extensiones del marco de aplicación . AFX era la abreviatura original de Microsoft Foundation Classes (MFC). Si bien el nombre stdafx.h se usaba por defecto en los proyectos MSVC anteriores a la versión 2017, se puede especificar manualmente cualquier nombre alternativo.

Los compiladores compatibles precompilarán este archivo para reducir los tiempos de compilación generales. Visual C++ no compilará nada antes de la #include "pch.h"línea en el archivo fuente, a menos que la opción de compilación /Yu'pch.h'esté desactivada (por defecto); asume que todo el código fuente hasta esa línea inclusive ya está compilado.

GCC (versión 3.4 y posteriores) admite archivos de cabecera precompilados . Su enfoque es similar al de VC y compiladores compatibles. GCC guarda versiones precompiladas de los archivos de cabecera con el .gchsufijo " ". Al compilar un archivo fuente, el compilador comprueba si este archivo se encuentra en el mismo directorio y lo utiliza si es posible.

GCC solo puede usar la versión precompilada si se mantienen las mismas opciones de compilación que al compilar el archivo de cabecera, y solo puede usar una como máximo. Además, solo se pueden colocar instrucciones de preprocesador antes del archivo de cabecera precompilado (ya que este debe incluirse, directa o indirectamente, a través de otro archivo de cabecera normal, antes de cualquier código compilable).

GCC identifica automáticamente la mayoría de los archivos de cabecera por su extensión. Sin embargo, si esto falla (por ejemplo, debido a extensiones de cabecera no estándar), -xse puede usar el interruptor para asegurar que GCC trate el archivo como una cabecera.

El compilador Clang añadió soporte para PCH en Clang 2.5 / LLVM 2.5 de 2009. ^{[ 5 ]} El compilador tokeniza el código fuente de entrada y realiza análisis sintácticos y semánticos de los encabezados, escribiendo el árbol de sintaxis abstracta (AST) y la tabla de símbolos generados internamente por el compilador en un archivo de encabezado precompilado. ^{[ 6 ]}

El esquema de encabezados precompilados de clang, con algunas mejoras como la capacidad de que un encabezado precompilado haga referencia a otro encabezado precompilado de uso interno, también constituye la base de su mecanismo de módulos. ^{[ 6 ]} Utiliza el mismo formato de archivo de bitcode que emplea LLVM , encapsulado en secciones específicas de clang dentro de archivos Common Object File Format o Extensible Linking Format . ^{[ 6 ]}

En la configuración predeterminada del proyecto, el compilador C++Builder genera implícitamente encabezados precompilados para todos los encabezados incluidos por un módulo fuente hasta que #pragma hdrstopse encuentra la línea. ^{[ 7 ] : 76} Los encabezados precompilados se comparten para todos los módulos del proyecto si es posible. Por ejemplo, al trabajar con la Biblioteca de Componentes Visuales , es común incluir vcl.hprimero el encabezado que contiene la mayoría de los archivos de encabezado VCL de uso común. Por lo tanto, el encabezado precompilado se puede compartir entre todos los módulos del proyecto, lo que reduce drásticamente los tiempos de compilación.

Además, C++Builder puede configurarse para usar un archivo de encabezado específico como encabezado precompilado, de forma similar al mecanismo que proporciona Visual C++.

C++Builder 2009 introduce un "Asistente para encabezados precompilados" que analiza todos los módulos fuente del proyecto en busca de archivos de encabezado incluidos, los clasifica (es decir, excluye los archivos de encabezado si forman parte del proyecto o no tienen una directiva Include guard ) y genera y prueba automáticamente un encabezado precompilado para los archivos especificados.