
RingBufferGet()
***************


FUNKTION
========

   protected mixed RingBufferGet(struct std_ringbuffer buf);


DEFINIERT IN
============

   /std/util/ringbuffer.c
   /sys/util/ringbuffer.h


ARGUMENTE
=========

   buf - Ringpuffer, welcher ausgeben werden soll


BESCHREIBUNG
============

   Diese Funktion liefert die Daten des Ringpuffers in Form eines Arrays
   zurueck, welches dann weiterverarbeitet werden kann.
   Die Reihenfolge der Daten ist entsprechend des beim Anlegen des
   Ringpuffers angebenen Modes:
   MODE_FIFO: aelteste Daten zuerst
   MODE_LIFO: neueste Daten zuerst


BEMERKUNGEN
===========

   Aenderungen am Array beeinflussen die Daten des Ringpuffers nicht. Aber:
   Hierbei werden die Daten nicht tief kopiert. D.h. enthaelt der Ringpuffer
   Referenzen auf weitere Daten, zeigen der Ringpuffer und das hier
   gelieferte Array auf die gleichen Daten.


BEISPIELE
=========

   // Ringpuffer anlegen:
   struct std_ringbuffer buffer = CreateRingBuffer(10, MODE_FIFO);
   // 15 Werte reinschreiben:
   foreach(int i: 15) RingBufferPut(buffer, i);
   // Werte abrufen:
   mixed array=RingBufferGet(buffer);
   // array enthaelt nun:
   // ({5,6,7,8,9,10,11,12,13,14})


SIEHE AUCH
==========

   CreateRingBuffer(), RingBufferPut(), ResizeRingBuffer()

23.05.2008, Zesstra