CreateRingBuffer()¶
FUNKTION¶
protected struct std_ringbuffer CreateRingBuffer(int size, int newmode);
DEFINIERT IN¶
/std/util/ringbuffer.c
/sys/util/ringbuffer.h
ARGUMENTE¶
size - Groesse des neuen Ringpuffers (int)
newmode - Ausgabemodus beim Abrufen des Puffers (int):
MODE_FIFO: First-in-First-Out
MODE_LIFO: Last-in-First-Out
BESCHREIBUNG¶
Diese Funktion erstellt einen neuen, leeren Ringpuffer der Groesse <size>
und liefert ihn zurueck. Die Daten des Puffers werden spaeter gemaess
<newmode> so gespeichert, dass bei der Ausgabe des Puffers mittels
RingBufferGet() die entweder die neuesten Daten zuerst (MODE_LIFO) oder
die aeltesten Daten zuerst (MODE_FIFO) geliefert werden.
RUeCKGABEWERT¶
Der neue Ringpuffer. Dieser wird in einer Struct std_ringbuffer
gespeichert. Er ist in einer Variable 'mixed' oder in einer mittels
'struct std_ringbuffer' angelegten Variable speicherbar.
BEMERKUNGEN¶
Der gelieferte Ringpuffer sollte nicht per Hand verarbeitet oder
genaendert werden, sondern nur ueber die Verwaltungsfunktionen aus
/std/util/ringbuffer.c.
BEISPIELE¶
// Variable anlegen:
struct std_ringbuffer buffer;
// _oder_: mixed buffer;
// neuen Puffer mit max. 50 Elementen anlegen, der bei der Abfrage die
// aeltesten Daten zuerst zurueckliefert:
buffer = CreateRingBuffer(50, MODE_FIFO);