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

CKTIS / Java

String.codePoints — un flujo de puntos de código Unicode

String.codePoints() devuelve un IntStream y combina los pares de sustitutos UTF-16, en lugar de procesar cada unidad char por separado.

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

Sintaxis

public IntStream codePoints()
// Usage: text.codePoints()

String.codePoints() devuelve un IntStream de valores de puntos de código. Combina los pares de sustitutos válidos en un único valor int.

Las demás unidades UTF-16, incluidos los sustitutos sin pareja, se transmiten como valores int no negativos. Por tanto, no rechaza las secuencias de sustitutos mal formadas.

length() cuenta las unidades UTF-16, mientras que chars() las emite por separado. En el ejemplo, el par \uD83D\uDE00 produce el valor 128512: cuatro unidades forman tres elementos del flujo. El número de puntos de código no tiene por qué coincidir con el número de caracteres que perciben los usuarios.

Ejemplos

import java.util.Arrays;

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(Arrays.toString(text.codePoints().toArray()));
    }
}

Resultado

4
[65, 128512, 66]

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