CKTIS / Java
String.charAt — Lesen einer UTF-16-Codeeinheit
String.charAt(int index) gibt das char am nullbasierten Index zurück. Es liest eine UTF-16-Codeeinheit, nicht unbedingt ein vollständiges Unicode-Zeichen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
public char charAt(int index)String.charAt(int index) gibt ein char zurück, also eine UTF-16-Codeeinheit. Ein gültiger Index erfüllt 0 <= index && index < text.length(). Die erste Einheit hat den Index 0.
Ein negativer Index oder ein Index, der gleich length() oder größer ist, führt zu IndexOutOfBoundsException. Eine leere Zeichenfolge hat keinen gültigen Index.
Ein Zeichen außerhalb der BMP belegt ein Surrogatpaar. charAt gibt nur eine Einheit dieses Paars zurück. Im Beispiel ist text.charAt(1) das High-Surrogat; text.codePointAt(1) liest den vollständigen Codepunkt. Beide Methoden verwenden Indizes von UTF-16-Codeeinheiten.
Beispiele
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));
}
}Ergebnis
A 4 55357 128512
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.