Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Character.charCount — número de unidades de código UTF-16

Character.charCount(int codePoint) devolve o número de unidades char necessárias para representar um ponto de código em UTF-16: 1 ou 2. O método não valida o argumento, pelo que o resultado não confirma que o valor seja um ponto de código Unicode.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public static int charCount(int codePoint)

Character.charCount(int codePoint) é um método estático que devolve um int. Para um ponto de código válido, determina o número de unidades de código UTF-16 (char): os valores BMP (U+0000–U+FFFF) ocupam uma unidade, enquanto os pontos de código suplementares (U+10000–U+10FFFF) ocupam duas, formando um par de substitutos.

A regra exata é codePoint >= 0x10000 ? 2 : 1. O método não valida o argumento: devolve 1 para -1 e 2 para 0x110000, embora ambos os valores estejam fora do intervalo dos pontos de código Unicode. Se necessário, verifica o intervalo com Character.isValidCodePoint(codePoint).

Não confundas o número de unidades char com o número de pontos de código num texto: o método aceita um único valor int, não uma cadeia inteira. Um valor substituto, como 0xD800, também produz 1; no entanto, um substituto isolado não representa um carácter.

O exemplo mostra um ponto de código BMP normal, o limite entre uma e duas unidades, um ponto de código suplementar e dois argumentos fora do intervalo. O resultado esperado ilustra tanto a regra de contagem como a ausência de validação.

Exemplos

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));
        }
    }
}

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes