Класс для создания кольцевого буфера - библиотека для MetaTrader 5

Описание

Кольцевой буфер - это одна из форм организации хранения данных. Обычно представляет из себя массив конечной длинны при записи в который при переполнении самые старые элементы заменяются самыми новыми данными. Таким образом всегда есть доступ к определенному количеству последних данных. Используется чаще всего для асинхронного чтения/записи потоковых данных. Подробнее здесь.

При написании экспертов и индикаторов часто не требуется хранить рассчитанные значения для всех баров. Достаточно иметь под рукой только последние данные для, например, 100 баров. Для этого как раз хорошо подходит кольцевой буфер. Очевидные преимущества:

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

сlass CArrayRing

Заголовок

#include <IncOnRingBuffer\CArrayRing.mqh>

Файл класса CArrayRing.mqh нужно поместить в папку IncOnRingBuffer, которую необходимо создать в MQL5\Include\. Ниже есть ссылки на примеры, которые используют этот класс.

Методы класса 

//--- метод инициализации буфера:
bool Init(                  // при ошибке возвращает false, при успешном выполнении true
   int    size,             // размер кольцевого буфера
   double volue=EMPTY_VALUE // значение для заполнения пустых ячеек буфера
   );

//--- метод добавления нового элемента в буфер:
void Add(
   const double element     // значение добавляемого элемента
   ); 

//--- метод перезаписывает значение элемента с указанным индексом:
bool Update(                // при ошибке возвращает false, при успехе - true
   const double element,    // новое значение элемента
   const int index=0        // индекс элемента
   );  

//--- метод возвращает значение элемента с указанным индексом:
double At(                  // возвращает значение элемента
   const int index          // индекс элемента
   ) const;

//--- метод возвращает значение последнего записанного в буфер элемента:
double Last() const;

//--- метод перезаписывает значение последнего элемента в буфере:
void Last(
   const double element     // новое значение элемента
   );  

//--- метод возвращает размер кольцевого буфера:
int Size();

//--- метод изменяет размер кольцевого буфера:
bool Resize(
   const int size           // новый размер
   );

Примеры

На момент публикации подготовлено три примера использования кольцевого буфера:

• Класс для построения Moving Average
• Класс для построения Average True Range
• Класс для построения Average Directional Movement Index