====== urnStatus() ======

''array **urnStatus**(string //UrnenKennung//)''

Die Funktion ''urnStatus()'' liefert Informationen zum aktuellen Füllstand der angegeben Urne.

  * //UrnenKennung//\\ Die Kennung der Urne, deren Status abgefragt werden soll.

===== Rückgabewert =====

Im Fehlerfall, z.B. wenn es keine Urne mit der angegebenen Kennung gibt, gibt die Funktion ''false'' zurück. Ansonten wird ein Array mit den folgenden Schlüsseln zurückgegeben:

^Index^Bedeutung^
|elements|Anzahl der Zettel (Elemente) in der Urne|
|drawn|Anzahl der bisher insgesamt entnommenen und abgelegten Zettel|
|round|Angabe, zum wievielten Mal die Urne gerade geleert wird (beginnt mit 1), entsprechend dem Rückgabewert von ''urnDraw()''|
|done|Anzahl der Zettel, die __in der aktuellen Runde__ bereits gezogen wurden. Wenn alle Zettel aus der Urne gezogen wurden, beginnt die nächste Runde und die Anzahl der gezogenen Zettel wird auf 0 zurückgesetzt.|
|togo|Anzahl der Zettel, die __in der aktuellen Runde__ noch zur Ziehung bereit stehen. Wenn diese Zahl den Wert 0 erreicht, beginnt eine neue Runde und der Wert wird auf die Anzahl der Zettel zurückgesetzt|

===== Beispiel =====

<code php>
$info = urnStatus('urne1');
html('<p>Noch '.$info['togo'].' von '.$info['elements'].' Gewinncodes verfügbar.</p>');
</code>