CKTIS / Java
when — zusätzliche Bedingung bei einem switch-Muster
In Java SE 21 leitet das kontextabhängige Schlüsselwort when nach einem case-Muster in einer switch-Anweisung oder einem switch-Ausdruck eine zusätzliche Bedingung (Guard) ein. Der Zweig wird nur ausgewählt, wenn der Wert zum Muster passt und die Bedingung true ergibt.
Version: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.
Syntax
case Pattern when Expression -> ...
case Pattern when Expression: ...when ist ein kontextabhängiges, kein reserviertes Schlüsselwort: In der Grammatik für Guard hat es diese Funktion, außerhalb dieses Kontexts kann es jedoch als Bezeichner verwendet werden. In Java SE 21 leitet es nach einem case-Muster in einer switch-Anweisung oder einem switch-Ausdruck eine zusätzliche Bedingung ein. Es ist weder eine eigenständige Anweisung noch ein Ersatz für if.
Zuerst wird das Muster geprüft. Erst nach einer Übereinstimmung wird die Bedingung nach when ausgewertet; sie kann Variablen verwenden, die durch das Muster deklariert wurden, zum Beispiel s. Bei true kann der Zweig ausgewählt werden; bei false wird weiter nach einem passenden Label gesucht. Ein Guard kann sowohl mit -> als auch mit : verwendet werden. Er kann nicht an ein konstantes Label wie case 42 angehängt werden.
Der Guard muss den Typ boolean oder Boolean haben; das Unboxing eines null-Werts vom Typ Boolean löst NullPointerException aus. Ein konstanter Ausdruck mit dem Wert false ist unzulässig. Lokale Variablen und Parameter, die im Guard verwendet, dort aber nicht deklariert werden, müssen final oder effektiv final sein.
Platziere einen spezifischeren, bewachten Fall vor einem allgemeinen Fall desselben Typs. Eine umgekehrte Reihenfolge im Beispiel würde wegen eines dominierten Labels zu einem Kompilierfehler führen. case null behandelt null ausdrücklich; default allein gewährleistet diese Behandlung nicht. Das Beispiel ist auf Java SE 21 ausgerichtet und benötigt keine Preview-Funktionen; es bestätigt weder die Version der Repository-Laufzeit noch die der Produktionslaufzeit.
Beispiele
public class WhenExample {
static String classify(Object value) {
return switch (value) {
case null -> "null";
case String s when s.length() > 3 -> "long string";
case String s -> "short string";
default -> "other";
};
}
public static void main(String[] args) {
System.out.println(classify("Java"));
System.out.println(classify("Hi"));
System.out.println(classify(42));
System.out.println(classify(null));
}
}Ergebnis
long string short string other null
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.