Compartilhar via


Diretiva de pré-processador #PreCompiled

#PreCompiled:  BOOL

A diretiva #PreCompiled especifica se um arquivo de origem é pré-compilado.

Se BOOL for TRUE, o arquivo de origem será considerado pré-compilado. Caso contrário, se o arquivo de origem for referenciado por meio de uma diretiva #Include , o arquivo será incluído na linha.

A diretiva #PreCompiled deve aparecer antes de qualquer diretiva de #Include em um arquivo de origem GDL; caso contrário, ele será ignorado. O valor BOOL é necessário.

Os arquivos marcados como pré-compilados serão analisados em um contexto raiz. Ou seja, qualquer contexto estabelecido pelo host ou incluindo arquivos GDL será perdido. Por exemplo, se o arquivo GDL do host definisse símbolos de pré-processador antes de incluir o arquivo pré-compilado, esses símbolos não existiriam quando o arquivo pré-compilado fosse analisado. Esse tipo de análise garante que várias versões de um arquivo pré-compilado não possam ser criadas usando #Ifdef blocos e que hosts diferentes definam símbolos diferentes para acessar os vários blocos de #Ifdef. Como o arquivo pré-compilado nunca é reparsado, haverá apenas uma versão exclusiva. Portanto, o gravador de um arquivo pré-compilado não deve depender de nenhum símbolo de pré-processador definido externamente.

Observe também que os arquivos pré-compilados devem ser exclusivos e devem ser independentes do host que os inclui. Os arquivos pré-compilados não dependem de nenhum conteúdo incluído que o arquivo host referencia ou qualquer conteúdo que possa ser definido no arquivo de host.

Essa diretiva de pré-processador é nova para GDL.