WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.codePoints — ein Stream von Unicode-Codepoints

String.codePoints() gibt einen IntStream zurück und fügt UTF-16-Surrogatpaare zusammen, statt jede char-Einheit einzeln zu verarbeiten.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public IntStream codePoints()
// Usage: text.codePoints()

String.codePoints() gibt einen IntStream mit Codepoint-Werten zurück. Gültige Surrogatpaare fügt die Methode zu einem einzigen int-Wert zusammen.

Andere UTF-16-Einheiten, einschließlich ungepaarter Surrogate, werden als nichtnegative int-Werte weitergegeben. Fehlerhafte Surrogatsequenzen werden daher nicht zurückgewiesen.

length() zählt UTF-16-Einheiten, während chars() sie einzeln ausgibt. Im Beispiel ergibt das Paar \uD83D\uDE00 den Wert 128512: Aus vier Einheiten entstehen drei Stream-Elemente. Die Anzahl der Codepoints muss nicht der Anzahl der von Nutzern wahrgenommenen Zeichen entsprechen.

Beispiele

import java.util.Arrays;

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(Arrays.toString(text.codePoints().toArray()));
    }
}

Ergebnis

4
[65, 128512, 66]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen