Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.codePoints — uno stream di punti di codice Unicode

String.codePoints() restituisce un IntStream e combina le coppie di surrogati UTF-16, invece di elaborare separatamente ogni unità char.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

String.codePoints() restituisce un IntStream di valori di punti di codice. Combina le coppie di surrogati valide in un unico valore int.

Le altre unità UTF-16, compresi i surrogati senza coppia, vengono passate come valori int non negativi. Di conseguenza, le sequenze di surrogati non valide non vengono rifiutate.

length() conta le unità UTF-16, mentre chars() le emette separatamente. Nell’esempio, la coppia \uD83D\uDE00 produce il valore 128512: quattro unità formano tre elementi dello stream. Il numero di punti di codice non deve necessariamente corrispondere al numero di caratteri percepiti dagli utenti.

Esempi

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

Risultato

4
[65, 128512, 66]

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti