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.