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

CKTIS / Java

String.codePoints — um fluxo de pontos de código Unicode

String.codePoints() devolve um IntStream e combina pares de substitutos UTF-16, em vez de processar cada unidade char separadamente.

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

Sintaxe

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

String.codePoints() devolve um IntStream de valores de pontos de código. Combina pares de substitutos válidos num único valor int.

As restantes unidades UTF-16, incluindo substitutos sem par, são transmitidas como valores int não negativos. Por isso, sequências de substitutos mal formadas não são rejeitadas.

length() conta unidades UTF-16, enquanto chars() as emite separadamente. No exemplo, o par \uD83D\uDE00 produz o valor 128512: quatro unidades formam três elementos do fluxo. O número de pontos de código não tem necessariamente de corresponder ao número de caracteres que os utilizadores percecionam.

Exemplos

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]

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