CKTIS / Java
String.charAt — lettura di un’unità di codice UTF-16
String.charAt(int index) restituisce il char all’indice a base zero. Legge un’unità di codice UTF-16, non necessariamente un carattere Unicode completo.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
public char charAt(int index)String.charAt(int index) restituisce un char, cioè un’unità di codice UTF-16. Un indice valido soddisfa 0 <= index && index < text.length(). La prima unità ha indice 0.
Un indice negativo oppure uguale o maggiore di length() causa IndexOutOfBoundsException. Una stringa vuota non ha indici validi.
Un carattere al di fuori del BMP occupa una coppia di surrogati. charAt restituisce solo una delle unità della coppia. Nell’esempio, text.charAt(1) è il surrogato alto; text.codePointAt(1) legge il punto di codice completo. Entrambi i metodi usano indici di unità di codice UTF-16.
Esempi
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));
}
}Risultato
A 4 55357 128512
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.