Referência MQL5Símbolos personalizadosCustomRatesReplace

CustomRatesReplace

Substitui todo o histórico de preço do instrumento personalizado pelos dados na matriz do tipo MqlRates, no intervalo de tempo definido.

int  CustomRatesReplace(
   const string     symbol,             // nome do símbolo
   datetime         from,               // a partir de qual data
   datetime         to,                 // até qual data
   const MqlRates&  rates[],            // matriz com dados que é necessário aplicar ao instrumento personalizado
   uint             count=WHOLE_ARRAY   // número de elementos a serem usados na matriz rates[]
   );

Parâmetros

symbol

[in] Nome do instrumento personalizado.

from

[in] Tempo da primeira barra no histórico de preço, na faixa definida a ser atualizada.

[in] Tempo da última barra no histórico de preço, na faixa definida a ser atualizada.

rates[]

[in] Matriz de dados históricos do tipo MqlRates para o período M1.

count=WHOLE_ARRAY

[in] Número de elementos da matriz rates[] a serem usados para substituição. O valor WHOLE_ARRAY indica que para substituição é necessário usar todos os elementos da matriz rates[].

Valor de retorno

Número de barras atualizadas ou -1 em caso de erro.

Geral

Se a barra na matriz rates[] ficar fora do intervalo definido, ela será ignorada. Se essa barra existir no histórico de preço e ficar dentro do intervalo definido, ela será substituída. Todas as outras barras - no histórico de preço atual - fora do intervalo definido permanecem inalteradas. Os dados da matriz rates[] devem estar corretas em relação aos preços OHLC, enquanto o tempo de abertura de barras deve corresponder ao período M1.

Veja também

CustomRatesDelete, CustomRatesUpdate, CopyRates

CustomRatesDelete

CustomRatesUpdate