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

CKTIS / Java

String.codePointAt — point de code à un indice UTF-16

String.codePointAt renvoie un int représentant un point de code, mais attend un indice d’unité de code UTF-16 et non un rang de point de code.

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

Syntaxe

public int codePointAt(int index)

String.codePointAt(int index) lit la valeur à un indice d’unité de code UTF-16 (char). Son résultat est un int, contrairement à celui de charAt.

Si l’unité sélectionnée est un substitut haut suivi d’un substitut bas, la méthode combine la paire. Sinon, elle renvoie la valeur du char sélectionné, y compris pour un substitut isolé. Sélectionner un substitut bas ne remonte pas jusqu’au début de la paire.

La condition requise est 0 <= index && index < text.length(). Si elle n’est pas respectée, une IndexOutOfBoundsException est levée ; une chaîne vide n’a aucun indice valide.

Dans l’exemple, la paire \uD83D\uDE00 occupe deux indices : l’indice 1 donne 128512, tandis que l’indice 2 donne la valeur du substitut bas 56832.

Exemples

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00B";
        System.out.println(text.length());
        System.out.println(text.codePointAt(0));
        System.out.println(text.codePointAt(1));
        System.out.println(text.codePointAt(2));
    }
}

Résultat

4
65
128512
56832

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