The Ring Buffer Class
Info
The The Ring Buffer Class is a Library for MetaTrader 5 that the ring buffer is a data structure designed for efficient storage and retrieval of data, particularly in scenarios where asynchronous reading and writing of stream data are involved. In the context of Expert Advisors and indicators, the ring buffer proves invaluable when there's no need to retain calculated values for all bars.
Usage
This tool is typically used for enhancing chart analysis and decision making.
Platform
This Library works exclusively on MetaTrader 5 (both build 600+ and newer versions).
Setup
Place the downloaded file in MQL5/Libraries folder via File ? Open Data Folder in MetaTrader 5.
How to Install and Use The Ring Buffer Class
1. Storage: Place library files in the MQL/Libraries directory to ensure they are accessible to your projects.
2. Implementation: Include the library in your code using the #import directive, ensuring you match the exact function names and parameters.
3. Compilation: Ensure the library is present in the directory before you compile your main EA or script, as the compiler links them during this phase.
4. Management: Keep libraries organized in sub-folders if you manage many custom functions to maintain a clean project structure.
Frequently Asked Questions
Q: What is a library file used for? A: Libraries store reusable code modules, allowing you to centralize common logic used by multiple EAs or indicators.
Q: Is a library executable? A: No, libraries are non-executable files containing functions; they must be imported into an EA, indicator, or script to function.
Q: Can I update a library while the platform is running? A: You should compile your EA or script after updating a library to ensure the latest code changes are integrated.
What this tool does
The ring buffer is a data structure designed for efficient storage and retrieval of data, particularly in scenarios where asynchronous reading and writing of stream data are involved.
Typical Use Case
This Library excels in automated trading and technical analysis on MetaTrader 5.
Compatible Platform & Setup
This Library works on MetaTrader 5. Place the file in the MQL5/Libraries folder and restart the terminal.
Description & Settings
Related: Crsionarray Class for RSI Calculation on Indicator Buffers - another powerful library for MetaTrader 5 traders.
The ring buffer is a data structure designed for efficient storage and retrieval of data, particularly in scenarios where asynchronous reading and writing of stream data are involved.Also recommended: CMO Indicator Buffer Calculation Class - similar library with strong performance on MetaTrader 5.
In the context of Expert Advisors and indicators, the ring buffer proves invaluable when there's no need to retain calculated values for all bars. Instead, it's often sufficient to maintain the most recent data, say, for the last 100 bars. The ring buffer excels in such situations, offering several advantages:
- Enhanced calculations
- Memory efficiency
- Simplified usage, eliminating concerns about exceeding array boundaries.
Declaration
To utilize the carrayring.mqh class, ensure the file is placed within the mql5\include\inconringbuffer directory. The class is exemplified in the links below.
Class Methods
Note:
When reducing the buffer size, the oldest elements are removed, maintaining the most recent data.
In this ring buffer implementation, indexing follows the convention, contrary to the typical approach.
Examples
As of 2026, there are three instances of ring buffer utilization:
- Class for drawing
- Class for drawing
- Class for drawing
You may also like: Relative Vigor Index (RVI) Calculation Class for Indicator Buffers - excellent alternative for library users on MetaTrader 5.
Source Code
#property copyright "robotfx"
#property link "https://robotfx.org"
class carrayring
{
private:
double m_data[]; // ring buffer of data
int m_size; // buffer size
int m_last_pos; // last buffer element position
double m_filling; // value, which used for the array filling
public:.......
⚠ Limitations & Risk Warning
- This tool is provided for educational and testing purposes only.
- Past performance does not guarantee future results.
- Trading involves substantial risk of loss. Use on a demo account first.
- Results may vary depending on market conditions, broker, and settings.
- We recommend thorough backtesting and forward testing before using with real funds.