DIRETIVAPublicado
#include
#include "<arquivo.ch>"Insere no ponto atual o conteúdo de um arquivo de cabeçalho localizado no caminho de includes da compilação.
Visão geral
#include é uma inclusão textual realizada pelo pré-processador. Arquivos .ch normalmente reúnem constantes, comandos, traduções e definições compartilhadas. Ele não equivale por completo a import ou a um sistema moderno de módulos: não carrega código dinamicamente nem cria isolamento de nomes.
Sintaxe
#include "<arquivo.ch>"Include básico conforme a necessidade
#include "TOTVS.ch"
User Function ExInclude()
MsgInfo("Fonte compilado com as definições necessárias")
ReturnResultado esperado
O pré-processador incorpora as definições do cabeçalho antes da compilação.
Include específico de framework
#include "TOTVS.ch"
#include "FWMVCDef.ch"
User Function ExMVCInclude()
// O segundo cabeçalho fornece símbolos próprios do Framework MVC.
ReturnResultado esperado
Cabeçalhos específicos devem ser adicionados apenas quando seus símbolos forem utilizados.
- Inclua somente arquivos realmente exigidos pelo fonte e pelo framework utilizado.
- Use o pacote de includes alinhado ao release, LIB e ambiente de compilação.
- TOTVS.ch, Protheus.ch e outros cabeçalhos possuem finalidades e conteúdos dependentes da versão; não presuma que todo fonte precise incluir ambos.
- Include ausente, duplicado ou incompatível pode gerar símbolos desconhecidos, redefinições ou comportamento divergente.
- Não copie arquivos .ch de ambientes aleatórios para resolver uma compilação; alinhe-os à versão oficial.
- Não trate #include como carregamento em execução: seu conteúdo participa da preparação do fonte.