CKTIS / Java
String.charAt — прочитане на UTF-16 кодова единица
String.charAt(int index) връща char на индекс, броен от нула. Методът чете UTF-16 кодова единица, а не непременно цял Unicode знак.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
public char charAt(int index)String.charAt(int index) връща char, тоест UTF-16 кодова единица. Валидният индекс отговаря на условието 0 <= index && index < text.length(). Първата единица е с индекс 0.
Отрицателен индекс или индекс, равен на length() или по-голям от него, причинява IndexOutOfBoundsException. Празният низ няма валиден индекс.
Знак извън BMP заема сурогатна двойка. charAt връща само една единица от тази двойка. В примера text.charAt(1) е горният сурогат; text.codePointAt(1) прочита пълната кодова точка. И двата метода използват индекси на UTF-16 кодови единици.
Примери
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));
}
}Резултат
A 4 55357 128512
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.