CKTIS / Java
String.charAt — odczyt jednostki UTF-16
String.charAt(int index) zwraca wartość char pod indeksem liczonym od zera. Odczytuje jednostkę UTF-16, niekoniecznie cały znak Unicode.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public char charAt(int index)String.charAt(int index) zwraca char, czyli jednostkę kodową UTF-16. Poprawny indeks spełnia 0 <= index && index < text.length(). Pierwsza jednostka ma indeks 0.
Indeks ujemny lub równy bądź większy od length() powoduje IndexOutOfBoundsException. Pusty napis nie ma poprawnego indeksu.
Znak spoza BMP zajmuje parę surogatów. charAt zwraca tylko jedną jej jednostkę. W przykładzie text.charAt(1) jest starszym surogatem; text.codePointAt(1) odczytuje pełny punkt kodowy. Indeksy obu metod liczą jednostki UTF-16.
Przykłady
public class Main {
public static void main(String[] args) {
String text = "A\uD83D\uDE00B";
System.out.println(text.charAt(0));
System.out.println(text.length());
System.out.println((int) text.charAt(1));
System.out.println(text.codePointAt(1));
}
}Wynik
A 4 55357 128512
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.