Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

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

Character.charCount(int codePoint) devuelve el número de unidades char necesarias para representar un punto de código en UTF-16: 1 o 2. El método no valida el argumento, por lo que su resultado no confirma que el valor sea un punto de código Unicode.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public static int charCount(int codePoint)

Character.charCount(int codePoint) es un método estático que devuelve un int. Para un punto de código válido, determina el número de unidades de código UTF-16 (char): los valores BMP (U+0000–U+FFFF) ocupan una, mientras que los puntos de código suplementarios (U+10000–U+10FFFF) ocupan dos y forman un par sustituto.

La regla exacta es codePoint >= 0x10000 ? 2 : 1. El método no valida el argumento: devuelve 1 para -1 y 2 para 0x110000, aunque ambos valores están fuera del rango de puntos de código Unicode. Si es necesario, comprueba el rango con Character.isValidCodePoint(codePoint).

No confundas el número de unidades char con el número de puntos de código de un texto: el método acepta un único valor int, no una cadena completa. Un valor sustituto como 0xD800 también produce 1; sin embargo, un sustituto aislado no representa un carácter.

El ejemplo muestra un punto de código BMP normal, el límite entre una y dos unidades, un punto de código suplementario y dos argumentos fuera de rango. La salida esperada ilustra tanto la regla de recuento como la ausencia de validación.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes