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

CKTIS / Java

Zástupný typ s dolní mezí: `? super String`

Zjisti, proč `Spliterator<String>.tryAdvance` přijímá konzumenta typu `String` i konzumenta jeho nadtypu, například `CharSequence`.

Verze: Java SE 21

Syntaxe

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

V zápisu Consumer<? super String> označuje ? neznámý typový argument a super String stanoví jeho dolní mez. Argumentem může být samotný String nebo jeho nadtyp, například CharSequence či Object. Z toho neplyne, že Consumer<Object> je podtypem Consumer<String>: bez zástupného typu nelze ani jeden z těchto parametrizovaných typů přiřadit druhému.

Přes referenci typu Consumer<? super String> lze zavolat accept s hodnotou typu String, ale ne s libovolným Object ani s StringBuilder: skutečný konzument může přijímat pouze String. Naproti tomu Consumer<? extends CharSequence> nezaručuje, že accept přijme String, protože neznámým typovým argumentem může být StringBuilder. Při předávání hodnot konzumentovi použij super (pravidlo PECS: consumer super).

V Spliterator<T> přijímá metoda boolean tryAdvance(Consumer<? super T> action) pro T = String argument typu Consumer<? super String>. Pokud zbývá prvek, metoda předá jeden prvek akci a vrátí true, pokud akce skončí normálně. U spliteratoru ORDERED jde o následující prvek v pořadí průchodu. Pokud už žádný prvek nezbývá, vrátí false, aniž by akci zavolala.

Akce s hodnotou null způsobí NullPointerException. Pokud akce vyvolá výjimku, ta se předá volajícímu a další chování spliteratoru není specifikováno.

Příklady

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

Výsledek

4
true
false

`Consumer<CharSequence>` může zpracovat `String` bez přetypování. První volání vypíše délku `Java` (`4`) před výpisem `true`; druhé vypíše `false` a akci nespustí.

Související lekce

  • Java · Lekce 23 · Pokročilá · Verze: 2

Zdroje