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

CKTIS / Java

String.codePointBefore — point de code avant un index

String.codePointBefore renvoie la valeur Unicode située avant un index d’unité de code UTF-16, en tenant compte des paires de substituts.

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

Syntaxe

public int codePointBefore(int index)

String.codePointBefore(int index) renvoie un int représentant le point de code situé avant index. L’index compte les unités de code UTF-16 (char), et non les points de code ; sa plage valide est 1 <= index && index <= length().

Un substitut bas immédiatement avant l’index est combiné avec un substitut haut qui le précède. Sinon, la méthode renvoie la valeur du char seul, même s’il s’agit d’un substitut. Un index situé au milieu d’une paire n’est pas corrigé automatiquement.

En dehors de cette plage, la méthode lance IndexOutOfBoundsException ; une chaîne vide n’a aucun index valide. Dans l’exemple, codePointBefore(3) renvoie 128512, tandis que codePointBefore(2) renvoie le substitut haut 55357.

Exemples

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

Résultat

4
128512
55357
65

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