WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.codePointAt — Codepoint an einem UTF-16-Index

String.codePointAt gibt einen int zurück, der einen Codepoint darstellt, erwartet jedoch einen UTF-16-Codeeinheitenindex und keine Codepoint-Position.

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

Syntax

public int codePointAt(int index)

String.codePointAt(int index) liest den Wert an einem UTF-16-Codeeinheitenindex (char). Das Ergebnis ist ein int, anders als bei charAt.

Ist die ausgewählte Einheit ein High-Surrogat, auf das ein Low-Surrogat folgt, setzt die Methode das Paar zusammen. Andernfalls gibt sie den Wert des ausgewählten char zurück, auch bei einem ungepaarten Surrogat. Die Auswahl eines Low-Surrogats sucht nicht rückwärts nach dem Anfang des Paars.

Es muss 0 <= index && index < text.length() gelten. Bei einer Verletzung wird IndexOutOfBoundsException ausgelöst; ein leerer String hat keinen gültigen Index.

Im Beispiel belegt das Paar \uD83D\uDE00 zwei Indizes: Bei 1 erhältst du 128512, bei 2 dagegen den Wert des Low-Surrogats 56832.

Beispiele

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(text.codePointAt(0));
        System.out.println(text.codePointAt(1));
        System.out.println(text.codePointAt(2));
    }
}

Ergebnis

4
65
128512
56832

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