Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.codePoints — un flux de points de code Unicode

String.codePoints() renvoie un IntStream et combine les paires de substituts UTF-16 au lieu de traiter séparément chaque unité char.

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

Syntaxe

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

String.codePoints() renvoie un IntStream de valeurs de points de code. La méthode combine les paires de substituts valides en une seule valeur int.

Les autres unités UTF-16, y compris les substituts non appariés, sont transmises sous forme de valeurs int non négatives. Les séquences de substituts mal formées ne sont donc pas rejetées.

length() compte les unités UTF-16, tandis que chars() les émet séparément. Dans l’exemple, la paire \uD83D\uDE00 produit la valeur 128512 : quatre unités forment trois éléments du flux. Le nombre de points de code n’est pas nécessairement égal au nombre de caractères perçus par les utilisateurs.

Exemples

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

Résultat

4
[65, 128512, 66]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources