
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);


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

   RingBufferPut(), RingBufferGet(), ResizeRingBuffer()

23.05.2008, Zesstra