* Die Konstanten stellen viele Funktionen zur einfachen Programmierung bereit * und enthält auch einige dynamische Werte, die von der Zeichenmaschine laufend - * aktuell gehalten werden (beispielsweise {@link #runtime}. + * aktuell gehalten werden (beispielsweise {@link #runtime}). *
* Für die Implementierung eigener Klassen ist es oft hilfreich von
* {@code Constants} zu erben, um die Methoden und Konstanten einfach im
@@ -64,13 +65,49 @@ public class Constants {
/**
* Patchversion der Zeichenmaschine.
*/
- public static final int APP_VERSION_REV = 22;
+ public static final int APP_VERSION_REV = 31;
/**
* Version der Zeichenmaschine als Text-String.
*/
public static final String APP_VERSION = APP_VERSION_MAJ + "." + APP_VERSION_MIN + "." + APP_VERSION_REV;
+ /**
+ * Gibt an, ob die Zeichenmaschine unter macOS gestartet wurde.
+ */
+ public static final boolean MACOS;
+
+ /**
+ * Gibt an, ob die Zeichenmaschine unter Windows gestartet wurde.
+ */
+ public static final boolean WINDOWS;
+
+ /**
+ * Gibt an, ob die Zeichenmaschine unter Linux gestartet wurde.
+ */
+ public static final boolean LINUX;
+
+ static {
+ final String name = System.getProperty("os.name");
+
+ if( name.contains("Mac") ) {
+ MACOS = true;
+ WINDOWS = false;
+ LINUX = false;
+ } else if( name.contains("Windows") ) {
+ MACOS = false;
+ WINDOWS = true;
+ LINUX = false;
+ } else if( name.equals("Linux") ) { // true for the ibm vm
+ MACOS = false;
+ WINDOWS = false;
+ LINUX = true;
+ } else {
+ MACOS = false;
+ WINDOWS = false;
+ LINUX = false;
+ }
+ }
/**
* Standardbreite eines Zeichenfensters.
@@ -1280,6 +1317,26 @@ public class Constants {
return getRandom().nextGaussian();
}
+ /**
+ * Wählt ein zufälliges Element aus dem Array aus.
+ *
+ * @param values Ein Array mit Werten, die zur Auswahl stehen.
+ * @return Ein zufälliges Element aus dem Array.
+ */
+ public static final int choice( int[] values ) {
+ return values[random(0, values.length - 1)];
+ }
+
+ /**
+ * Wählt ein zufälliges Element aus dem Array aus.
+ *
+ * @param values Ein Array mit Werten, die zur Auswahl stehen.
+ * @return Ein zufälliges Element aus dem Array.
+ */
+ public static final double choice( double[] values ) {
+ return values[random(0, values.length - 1)];
+ }
+
/**
* Wählt ein zufälliges Element aus dem Array aus.
*
@@ -1291,6 +1348,69 @@ public class Constants {
return values[random(0, values.length - 1)];
}
+ /**
+ * Wählt die angegebene Anzahl Elemente aus dem Array aus.
+ *
+ * @param values Ein Array mit Werten, die zur Auswahl stehen.
+ * @param n Anzahl der auszuwählenden Elemente.
+ * @param unique Bei {@code true} werden Elemente im Array nur maximal
+ * einmal ausgewählt (Ziehen ohne Zurücklegen).
+ * @return Ein zufälliges Element aus dem Array.
+ * @throws IllegalArgumentException Wenn {@code unique == true} und
+ * {@code values.length < n}, also nicht
+ * genug Werte zur Wahl stehen.
+ */
+ public static final int[] choice( int[] values, int n, boolean unique ) {
+ if( unique && values.length < n )
+ throw new IllegalArgumentException(
+ String.format("Need at least <%d> values to choose <%d> unique values (<%d> given).", n, n, values.length)
+ );
+
+ int[] result = new int[n];
+ int[] valuesCopy = Arrays.copyOf(values, values.length);
+ for( int i = 0; i < n; i++ ) {
+ int j = random(0, valuesCopy.length-1);
+ int l = valuesCopy.length-1;
+
+ result[i] = valuesCopy[j];
+ valuesCopy[j] = valuesCopy[l];
+ valuesCopy[l] = result[i];
+
+ if( unique )
+ valuesCopy = Arrays.copyOf(valuesCopy, l);
+ }
+ return result;
+ }
+
+ /**
+ * Wählt die angegebene Anzahl Elemente aus dem Array aus.
+ *
+ * @param values Ein Array mit Werten, die zur Auswahl stehen.
+ * @param n Anzahl der auszuwählenden Elemente.
+ * @return Ein zufälliges Element aus dem Array.
+ */
+ public static final double[] choice( double[] values, int n, boolean unique ) {
+ if( unique && values.length < n )
+ throw new IllegalArgumentException(
+ String.format("Need at least <%d> values to choose <%d> unique values (<%d> given).", n, n, values.length)
+ );
+
+ double[] result = new double[n];
+ double[] valuesCopy = Arrays.copyOf(values, values.length);
+ for( int i = 0; i < n; i++ ) {
+ int j = random(0, valuesCopy.length-1);
+ int l = valuesCopy.length-1;
+
+ result[i] = valuesCopy[j];
+ valuesCopy[j] = valuesCopy[l];
+ valuesCopy[l] = result[i];
+
+ if( unique )
+ valuesCopy = Arrays.copyOf(valuesCopy, l);
+ }
+ return result;
+ }
+
/**
* Wählt die angegebene Anzahl Elemente aus dem Array aus.
*
@@ -1299,12 +1419,26 @@ public class Constants {
* @param