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.