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