CKTIS / Java
when — dodatečná podmínka u vzoru v switch
V Java SE 21 uvádí kontextové klíčové slovo when dodatečnou podmínku (guard) za vzorem case v příkazu nebo výrazu switch. Větev se vybere pouze tehdy, když hodnota odpovídá vzoru a podmínka se vyhodnotí jako true.
Verze: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.
Syntaxe
case Pattern when Expression -> ...
case Pattern when Expression: ...when je kontextové, nikoli rezervované klíčové slovo: tuto roli má v gramatice Guard, mimo tento kontext však může sloužit jako identifikátor. V Java SE 21 uvádí dodatečnou podmínku za vzorem case v příkazu nebo výrazu switch. Není samostatným příkazem ani náhradou za if.
Nejprve se testuje vzor. Podmínka za when se vyhodnotí až po shodě; může používat proměnné deklarované daným vzorem, například s. Výsledek true umožňuje vybrat větev, zatímco při výsledku false pokračuje hledání použitelného štítku. Guard lze použít s -> i s :. Nelze jej připojit ke konstantnímu štítku, jako je case 42.
Guard musí mít typ boolean nebo Boolean; rozbalení hodnoty null typu Boolean vyvolá NullPointerException. Konstantní výraz s hodnotou false je zakázán. Lokální proměnné a parametry použité v guardu, ale nedeklarované v něm, musí být final nebo efektivně final.
Konkrétnější případ s guardem umístěte před obecný případ stejného typu. Opačné pořadí v příkladu by způsobilo chybu při kompilaci, protože štítek s guardem by byl zastíněn. case null výslovně zpracovává null; samotné default toto zpracování nezajišťuje. Příklad je určen pro Java SE 21 a nevyžaduje funkce preview; nepotvrzuje verzi běhového prostředí repozitáře ani produkčního prostředí.
Příklady
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));
}
}Výsledek
long string short string other null
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.