#pragma hdrstop

A seguir, encontramos a seguinte linha de códigos:

#pragma hdrstop

Através da diretiva #pragma, o C++Builder pode definir diretivas que podem ser passadas ao compilador. Se o compilador não identificar o nome da diretiva, ele simplesmente ignora #pragma sem emitir qualquer aviso ou mensagem de ERRO. A sintaxe de pragma é #pragma nome_da_diretiva.

O compilador C++Builder suporta as seguintes diretivas #pragma:

#pragma alignment

#pragma anon_struct

#pragma argsused

#pragma checkoption

#pragma codeseg

#pragma comment

#pragma defineonoption

#pragma exit

#pragma hdrfile

#pragma hdrstop

#pragma inline

#pragma intrinsic

#pragma link

#pragma message

#pragma nopushoptwarn

#pragma obsolete

#pragma option

#pragma pack

#pragma package

#pragma resource

#pragma startup

#pragma undefineonoption

#pragma warn

Sintaxe: #pragma hdrstop

Descrição: Esta diretiva termina a lista de hearde files escolhidos para pré-compilação. Você pode usá-lo para reduzir a quantia de espaço em disco usados por headers de pré-compilação.

Hearder files pré-compilados podem ser compartilhados entre os arquivos fonte de seu projeto sendo que somente as diretivas #include antes de #pragma hdrstop são idênticas (comuns a todos os arquivos do projeto). Então, você adquire o melhor desempenho do seu compilador se você incluir os header files comuns de seu projeto antes de #pragma hdrstop, e os específicos depois disto. Certifique-se de ter inserido as diretivas #include antes de #pragma hdrstop de forma indêntica em todo o código fonte, ou que haja apenas pequenas variações.

O ambiente de desenvolvimento integrado gera o código para aumentar desempenho de header pré-compilados. Por exemplo, depois de uma Aplicação Nova, o arquivo fonte " Unit1.cpp" terá a seguinte aparência (comentários adicionados):

#include <vcl.h> // arquivos de header comuns

#pragma hdrstop // fim da lista comum

#include "Unit1.h" // header files específicos

// ....

Só se usa essa diretiva pragma em arquivos fonte. Ela não tem nenhum efeito quando usada em um arquivo header (.h, .hpp etc).