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

CKTIS / Java

Заместващ знак с долна граница: `? super String`

Виж защо `Spliterator<String>.tryAdvance` приема както консуматор за `String`, така и консуматор за негов супертип, например `CharSequence`.

Версия: Java SE 21

Синтаксис

? super String
Consumer<? super String>
boolean tryAdvance(Consumer<? super T> action);

В Consumer<? super String> знакът ? обозначава неизвестен типов аргумент, а super String задава долната му граница. Аргументът може да е самият String или негов супертип, например CharSequence или Object. Това не прави Consumer<Object> подтип на Consumer<String>: без заместващия знак стойност от единия параметризиран тип не може да се присвои на променлива от другия.

Чрез референция от тип Consumer<? super String> можеш да извикаш accept със стойност от тип String, но не и с произволен Object или със StringBuilder: конкретният консуматор може да приема само String. За разлика от това Consumer<? extends CharSequence> не гарантира, че accept приема String, защото неизвестният типов аргумент може да е StringBuilder. Използвай super, когато подаваш стойности на консуматор (правилото PECS: consumer super).

В Spliterator<T> методът boolean tryAdvance(Consumer<? super T> action) приема Consumer<? super String> при T = String. Ако има останал елемент, методът подава един елемент на действието и връща true, ако действието приключи нормално. За сплитератор с характеристика ORDERED това е следващият елемент по реда на обхождане. Ако няма останали елементи, методът връща false, без да извиква действието.

Действие със стойност null води до NullPointerException. Ако действието хвърли изключение, то се предава на извикващия код, а по-нататъшното поведение на сплитератора не е уточнено.

Примери

import java.util.List;
import java.util.Spliterator;
import java.util.function.Consumer;

public class Main {
    public static void main(String[] args) {
        Spliterator<String> words = List.of("Java").spliterator();
        Consumer<CharSequence> printLength = text -> System.out.println(text.length());
        Consumer<? super String> action = printLength;

        System.out.println(words.tryAdvance(action));
        System.out.println(words.tryAdvance(action));
    }
}

Резултат

4
true
false

`Consumer<CharSequence>` може да обработи `String` без явно преобразуване на типа. При първото извикване дължината на `Java` (`4`) се извежда преди `true`; при второто се извежда `false`, без действието да се изпълнява.

Свързани уроци

  • Java · Урок 23 · Напреднало · Версия: 2

Източници