Vereinfachte Klasse des CArrayRing256 Ringbuffers - Bibliothek für den MetaTrader 5

Beschreibung

Diese Klasse ist die vereinfachte Version der CArrayRing Klasse: sie hat eine vorgegebene fixe Größe von 256 Elementen, sie ist schneller und erlaubt Minizeitreihen, Minibuffer, kurze Buffer zu organisieren um Datenstörme sofort innerhalb des Expert Advisors oder Indikators zu speichern. 

Vereinfachung basierend auf der Eigenschaft der uchar-Variable, die im Arrayindex verwendet wird. Zum Beispiel im Code

double array[UCHAR_MAX+1];  // Ringbufferdaten
uchar  index=0;             // Bufferelementindex

while(!IsStopped())
  {
   array[++index];          // gehe zum nächsten Element des Buffers
   ...
  }

Der Arrayindex nimmt immer Werte von 0 bis 255 ein und geht nie über die Grenzen der Arraydimension hinaus. Er erlaubt es, alle Prüfungen von den Methoden zu entfernen, verbunden mit einem möglichen Ausstieg aus dem Index über die Arraygrenzen hinaus, indem die Methoden selbst vereinfacht wurden und die Performance verbessert wurde. Aber die Buffergröße ist immer konstant und hat die Größe von 256 Elementen. Für viele Aufgaben ist das eine akzeptable Alternative zur universellen Klasse CArrayRing im Tausch gegen eine höhere Verarbeitungsgeschwindigkeit.

сlass CArrayRing256

Titel

#include <IncOnRingBuffer\CArrayRing256.mqh>

Die Datei der CArrayRing256.mqh Klasse sollte in den Ordner IncOnRingBuffer der in MQL5\Include\ erstellt werden muss kopiert werden.

Klassenmethoden 

//--- Buffer-Initialisierungsmethode:
void Init(
   double volue=EMPTY_VALUE // Wert für leere Positionen des Buffers
   );
//--- Methode zum Hinzufügen von neuen Elementen zum Buffer:
void Add(
   const double element     // hinzzufügender Elementwert
   ); 

//--- diese Methode schreibt den Elementwert des gegebenen Index zurück:
void Update(                // gibt bei Fehler false zurück, bei Erfolg - true
   const double element,    // neuer Wert des Elements
   const uchar  index=0     // der Elementindex
   );  

//--- diese Methode gibt den Elementwert des gegebenen Index zurück:
double At(                  // gibt den Wert für das Mengenelement zurück
   const uchar index        // der Elementindex
   ) const;

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

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

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

Beispiele

Verwendung dieser Klasse ist ähnlich wie bei CArrayRing . Es gibt ein paar Unterschiede:

• Die Init() Methode wird zur Initialisierung des Buffers mit dem definierten Wert verwendet;
• Die Resize() Methode gibt es nicht, da die Größe des Buffers immer konstant ist.