WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Wildcard mit unterer Schranke: `? super String`

Erfahre, warum `Spliterator<String>.tryAdvance` sowohl einen Consumer für `String` als auch einen Consumer für einen Obertyp wie `CharSequence` akzeptiert.

Version: Java SE 21

Syntax

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

In Consumer<? super String> steht ? für ein unbekanntes Typargument, und super String legt dessen untere Schranke fest. Das Argument kann String selbst oder ein Obertyp wie CharSequence oder Object sein. Dadurch wird Consumer<Object> nicht zum Untertyp von Consumer<String>: Ohne Wildcard kann keiner der beiden parametrisierten Typen dem anderen zugewiesen werden.

Über eine Referenz vom Typ Consumer<? super String> kannst du accept mit einem String aufrufen, aber nicht mit einem beliebigen Object oder einem StringBuilder: Der konkrete Consumer könnte nur String akzeptieren. Bei Consumer<? extends CharSequence> ist dagegen nicht garantiert, dass accept einen String annimmt, denn das unbekannte Typargument könnte StringBuilder sein. Verwende super, wenn du einem Consumer Werte übergibst (PECS: consumer super).

In Spliterator<T> nimmt die Methode boolean tryAdvance(Consumer<? super T> action) für T = String einen Consumer<? super String> entgegen. Ist noch ein Element vorhanden, übergibt die Methode der Aktion ein Element und gibt nach deren normalem Abschluss true zurück. Bei einem ORDERED-Spliterator ist es das nächste Element in der Traversierungsreihenfolge. Sind keine Elemente mehr vorhanden, gibt die Methode false zurück, ohne die Aktion aufzurufen.

Eine null-Aktion führt zu einer NullPointerException. Wirft die Aktion eine Ausnahme, wird sie an den Aufrufer weitergegeben; das weitere Verhalten des Spliterators ist dann nicht spezifiziert.

Beispiele

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

Ergebnis

4
true
false

Ein `Consumer<CharSequence>` kann einen `String` ohne Cast verarbeiten. Beim ersten Aufruf wird die Länge von `Java` (`4`) vor `true` ausgegeben; beim zweiten erscheint `false`, ohne dass die Aktion ausgeführt wird.

Zugehörige Lektionen

  • Java · Lektion 23 · Fortgeschritten · Version: 2

Quellen