CKTIS / Java
String.charAt — lectura de una unidad de código UTF-16
String.charAt(int index) devuelve el char en un índice que empieza en cero. Lee una unidad de código UTF-16, no necesariamente un carácter Unicode completo.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
public char charAt(int index)String.charAt(int index) devuelve un char, es decir, una unidad de código UTF-16. Un índice válido cumple 0 <= index && index < text.length(). La primera unidad tiene el índice 0.
Un índice negativo o igual o superior a length() provoca IndexOutOfBoundsException. Una cadena vacía no tiene ningún índice válido.
Un carácter fuera del BMP ocupa un par de sustitutos. charAt devuelve solo una unidad de ese par. En el ejemplo, text.charAt(1) es el sustituto alto; text.codePointAt(1) lee el punto de código completo. Ambos métodos usan índices de unidades de código UTF-16.
Ejemplos
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));
}
}Resultado
A 4 55357 128512
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.