Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti