Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje