Class Counter

java.lang.Object
schule.ngb.zm.util.Counter

public final class Counter extends Object
Eine Hilfsklasse, um Dinge zu zählen.

Im einfachsten Fall kann der Zähler als geteilte Zählvariable genutzt werden, die mit inc() und dec() aus verschiedenen Objekten oder Methoden verändert werden kann.

Der Zähler kann aber auch Objekte zählen, indem die Instanzen an count(Object) übergeben werden. Am Ende kann mit getCount() die Anzahl der Objekte abgerufen werden.

Handelt es sich bei den Objekten um Zahlen, dann merkt sich ein Counter auch das Maximum, das Minimum, die Summe und den Durchschnitt der gezählten Werte.

Ein Zähler kann auch komplette Arrays oder Listen von Zahlen zählen und die obigen Statistiken auswerten.

  • Constructor Details

    • Counter

      public Counter()
      Erstellt einen neuen, leeren Counter.
    • Counter

      public Counter(int initial)
      Ertstellt einen neuen Counter, der mit dem angegebenen Wert initialisiert ist.
      Parameters:
      initial - Wert des Zählers zu Beginn.
  • Method Details

    • fromArray

      public static Counter fromArray(int[] values)
      Erstellt einen neuen Counter, der alle Integer im angegebenen Array gezählt hat.
      Parameters:
      values - Die zu zählenden Werte.
      Returns:
      Ein neuer Counter.
    • fromArray

      public static Counter fromArray(double[] values)
      Erstellt einen neuen Counter, der alle Doubles im angegebenen Array gezählt hat.
      Parameters:
      values - Die zu zählenden Werte.
      Returns:
      Ein neuer Counter.
    • fromArray

      public static Counter fromArray(Number[] values)
      Erstellt einen neuen Counter, der alle Zahlen im angegebenen Array gezählt hat.
      Parameters:
      values - Die zu zählenden Werte.
      Returns:
      Ein neuer Counter.
    • fromList

      public static Counter fromList(List<Number> values)
      Erstellt einen neuen Counter, der alle Zahlen in der angegebenen Liste gezählt hat.
      Parameters:
      values - Die zu zählenden Werte.
      Returns:
      Ein neuer Counter.
    • getCount

      public int getCount()
      Returns:
      Die aktuelle Anzahl.
    • getMax

      public double getMax()
      Returns:
      Das Maxium der bisher gezählten Werte.
    • getMin

      public double getMin()
      Returns:
      Das Minimum der bisher gezählten Werte.
    • getSum

      public double getSum()
      Returns:
      Die Summe der bisher gezählten Werte.
    • getAvg

      public double getAvg()
      Returns:
      Der Mittelwert der bisher gezählten Werte.
    • setCount

      public Counter setCount(int count)
      Setzt den Zähler auf den angegebenen Wert.

      Die anderen Statistiken werden nicht verändert.

      Parameters:
      count - Der neue Wert des Zählers.
      Returns:
      Dieser Zähler selbst (method chaining).
    • reset

      public Counter reset()
      Setzt den Zähler auf Null.

      Die Statistiken werden auf Double.NaN gesetzt.

      Returns:
      Dieser Zähler selbst (method chaining).
    • inc

      public Counter inc()
      Erhöht den Zähler um Eins.

      Die anderen Statistiken werden nicht verändert.

      Returns:
      Dieser Zähler selbst (method chaining).
    • dec

      public Counter dec()
      Verringert den Zähler um Eins.

      Die anderen Statistiken werden nicht verändert.

      Returns:
      Dieser Zähler selbst (method chaining).
    • count

      public Counter count(double value)
      Zählt den angegebenen Wert.

      Erhöht den Zähler um Eins und aktualisiert die Statistiken.

      Parameters:
      value - Der neue Wert.
      Returns:
      Dieser Zähler selbst (method chaining).
    • count

      public Counter count(Number num)
      Zählt die angegebene Zahl.

      Erhöht den Zähler um Eins und aktualisiert die Statistiken.

      Parameters:
      num - Die neue Zahl.
      Returns:
      Dieser Zähler selbst (method chaining).
    • count

      public Counter count(Object obj)
      Zählt das angegebenen Objekt.

      Erhöht den Zähler um Eins.

      Parameters:
      obj - Ein beliebiges Objekt.
      Returns:
      Dieser Zähler selbst (method chaining).
    • countAll

      public Counter countAll(double[] values)
      Zöhlt alle Werte im angegebenen Array.
      Parameters:
      values - Das Array der neuen Werte.
      Returns:
      Dieser Zähler selbst (method chaining).
      See Also:
    • countAll

      public Counter countAll(int[] values)
      Zöhlt alle Werte im angegebenen Array.
      Parameters:
      values - Das Array der neuen Werte.
      Returns:
      Dieser Zähler selbst (method chaining).
      See Also:
    • countAll

      public Counter countAll(Number[] values)
      Zöhlt alle Zahlen im angegebenen Array.
      Parameters:
      values - Das Array der neuen Zahlen.
      Returns:
      Dieser Zähler selbst (method chaining).
      See Also:
    • countAll

      public Counter countAll(Collection<Number> values)
      Zöhlt alle Zahlen in der angegebenen Sammlung.
      Parameters:
      values - Die Sammlung der neuen Zahlen.
      Returns:
      Dieser Zähler selbst (method chaining).
      See Also: