Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.codePointAt — punto di codice a un indice UTF-16

String.codePointAt restituisce un int che rappresenta un punto di codice, ma accetta un indice di unità di codice UTF-16, non la posizione ordinale di un punto di codice.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

public int codePointAt(int index)

String.codePointAt(int index) legge il valore all’indice di un’unità di codice UTF-16 (char). Il risultato è un int, a differenza di quello di charAt.

Se l’unità selezionata è un surrogato alto seguito da un surrogato basso, il metodo combina la coppia. Altrimenti restituisce il valore del char selezionato, anche se è un surrogato non appaiato. Selezionare un surrogato basso non torna indietro all’inizio della coppia.

È necessario che valga 0 <= index && index < text.length(). In caso contrario viene lanciata IndexOutOfBoundsException; una stringa vuota non ha indici validi.

Nell’esempio, la coppia \uD83D\uDE00 occupa due indici: all’indice 1 si ottiene 128512, mentre all’indice 2 si ottiene il valore del surrogato basso 56832.

Esempi

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(text.codePointAt(0));
        System.out.println(text.codePointAt(1));
        System.out.println(text.codePointAt(2));
    }
}

Risultato

4
65
128512
56832

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