Discussão do artigo "Ordens, posições e negócios no MetaTrader 5"

[MetaQuotes]

Novo artigo Ordens, posições e negócios no MetaTrader 5 foi publicado:

A criação robusta de um robô de negócio não pode ser feita sem um entendimento dos mecanismos do sistema de negócio do MetaTrader 5. O terminal do cliente recebe as informações sobre as posições, ordens e negócios a partir do servidor de negócio. Para manipular estes dados adequadamente utilizando o MQL5, é necessário ter um bom entendimento da interação entre o programa MQL5 e o terminal do cliente.

Autor: MetaQuotes Software Corp.

[Francisco Carlos Sobral Ribeiro]

Sei que vocês não são mesmo de se preocupar com quem está começando na linguagem mql5, visto a comunidade forte que tem, apesar de muitas críticas, aqui vai mais uma:

A tradução e a própria redação do texto atrapalha o entendimento...suei, tive de ir longe para descobrir quem devia vir primeiro, visto que a própria documentação se contradiz, no texto:

• Histórico de ordens
  

  Para obter informações sobre uma ordem a partir do histórico, é necessário primeiro criar o cache de histórico de ordens usando uma das três funções: HistorySelect(start, end), HistorySelectByPosition() ou HistoryOrderSelect(ticket). Se a execução for bem sucedida, o cache irá armazenar o número de ordens, retornado pela função HistoryOrdersTotal(). O acesso às propriedades dessas ordens é realizado por cada um dos elementos no bilhete, utilizando a função apropriada:

1. HistoryOrderGetDouble(ticket_order, type_property)
2. HistoryOrderGetInteger(ticket_order, type_property)
3. HistoryOrderGetString(ticket_order, type_property)

Em contraponto com: https://www.mql5.com/pt/docs/trading/historyorderstotal abaixo transcrito.

HistoryOrdersTotal

Retorna o número de ordens no histórico. Antes de chamar HistoryOrdersTotal(), primeiro é necessário receber o histórico de negócios e ordens usando a função HistorySelect() ou a função HistorySelectByPosition().

int  HistoryOrdersTotal();

Valor do Retorno

Valor do tipo double.

Observação

Não confundir ordens de um histórico de negociação com as ordens pendentes que aparecem no separador "Comércio (Trade) da barra de "caixa de ferramentas" (Toolbox). A lista de ordens que foram cancelados ou levaram a uma transação, pode ser visto na aba "Histórico" da "caixa de ferramentas" do terminal do cliente.

Também Veja

No primeiro trecho se contradiz sozinho, não precisa de ajuda, mas o segundo vem e termina de complicar....: afinal, quem vem primeiro, HistoryOrdersTotal ou uma das três funções    HistorySelect(start, end) HistorySelectByPosition() ou HistoryOrderSelect(ticket), ou até mesmo a HistorySelectByPosition(), mencionada no segundo texto.

Foi difícil, poderia ser mais fácil...mas acho que em vem primeiro é uma das três  HistorySelect(start, end) HistorySelectByPosition() ou HistoryOrderSelect(ticket), ou até mesmo a HistorySelectByPosition(), mencionada no segundo texto...