Guia Técnico: Funções Init/Deinit no MQL5 – Como usar

Se você já tentou rodar um Expert Advisor (EA) no MetaTrader 5 e percebeu que ele “apaga” tudo ao fechar o gráfico, não está sozinho. A maioria dos programadores de MQL5 ignora que o ciclo de vida de um script começa em OnInit() e termina em OnDeinit(). Essa lacuna gera bugs difíceis de rastrear, como variáveis globais que permanecem “presas” ou recursos de rede que nunca são liberados. Entender como e quando usar essas funções não é só questão de boa prática; é o que separa um código que escala de um protótipo que trava na primeira negociação.

O buscador costuma responder a perguntas como “quando devo usar OnInit vs. constructor?” ou “como limpar objetos gráficos ao fechar o EA?”. A resposta passa por três pilares: inicialização determinística, liberação explícita de recursos e tratamento de eventos de desinstalação. Usuários avançados costumam questionar se é seguro chamar EventSetTimer() dentro de OnInit() ou se a ordem de destruição dos objetos afeta a performance. A realidade é que, embora o MQL5 ofereça automação, ele não protege contra vazamento de memória nem garante que objetos externos (APIs, arquivos) sejam fechados corretamente se o desenvolvedor não fechar o ciclo.

Este guia traz exemplos práticos – de um simples indicador que grava logs em arquivo até um EA que gerencia múltiplas posições – e destaca armadilhas comuns, como esquecer de ChartDelete() ou sobrescrever variáveis estáticas. Ao final, você saberá exatamente onde inserir seu código de limpeza e como evitar que o runtime do MetaTrader 5 consuma recursos desnecessários.

OnInit() e OnDeinit() são os pilares de controle de ciclo de vida de um Expert Advisor (EA) ou indicador no MQL5. Eles substituem o antigo init() e deinit() do MQL4, trazendo mais flexibilidade e tipagem forte. Cada chamada ocorre exatamente uma vez: OnInit() no carregamento do programa e OnDeinit() antes da sua remoção ou ao receber REASON_REMOVE, REASON_RECOMPILE etc.

1. Estrutura de retorno e tratamento de erros

Ambas as funções retornam um int que indica o sucesso da inicialização:

• INIT_SUCCEEDED (0) – prossegue para o loop de eventos.
• Qualquer outro código – aborta a carga e gera mensagem no log.

Um padrão robusto consiste em validar recursos críticos (handles, arquivos, objetos gráficos) e, caso falhe, liberar tudo antes de retornar um código de erro.

2. Gerenciamento de recursos – checklist rápido

• Handles de objetos gráficos: crie com ObjectCreate(), guarde o ID e destrua em OnDeinit() usando ObjectDelete().
• Handles de indicadores: iCustom(), iMA() etc. Armazene em variáveis globais e libere com IndicatorRelease().
• Arquivos: abra com FileOpen(), verifique FILE_HANDLE e feche em OnDeinit() via FileClose().
• Timers: EventSetTimer() no init e EventKillTimer() no deinit.
• Subscreve a eventos: EventSetMillisecondTimer() ou ChartEventSet() – desfazer no final.

3. Fluxograma simplificado de inicialização

4. Estratégias avançadas de finalização

Além de liberar recursos, OnDeinit() pode ser usado para:

• Persistir estado: gravar variáveis críticas em arquivo ou no GlobalVariableSet() para reutilização em uma nova sessão.
• Desativar alertas externos: desconectar de APIs, fechar sockets ou cancelar pedidos pendentes.
• Limpar objetos temporários: remover linhas, retângulos ou labels que não devem permanecer após a remoção do EA.

5. Erros comuns e como evitá‑los

• Esquecer de liberar handles – gera vazamento de memória e limites de objetos excedidos.
• Retornar INIT_SUCCEEDED prematuramente – o EA pode operar sem recursos essenciais, provocando falhas em OnTick().
• Usar objetos globais sem inicializar – cause “null pointer” e mensagens de erro “invalid handle”.
• Não tratar REASON_RECOMPILE – ao recompilar, o EA é reinicializado; liberar antes impede “ghost objects”.

6. Aplicação prática: EA de breakout com timer de limpeza

O exemplo abaixo demonstra como combinar OnInit(), OnDeinit() e OnTimer() para criar um EA que marca zonas de breakout e limpa objetos antigos a cada 30 segundos.

int g_objBreakout; // handle do retângulo datetime g_lastClean = 0; // última limpeza int OnInit() { // 1. validação de parâmetros if(BreakoutPips<=0) return(INIT_PARAMETERS_INCORRECT); // 2. cria objeto visual g_objBreakout = ObjectCreate(0,"BreakoutZone",OBJ_RECTANGLE_LABEL,0,0,0); if(g_objBreakout==0) return(INIT_FAILED); ObjectSetInteger(0,"BreakoutZone",OBJPROP_COLOR,clrYellow); // 3. agenda timer EventSetTimer(30); // 30 segundos return(INIT_SUCCEEDED); } void OnDeinit(const int reason) { // liberação ordenada if(g_objBreakout!=0) ObjectDelete(0,"BreakoutZone"); EventKillTimer(); // persiste a última zona para análise posterior GlobalVariableSet("LastBreakoutTime",TimeCurrent()); } void OnTimer() { // limpa retângulos antigos > 5 minutos datetime now = TimeCurrent(); if(now - g_lastClean > 300) { ObjectsDeleteAll(0,OBJ_RECTANGLE_LABEL); g_lastClean = now; } } 

7. Comparativo rápido entre MQL4 e MQL5

8. Onde aprofundar

Para quem deseja dominar a arquitetura completa e ainda aprender a integrar APIs externas, o curso “MQL5 Mastery – Funções de Inicialização e Finalização” traz casos de uso reais, scripts de depuração avançada e templates prontos para produção.

Dominar OnInit() e OnDeinit() não é apenas “abrir/fechar”. É garantir que cada recurso, cada timer e cada objeto seja tratado com a mesma disciplina que um desenvolvedor de software tradicional aplica a memória e a conexão de rede. Quando o ciclo de vida está sob controle, o EA ganha estabilidade, performance previsível e mantém o terminal livre de “lixos” que comprometem a execução de múltiplas estratégias simultâneas.

Por que as funções de inicialização e finalização no MQL5 importam agora?

Se o seu robô ainda gira à toa sem limpar o estado, ele está desperdiçando recursos e, pior, abre brechas para erros imprevisíveis.

OnInit e OnDeinit são mais que “ganchos” de ciclo de vida; são pontos de sincronização entre o código, o servidor MetaTrader 5 e os feeds de mercado. Quando bem usados, reduzem a latência em até 30 % e evitam “memory leaks” que corroem o patrimônio do trader.

Alternativas populares ao padrão OnInit / OnDeinit

• EventSetTimer: agenda callbacks periódicos, mas delega a inicialização ao usuário.
• PreProcessorDefine: macro que cria blocos de configuração estática, útil em estratégias de alta frequência.
• FileOpen com FILE_WRITE|FILE_READ: persiste parâmetros, porém carece de descarte automático que OnDeinit oferece.

Comparação semântica: “Start” vs “OnInit”

O tradicional int start() execute a cada tick, mas não distingue entre o primeiro tick e os demais. OnInit, por outro lado, dispara uma única vez logo após o carregamento do EA, permitindo alocar buffers, registrar eventos e validar parâmetros. A semântica é análoga ao construtor de classe em C++ versus o método run() de uma thread.

Benchmarks de desempenho em cenários reais

Aplicações práticas que lucram com a limpeza correta

Estratégias de arbitragem de pares dependem de contexto estático: spreads, latência, alavancagem. Mantendo objetos de negociação em containers globais e destruindo‑os no OnDeinit, evita‑se “orders ghost” que são rejeitados pelo servidor e geram perdas silenciosas.

Indicadores customizados que geram buffers gráficos frequentemente criam “ghost lines” se não liberam a memória. O padrão de boas práticas recomenda IndicatorRelease() dentro de OnDeinit, e o ganho visual é imediato – nada de linhas que persistem inesperadamente ao mudar de timeframe.

Dúvidas recorrentes – respostas curtas

• Preciso chamar EventKillTimer() no OnDeinit? Sim, caso tenha usado EventSetTimer.
• OnInit falha, o EA ainda roda? Não. Retorne INIT_FAILED e o terminal descarrega o Expert.
• Posso abrir streams de sockets aqui? Sim, mas feche‑os em OnDeinit; o MT5 não limpa conexões automaticamente.

Entidades relacionadas que ampliam o ecossistema

Além dos próprios callbacks, vale observar:

• EnumTradeReturnCode: códigos de erro que podem ser interpretados melhor quando o estado é resetado em OnDeinit.
• ChartSetInteger e ChartRedraw: controlam visualizações que devem ser revertidas ao fechar o Expert.
• CTrade: wrapper de negociação que mantém objetos internos e recomenda destruição explícita.

Limitações práticas do segmento

O modelo de eventos do MQL5 ainda não suporta “hooks” assíncronos fora do ciclo de vida do Expert. Usuários que precisam de threading avançada acabam recorrendo a DLLs, aumentando a superfície de ataque e a complexidade de depuração.

Estratégias avançadas de inicialização

Combine OnInit com FileReadString() para carregar parâmetros de um JSON externo, depois valide‑os contra EnumParameterCheck. Essa abordagem cria “config‑as‑code” que pode ser versionado no Git e alterado sem recompilar.

Outra tática: use GlobalVariableSet() para persistir valores entre sessões e recupere‑os em OnInit, garantindo que a estratégia “lembre” o último preço de referência. Cuidado com a limpeza; reaplique GlobalVariableDel() no OnDeinit para não ocupar o banco de dados interno.

Callout editorial

Não subestime o poder de um único retorno de status em OnInit. Um INIT_PARAMETERS_INCORRECT impede o back‑test de gerar ruídos falsos, economizando horas de análise.

Quer aprofundar ainda mais? Acesse o curso completo