База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

when — допълнително условие към шаблон в switch

В Java SE 21 контекстната ключова дума when въвежда допълнително условие (guard) след шаблон case в оператор или израз switch. Клонът се избира само ако стойността съвпада с шаблона и условието се оценява като true.

Версия: Language target: Java SE 21. Neither the repository runtime version nor the production runtime version is attested.

Синтаксис

case Pattern when Expression -> ...
case Pattern when Expression: ...

when е контекстна, а не резервирана ключова дума: тя има тази роля в граматиката на Guard, но извън този контекст може да се използва като идентификатор. В Java SE 21 въвежда допълнително условие след шаблон case в оператор или израз switch. Не е самостоятелен оператор и не замества if.

Първо се проверява шаблонът. Условието след when се оценява само след съвпадение и може да използва променливи, декларирани от този шаблон, например s. Резултат true позволява избор на клона; при false търсенето на приложим етикет продължава. Guard може да се използва както с ->, така и с :. Не може да се добави към константен етикет като case 42.

Guard трябва да е от тип boolean или Boolean; разопаковането на стойност null от тип Boolean хвърля NullPointerException. Константен израз със стойност false е забранен. Локалните променливи и параметрите, използвани в guard, но недекларирани в него, трябва да са final или ефективно final.

Поставете по-конкретния случай с guard преди общия случай от същия тип. Размяната на реда в примера би довела до грешка при компилация, защото етикетът с guard би бил доминиран. case null обработва изрично null; само default не осигурява такава обработка. Примерът е предназначен за Java SE 21 и не изисква функции preview; той не удостоверява версията на средата за изпълнение в хранилището или в продукция.

Примери

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));
    }
}

Резултат

long string
short string
other
null

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници