Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.codePointAt — punkt kodowy pod indeksem UTF-16

String.codePointAt zwraca int reprezentujący punkt kodowy, ale przyjmuje indeks jednostki UTF-16, nie numer punktu kodowego.

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

Składnia

public int codePointAt(int index)

String.codePointAt(int index) odczytuje wartość pod indeksem jednostki UTF-16 (char). Wynik ma typ int, inaczej niż wynik charAt.

Jeśli wskazana jednostka jest wysokim surogatem, a następna niskim, metoda łączy parę. W przeciwnym razie zwraca wartość wskazanego char, także dla niesparowanego surogatu. Indeks niskiego surogatu nie powoduje cofnięcia do początku pary.

Wymagane jest 0 <= index && index < text.length(). Naruszenie zakresu powoduje IndexOutOfBoundsException; pusty napis nie ma poprawnego indeksu.

W przykładzie para \uD83D\uDE00 zajmuje dwa indeksy: pod 1 otrzymasz 128512, a pod 2 wartość niskiego surogatu 56832.

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.codePointAt(0));
        System.out.println(text.codePointAt(1));
        System.out.println(text.codePointAt(2));
    }
}

Wynik

4
65
128512
56832

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

Źródła