Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.codePointBefore — punkt kodowy przed indeksem

String.codePointBefore zwraca wartość Unicode przed indeksem jednostek UTF-16, uwzględniając pary surogatów.

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

Składnia

public int codePointBefore(int index)

String.codePointBefore(int index) zwraca int opisujący punkt kodowy przed index. Indeks liczy jednostki UTF-16 (char), nie punkty kodowe; poprawny zakres to 1 <= index && index <= length().

Jeśli przed indeksem znajduje się dolny surogat poprzedzony górnym, metoda łączy parę. W przeciwnym razie zwraca wartość pojedynczego char, także surogatu. Indeks wewnątrz pary nie jest automatycznie poprawiany.

Poza zakresem metoda zgłasza IndexOutOfBoundsException; pusty napis nie ma poprawnego indeksu. W przykładzie codePointBefore(3) zwraca 128512, natomiast codePointBefore(2) zwraca górny surogat 55357.

Przykłady

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

Wynik

4
128512
55357
65

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła