WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.codePointBefore — Codepoint vor einem Index

String.codePointBefore gibt den Unicode-Wert vor einem UTF-16-Codeeinheitenindex zurück und berücksichtigt dabei Surrogatpaare.

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

Syntax

public int codePointBefore(int index)

String.codePointBefore(int index) gibt einen int zurück, der den Codepoint vor index darstellt. Der Index zählt UTF-16-Codeeinheiten (char), nicht Codepoints; der gültige Bereich ist 1 <= index && index <= length().

Ein Low-Surrogat unmittelbar vor dem Index wird mit einem vorausgehenden High-Surrogat kombiniert. Andernfalls gibt die Methode den Wert des einzelnen char zurück, auch wenn es sich um ein Surrogat handelt. Ein Index innerhalb eines Paars wird nicht automatisch korrigiert.

Außerhalb dieses Bereichs wird IndexOutOfBoundsException ausgelöst; ein leerer String hat keinen gültigen Index. Im Beispiel gibt codePointBefore(3) den Wert 128512 zurück, während codePointBefore(2) das High-Surrogat 55357 zurückgibt.

Beispiele

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

Ergebnis

4
128512
55357
65

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