MetaQuotes Software Corp. Справочник по языку MQL4

Подождите немного. Документ загружается.

211

total -

Количество элементов для вычисления. 0 означает все элементы

массива.

period

Период усреднения для вычисления индекса.

shift -

Индекс получаемого значения из индикаторного буфера (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

if(iRSIOnArray(ExtBuffer,1000,14,0)>iRSI(NULL,0,14,PRICE_CLOSE,1))

return(0);

18.33 iRVI

double

iRVI(

string symbol, int timeframe, int period, int mode,

int shift)

Расчет Relative Vigor Index.

Параметры:

symbol -

Символьное имя инструмента, на данных которого будет

вычисляться индикатор. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

period -

Период усреднения для вычисления индекса.

mode -

Индекс линии индикатора. Может быть любым из значений

идентификаторов линии индикаторов.

shift -

Индекс получаемого значения из индикаторного буфера (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

double val=iRVI(NULL, 0, 10,MODE_MAIN,0);

18.34 iStdDev

double

iStdDev(

string symbol, int timeframe, int ma_period,

int ma_shift, int ma_method, int applied_price,

212

int shift)

Расчет индикатора Standard Deviation.

Параметры:

symbol -

Символьное имя инструмента, на данных которого будет

вычисляться индикатор. NULL означает текущий символ.

timeframe -

Период. Может быть одним из периодов графика. 0

означает период текущего графика.

ma_period -

Период усреднения для вычисления индикатора.

ma_shift -

Сдвиг индикатора относительно ценового графика.

ma_method -

Метод усреднения. Может быть любым из значений методов

скользящего среднего (Moving Average).

applied_price

Используемая цена. Может быть любой из ценовых

констант.

shift -

Индекс получаемого значения из индикаторного буфера

(сдвиг относительно текущего бара на указанное количество

периодов назад).

Пример:

double val=iStdDev(NULL,0,10,0,MODE_EMA,PRICE_CLOSE,0);

18.35 iStdDevOnArray

double

iStdDevOnArray(

double array[], int total, int ma_period,

int ma_shift, int ma_method, int shift)

Расчет индикатора Standard Deviation на данных, хранящихся в массиве. В отличие от

iStdDev(...) функция iStdDevOnArray не выбирает данные на основе названия

инструмента, таймфрейма и используемой цены - ценовые данные должны быть

подготовлены заранее. Расчет производится слева направо. Для организации доступа к

элементам массива, как к таймсерии (то есть справа налево), необходимо использовать

функцию ArraySetAsSeries

Параметры:

array[] -

Массив с данными.

total -

Количество элементов для вычисления. 0 означает все

213

элементы массива.

ma_period -

Период усреднения для вычисления индикатора.

ma_shift -

Сдвиг индикатора относительно ценового графика.

ma_method

Метод усреднения. Может быть любым из значений методов

скользящего среднего (Moving Average).

shift -

Индекс получаемого значения из индикаторного буфера

(сдвиг относительно текущего бара на указанное количество

периодов назад).

Пример:

double val=iStdDevOnArray(ExtBuffer,100,10,0,MODE_EMA,0);

18.36 iStochastic

double

iStochastic(

string symbol, int timeframe, int %Kperiod,

int %Dperiod, int slowing, int method,

int price_field, int mode, int shift)

Расчет Stochastic Oscillator.

Параметры:

symbol -

Символьное имя инструмента, на данных которого будет

вычисляться индикатор. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

%Kperiod

Период(количество баров) для вычисления линии %K.

%Dperiod

Период усреднения для вычисления линии %D.

slowing -

Значение замедления.

method -

Метод усреднения. Может быть любым из значений методов

скользящего среднего (Moving Average).

price_field

Параметр выбора цен для расчета. Может быть одной из

следующих величин: 0 - Low/High или 1 - Close/Close.

mode -

Индекс линии индикатора. Может быть любым из значений

идентификаторов линий индикаторов.

214

shift -

Индекс получаемого значения из индикаторного буфера (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

if(iStochastic(NULL,0,5,3,3,MODE_SMA,0,MODE_MAIN,0)>iStochastic(NULL,0,5,3,

3,MODE_SMA,0,MODE_SIGNAL,0))

return(0);

18.37 iWPR

double iWPR(string symbol, int timeframe, int period, int shift)

Расчет индикатора Larry Williams' Percent Range.

Параметры:

symbol -

Символьное имя инструмента, на данных которого будет

вычисляться индикатор. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

period -

Период(количество баров) для вычисления индикатора.

shift -

Индекс получаемого значения из индикаторного буфера (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

if(iWPR(NULL,0,14,0)>iWPR(NULL,0,14,1)) return(0);

215

19 Доступ к таймсериям

Группа функций, предназначенных для доступа к ценовым данным любого доступного

символа/периода.

Если запрашивается информация с другого графика (название инструмента и/или

значение таймфрейма отличаются от текущих), то возможна ситуация, что в клиентском

терминале не открыт соответствующий график и необходимые данные должны быть

запрошены у сервера. В этом случае в переменную last_error

будет помещена ошибка

ERR_HISTORY_WILL_UPDATED (4066 - запрошенные исторические данные в состоянии

обновления) и необходимо через некоторое время повторить попытку запроса (см. пример

ArrayCopySeries()

При тестировании ценовые данные того же самого символа, но другого таймфрейма,

моделируются точно, за исключением объемов. Объемы других таймфреймов не

моделируются. Ценовые данные других символов не моделируются. Во всех случаях

количество баров

в таймсериях моделируется точно

19.1 iBars

int iBars(string symbol, int timeframe)

Возвращает количество баров на определенном графике.

Для текущего графика информация о количестве баров находится в предопределенной

переменной Bars

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

Пример:

Print("Bar count on the 'EURUSD,H1' is ",iBars("EURUSD",PERIOD_H1));

19.2 iBarShift

int

iBarShift(

string symbol, int timeframe, datetime time,

bool exact=false)

216

Поиск бара по времени. Функция возвращает смещение бара, которому принадлежит

указанное время. Если для указанного времени бар отсутствует ("дыра" в истории), то

функция возвращает, в зависимости от параметра exact, -1 или смещение ближайшего

бара.

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

time -

Значение времени для поиска.

exact -

Возвращаемое значение если бар не найден. FALSE - iBarShift

возвращает ближайший. TRUE - iBarShift возвращает -1.

Пример:

datetime some_time=D'2004.03.21 12:00';

int shift=iBarShift("EUROUSD",PERIOD_M1,some_time);

Print("shift of bar with open time ",TimeToStr(some_time)," is ",shift);

19.3 iClose

double iClose(string symbol, int timeframe, int shift)

Возвращает значение цены закрытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция возвращает 0.

Для получения дополнительной информации об ошибке необходимо вызвать функцию

GetLastError()

Для текущего графика информация о ценах закрытия находится в предопределенном

массиве Close[].

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

shift -

Индекс получаемого значения из таймсерии (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

217

Print("Current bar for USDCHF H1: ",iTime("USDCHF",PERIOD_H1,i),", ",

iOpen("USDCHF",PERIOD_H1,i),", ",

iHigh("USDCHF",PERIOD_H1,i),", ",

iLow("USDCHF",PERIOD_H1,i),", ",

iClose("USDCHF",PERIOD_H1,i),", ",

iVolume("USDCHF",PERIOD_H1,i));

19.4 iHigh

double iHigh(string symbol, int timeframe, int shift)

Возвращает значение максимальной цены указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция возвращает 0.

Для получения дополнительной информации об ошибке необходимо вызвать функцию

GetLastError()

Для текущего графика информация о максимальных ценах находится в предопределенном

массиве High[].

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

shift -

Индекс получаемого значения из таймсерии (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

Print("Current bar for USDCHF H1: ",iTime("USDCHF",PERIOD_H1,i),", ",

iOpen("USDCHF",PERIOD_H1,i),", ",

iHigh("USDCHF",PERIOD_H1,i),", ",

iLow("USDCHF",PERIOD_H1,i),", ",

iClose("USDCHF",PERIOD_H1,i),", ",

iVolume("USDCHF",PERIOD_H1,i));

19.5 iHighest

int

iHighest(

string symbol, int timeframe, int type,

int count=WHOLE_ARRAY, int start=0)

Возвращает индекс найденного наибольшего значения (смещение относительно текущего

бара).

Параметры:

218

symbol -

Символьное имя инструмента, на данных которого будет

производиться поиск. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

type -

Идентификатор таймсерии. Может быть любым из значений

иденитификаторов таймсерий.

count -

Число элементов таймсерии (в направлении от текущего бара в

сторону возрастания индекса), среди которых должен быть

произведен поиск.

start -

Индекс (смещение относительно текущего бара) начального

бара, с которого начинается поиск наибольшего значения.

Отрицательные значения игнорируются и заменяются нулевым

значением.

Пример:

double val;

// расчет максимального значения цены на 20 последовательных барах

// с индекса 4 по индекс 23 включительно на текущем графике

val=High[iHighest(NULL,0,MODE_HIGH,20,4)];

19.6 iLow

double iLow(string symbol, int timeframe, int shift)

Возвращает значение минимальной цены указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция возвращает 0.

Для получения дополнительной информации об ошибке необходимо вызвать функцию

GetLastError()

Для текущего графика информация о минимальных ценах находится в предопределенном

массиве Low[].

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

shift -

Индекс получаемого значения из таймсерии (сдвиг

219

относительно текущего бара на указанное количество периодов

назад).

Пример:

Print("Current bar for USDCHF H1: ",iTime("USDCHF",PERIOD_H1,i),", ",

iOpen("USDCHF",PERIOD_H1,i),", ",

iHigh("USDCHF",PERIOD_H1,i),", ",

iLow("USDCHF",PERIOD_H1,i),", ",

iClose("USDCHF",PERIOD_H1,i),", ",

iVolume("USDCHF",PERIOD_H1,i));

19.7 iLowest

int

iLowest(

string symbol, int timeframe, int type,

int count=WHOLE_ARRAY, int start=0)

Возвращает индекс найденного наименьшего значения (смещение относительно текущего

бара).

Параметры:

symbol -

Символьное имя инструмента, на данных которого будет

производиться поиск. NULL означает текущий символ.

timeframe

Период. Может быть одним из значений периодов графика. 0

означает период текущего графика.

type -

Идентификатор таймсерии. Может быть любым из значений

идентификаторов таймсерий.

count -

Число элементов таймсерии (в направлении от текущего бара в

сторону возрастания индекса), среди которых должен быть

произведен поиск.

start -

Смещение (относительно текущего) начального бара, с

которого начинается поиск наименьшего значения.

Пример:

double val=Low[iLowest(NULL,0,MODE_LOW,10,10)];

19.8 iOpen

double iOpen(string symbol, int timeframe, int shift)

Возвращает значение цены открытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция возвращает 0.

220

Для получения дополнительной информации об ошибке необходимо вызвать функцию

GetLastError().

Для текущего графика информация о ценах открытия находится в предопределенном

массиве Open[]

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

shift -

Индекс получаемого значения из таймсерии (сдвиг

относительно текущего бара на указанное количество периодов

назад).

Пример:

Print("Current bar for USDCHF H1: ",iTime("USDCHF",PERIOD_H1,i),", ",

iOpen("USDCHF",PERIOD_H1,i),", ",

iHigh("USDCHF",PERIOD_H1,i),", ",

iLow("USDCHF",PERIOD_H1,i),", ",

iClose("USDCHF",PERIOD_H1,i),", ",

iVolume("USDCHF",PERIOD_H1,i));

19.9 iTime

datetime iTime(string symbol, int timeframe, int shift)

Возвращает значение времени открытия указанного параметром shift бара с

соответствующего графика (symbol, timeframe). В случае ошибки функция возвращает 0.

Для получения дополнительной информации об ошибке необходимо вызвать функцию

GetLastError()

Для текущего графика информация о времени открытия каждого бара находится в

предопределенном массиве Time[].

Параметры:

symbol -

Символьное имя инструмента. NULL означает текущий символ.

timeframe

Период. Может быть одним из периодов графика. 0 означает

период текущего графика.

shift -

Индекс получаемого значения из таймсерии (сдвиг

относительно текущего бара на указанное количество периодов

назад).