de.thewayout.o8.api
Interface IDiceCup

public interface IDiceCup

Der Würfelbecher (DiceCup) ist der einzige, zugelassene Zufallsgenerator. Jedes Schiff hat Zugriff auf einen eigenen Würfelbecher. Ein Teilnehmer kann den Würfelbecher anderer Schiffe also nicht "zinken". ;-)
Vom System werden alle Würfelbecher auf einen definierten Ausgangszustand gesetzt. Weil sich alle Würfelbecher deterministisch verhalten ist der Ablauf einer Simulation reproduzierbar (was wichtig für die Fehlersuche ist ;-) .

Author:

ObjectFab GmbH

Method Summary

double	throwDices() Würfelt eine zufällige Gleitkomma-Zahl im Bereich von einschliesslich 0.0 bis einschliesslich 1.0.
int	throwDices(int upperLimit) Würfelt eine zufällige, ganze Zahl im Bereich von einschliesslich 0 bis ausschliesslich eine obere Grenze.

Method Detail

throwDices

double throwDices()

Würfelt eine zufällige Gleitkomma-Zahl im Bereich von einschliesslich 0.0 bis einschliesslich 1.0.

Returns:

zufälliger double-Wert im Bereich [0; 1]

throwDices

int throwDices(int upperLimit)

Würfelt eine zufällige, ganze Zahl im Bereich von einschliesslich 0 bis ausschliesslich eine obere Grenze. Diese Funktion ist hilfreich, um z.B. einen zufälligen Index in einem Array zu erzeugen:

   index    = diceCup.throwDices(array.length);
   lookedUp = array[index];
 

Parameters:

upperLimit - obere Grenze (ausschliesslich) für die zu erzeugende Zufallszahl

Returns:

zufälliger int-Wert im Bereich [0; upperLimit]