Klasse um einen Ringbuffer zu erstellen - Bibliothek für den MetaTrader 5

Beschreibung

Ein Ringbuffer ist eine Organisationsform, um Daten zu speichern. Üblicherweise präsentiert er ein Array von endlicher Länge bei dem das älteste Element durch die neuesten Daten ersetzt wird. Es gibt somit immer Zugriff auf eine bestimmte Anzahl der letzten Daten. Vor allem verwendet für asynchrones Lesen und Schreiben von Stromdaten. Für weitere Details siehe hier.

Wenn man Expert Advisors und Indikatoren schreibt, braucht man oft nicht die berechneten Werte für alle Balken. Es reicht aus, die letzten Daten, zum Beispiel für 100 Balken vorrätig zu halten. Dafür eignet sich der Ringbuffer. Offensichtliche Vorteile:

• Berechnungen werden schneller
• Speicherökonomie
• einfach zu verwenden, Sie müssen sich nicht um die Arraygrenzen kümmern.

сlass CArrayRing

Titel

#include <IncOnRingBuffer\CArrayRing.mqh>

Die Datei der  CArrayRing.mqh Klasse muss in den IncOnRingBuffer Ordner kopiert werden, der in MQL5\Include\ erzeugt werden muss. Untenstehende Links geben Beispiele für die Verwendung dieser Klasse.

Klassenmethoden 

//--- die Buffer-Initialisierungsmethode:
bool Init(                  // gibt bei Fehler false zurück, bei Erfolg - true
   int    size,             // Ringbuffergröße
   double volue=EMPTY_VALUE // Bedeutung für leere Positionen des Buffers
   );
//--- die Methode zum Hinzufügen von neuen Elementen zum Buffer:
void Add(
   const double element     // hinzzufügender Elementwert
   ); 

//--- diese Methode überschreibt jenen Elementwert mit dem gegebenen Index:
bool Update(                // gibt bei Fehler false zurück, bei Erfolg - true
   const double element,    // neuer Wert des Elements
   const int index=0        // Elementindex
   );  

//--- diese Methode gibt den Elementwert des gegebenen Index zurück:
double At(                  // zurückgegebener Elementwert
   const int index          // Elementindex
   ) const;

//--- diese Methode gibt den Wert des Elements zurück, das zuletzt in den Buffer geschrieben wurde:
double Last() const;

//--- diese Methode überschreibt den letzten Elementwert im Buffer:
void Last(
   const double element     // neuer Wert des Elements
   );  

//--- diese Methode gibt die Größe des Ringbuffers zurück:
int Size();

//--- diese Methode ändert die Größe des Ringbuffers:
bool Resize(
   const int size           // Neue Größe
   );

Beispiele

Zur Zeit der Veröffentlichung gibt es drei Beispiele zur Anwendung des Ringbuffers:

• Klasse zum Zeichnen von gleitenden Durchschnitten
• Klasse zum Zeichnen der Average True Range
• Klasse zum Zeichnen des Average Directional Movement Index