Skip to content
Documentation
MQL5 Reference
Timeseries and Indicators Access
iHighest

iHighest

iHighest

Returns the index of the highest value found on the corresponding chart (shift relative to the current bar).

int  iHighest(
   const string        symbol,              // Symbol
   ENUM_TIMEFRAMES     timeframe,           // Period
   ENUM_SERIESMODE     type,                // Timeseries identifier
   int                 count=WHOLE_ARRAY,   // Number of elements
   int                 start=0              // Index
  );

Parameters

symbol

[in] The symbol, on which the search will be performed. NULL means the current symbol.

timeframe

[in] Period. It can be one of the values of the ENUM_TIMEFRAMES enumeration. 0 means the current chart period.

type

[in] The identifier of the timeseries, in which the search will be performed. Can be equal to any value from ENUM_SERIESMODE.

count=WHOLE_ARRAY

[in] The number of elements in the timeseries (from the current bar towards index increasing direction), among which the search should be performed.

start=0

[in] The index (shift relative to the current bar) of the initial bar, from which search for the highest value begins. Negative values ​​are ignored and replaced with a zero value.

Return Value

The index of the highest value found on the corresponding chart (shift relative to the current bar) or -1 in case of an error. For error details, call the GetLastError() function.

Example:

double val;
//--- Calculation of the highest Close value among 20 consecutive bars
//--- From index 4 to index 23 inclusive, on the current timeframe
   int val_index=iHighest(NULL,0,MODE_CLOSE,20,4);
   if(val_index!=-1)
      val=High[val_index];
   else
      PrintFormat("iHighest() call error. Error code=%d",GetLastError());
Last updated on
iHighiLow