SeriesInfoInteger

Retorna informações sobre o estado de dados históricos. Existem 2 variantes de chamada da função.

Retorna diretamente o valor da propriedade.

long  SeriesInfoInteger(
   string                     symbol_name,     // nome do ativo
   ENUM_TIMEFRAMES            timeframe,       // período
   ENUM_SERIES_INFO_INTEGER   prop_id,         // identificador da propriedade
   );

Retorna true ou false dependendo do sucesso da execução da função.

bool  SeriesInfoInteger(
   string                     symbol_name,     // nome do ativo
   ENUM_TIMEFRAMES            timeframe,       // período
   ENUM_SERIES_INFO_INTEGER   prop_id,         // ID da propriedade
   long&                      long_var         // variável a informação obtida
   );

Parâmetros

symbol_name

[in]  Nome do ativo.

timeframe

[in]  Período.

prop_id

[in]  Identificador da propriedade solicitada, valor da enumeração ENUM_SERIES_INFO_INTEGER.

long_var

[out]  Variável para onde o valor da propriedade solicitada é colocado.

Valor do Retorno

No primeiro caso, ela retorna valor do tipo long.

Para o segundo caso, ela retorna true, se a propriedade especificada estiver disponível e seu valor é colocada na variável long_var, caso contrário ela returna false. Para mais detalhes sobre um erro, chame a função GetLastError().

Exemplo:

void OnStart()
  {
//---
   Print("Total number of bars for the symbol-period at this moment = ",
         SeriesInfoInteger(Symbol(),Period(),SERIES_BARS_COUNT));
 
   Print("The first date for the symbol-period at this moment = ",
         (datetime)SeriesInfoInteger(Symbol(),Period(),SERIES_FIRSTDATE));
 
   Print("The first date in the history for the symbol-period on the server = ",
         (datetime)SeriesInfoInteger(Symbol(),Period(),SERIES_SERVER_FIRSTDATE));
 
   Print("Symbol data are synchronized = ",
         (bool)SeriesInfoInteger(Symbol(),Period(),SERIES_SYNCHRONIZED));
  }