Графики

uCopyClose - Библиотека Custom HLOC pro

17 октября 2014, 00:00
Yurij Kozhevnikov
Yurij Kozhevnikov
0
108
Библиотека Custom HLOC pro

для MetaTrader4

uCopyClose

Получает в массив close_array исторические данные цен закрытия баров указанного символа-периода. Отсчет элементов от стартовой позиции ведется от настоящего к прошлому, то есть стартовая позиция, равная 0, означает текущий бар.

Существует 3 варианта функции.

1. Обращение по начальной позиции и количеству требуемых элементов

int  uCopyClose(
   string           symbol,            // символ
   uint             timeframe,         // период
   int              start_pos,         // откуда начнем
   int              count,             // сколько копируем
   double           close_array[]      // массив для копирования цен закрытия
   );

Параметры

symbol

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

timeframe

[in]  Период. Может быть любым целым неотрицательным числом. 0 означает период текущего графика.

start_pos

[in]  Номер первого копируемого элемента.

count

[in]  Количество копируемых элементов.

close_array[]

[out]  Массив типа double.

Возвращаемое значение

Количество скопированных элементов массива либо -1 в случае невозможности возвратить данные.

Примечание

Обращение к первому варианту функции во всём аналогично обращению к первому варианту функции CopyClose кроме типа входного параметра timeframe. Если для функции CopyClose диапазон доступных для копирования баров ограничен барами, отображаемыми на соответствующем графике, то для функции uCopyClose этот диапазон ограничен только глубиной хранящейся в файле истории.

Пример:

double close1[];
int ibars=iBars(_Symbol,PERIOD_M15);
int Count=uCopyClose(_Symbol,PERIOD_M15,ibars,15,close1);

2. Обращение по начальной дате и количеству требуемых элементов

int  uCopyClose(
   string           symbol,            // символ
   uint             timeframe,         // период
   datetime         start_time,        // с какой даты
   int              count,             // сколько копируем
   double           close_array[]      // массив для копирования цен закрытия
   );

Параметры

symbol

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

timeframe

[in]  Период. Может быть любым целым неотрицательным числом. 0 означает период текущего графика.

start_time

[in]  Время бара, соответствующее первому элементу.

count

[in]  Количество копируемых элементов.

close_array[]

[out]  Массив типа double.

Возвращаемое значение

Количество скопированных элементов массива либо -1 в случае невозможности возвратить данные.

Примечание

Обращение ко второму варианту функции во всём аналогично обращению ко второму варианту функции CopyClose кроме типа входного параметра timeframe. Если для функции CopyClose диапазон доступных для копирования баров ограничен барами, отображаемыми на соответствующем графике, то для функции uCopyClose этот диапазон ограничен только глубиной хранящейся в файле истории.

Пример:

double close1[];
datetime itime=iTime(_Symbol,PERIOD_M1,iBars(_Symbol,PERIOD_M1)-1);
int Count=uCopyClose(_Symbol,PERIOD_M1,itime,5,close1);

3. Обращение по начальной и конечной датам требуемого интервала времени

int  uCopyClose(
   string           symbol,            // символ
   uint             timeframe,         // период
   datetime         start_time,        // с какой даты
   datetime         stop_time,         // по какую дату
   double           close_array[],     // массив для копирования цен закрытия
   bool             full_bar=false     // признак полной свечи в указанном диапазоне
   );

Параметры

symbol

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

timeframe

[in]  Период. Может быть любым целым неотрицательным числом. 0 означает период текущего графика.

start_time

[in]  Время бара, соответствующее первому элементу.

stop_time

[in]  Время бара, соответствующее последнему элементу.

close_array[]

[out]  Массив типа double.

full_bar=false

[in]  Принцип отбора баров для копирования. Если full_bar=false, то для копирования отбираются все бары, время начала которых находится в заданном диапазоне. Если full_bar=true, то для копирования отбираются только бары, которые полностью находятся в заданном диапазоне.

Возвращаемое значение

Количество скопированных элементов массива либо -1 в случае невозможности возвратить данные.

Примечание

Третий вариант функции работает по логике, отличной от логики третьего варианта функции CopyClose. Если в первых двух вариантах отсчёт идёт от настоящего к прошлому, то в третьем - от прошлого к настоящему. Это означает, что если начальная и конечная даты находятся внутри баров указанного таймфрейма, то цена закрытия бара, которому принадлежит более ранняя дата, не будет скопирована, а цена закрытия бара, которому принадлежит более поздняя дата, будет скопирована только при full_bar=false. Указанная логика работает и в случае попадания дат на дыры в истории или выходные дни.

Пример:

double CloseF[];
double CloseT[];
datetime time1=D'2014.09.15 07:05:00';
datetime time2=D'2014.09.15 12:07:00';
int CountF=uCopyClose(_Symbol,PERIOD_M15,time1,time2,CloseF);
int CountT=uCopyClose(_Symbol,PERIOD_M15,time1,time2,CloseT,true);