Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Character.charCount — numero di unità di codice UTF-16

Character.charCount(int codePoint) restituisce il numero di unità char necessarie per rappresentare un punto di codice in UTF-16: 1 oppure 2. Il metodo non convalida l’argomento, quindi il risultato non conferma che il valore sia un punto di codice Unicode.

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

Sintassi

public static int charCount(int codePoint)

Character.charCount(int codePoint) è un metodo statico che restituisce un int. Per un punto di codice valido, determina il numero di unità di codice UTF-16 (char): i valori BMP (U+0000–U+FFFF) ne usano una, mentre i punti di codice supplementari (U+10000–U+10FFFF) ne usano due, formando una coppia di surrogati.

La regola esatta è codePoint >= 0x10000 ? 2 : 1. Il metodo non convalida l’argomento: restituisce 1 per -1 e 2 per 0x110000, anche se entrambi i valori sono fuori dall’intervallo dei punti di codice Unicode. Se necessario, controlla l’intervallo con Character.isValidCodePoint(codePoint).

Non confondere il numero di unità char con il numero di punti di codice nel testo: il metodo accetta un singolo valore int, non un’intera stringa. Anche un valore surrogato come 0xD800 produce 1; tuttavia, un surrogato isolato non rappresenta un carattere.

L’esempio mostra un normale punto di codice BMP, il confine tra una e due unità, un punto di codice supplementare e due argomenti fuori intervallo. L’output previsto illustra sia la regola di conteggio sia l’assenza di convalida.

Esempi

public class Main {
    public static void main(String[] args) {
        int[] values = {0x0041, 0xFFFF, 0x10000, 0x1F600, -1, 0x110000};
        for (int codePoint : values) {
            System.out.println(codePoint + " -> " + Character.charCount(codePoint));
        }
    }
}

Risultato

65 -> 1
65535 -> 1
65536 -> 2
128512 -> 2
-1 -> 1
1114112 -> 2

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