array urnStatus(string UrnenKennung)
Die Funktion urnStatus() liefert Informationen zum aktuellen Füllstand der angegeben Urne.
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 |
$info = urnStatus('urne1'); html('<p>Noch '.$info['togo'].' von '.$info['elements'].' Gewinncodes verfügbar.</p>');