KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.codePoints — een stream van Unicode-codepoints

String.codePoints() geeft een IntStream terug en voegt UTF-16-surrogaatparen samen, in plaats van elke char-eenheid afzonderlijk te verwerken.

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

Syntax

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

String.codePoints() geeft een IntStream met codepointwaarden terug. Geldige surrogaatparen worden gecombineerd tot één int-waarde.

Andere UTF-16-eenheden, waaronder ongepaarde surrogaten, worden doorgegeven als niet-negatieve int-waarden. Ongeldige surrogaatsequenties worden dus niet afgewezen.

length() telt UTF-16-eenheden, terwijl chars() ze afzonderlijk oplevert. In het voorbeeld levert het paar \uD83D\uDE00 de waarde 128512 op: vier eenheden vormen drie stream-elementen. Het aantal codepoints hoeft niet gelijk te zijn aan het aantal tekens dat gebruikers ervaren.

Voorbeelden

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

Resultaat

4
[65, 128512, 66]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen