CKTIS / Java
String.charAt — čtení jednotky kódu UTF-16
String.charAt(int index) vrací char na indexu počítaném od nuly. Čte jednotku kódu UTF-16, nikoli nutně celý znak Unicode.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public char charAt(int index)String.charAt(int index) vrací char, tedy jednotku kódu UTF-16. Platný index splňuje 0 <= index && index < text.length(). První jednotka má index 0.
Záporný index nebo index rovný či větší než length() způsobí IndexOutOfBoundsException. Prázdný řetězec nemá žádný platný index.
Znak mimo BMP je v UTF-16 reprezentován párem zástupných jednotek. charAt vrací pouze jednu jednotku z této dvojice. V příkladu text.charAt(1) vrátí horní zástupnou jednotku; text.codePointAt(1) přečte celý kódový bod. Obě metody používají indexy jednotek kódu UTF-16.
Příklady
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));
}
}Výsledek
A 4 55357 128512
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.