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

CKTIS / Java

String.length — longueur en unités UTF-16

String.length() renvoie le nombre d’unités de code UTF-16, qui ne correspond pas nécessairement au nombre de caractères visibles par l’utilisateur.

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

Syntaxe

public int length()
text.length()

String.length est une méthode d’instance : l’appel text.length() ne prend aucun argument et renvoie un int. Une chaîne vide renvoie 0.

La méthode compte les unités de code UTF-16, c’est-à-dire les valeurs char. Un caractère Unicode supplémentaire occupe une paire de substituts, ce qui ajoute 2 au résultat. N’interprétez pas ce résultat comme le nombre de caractères visibles par l’utilisateur.

Utilisez text.codePointCount(0, text.length()) pour compter les points de code. Dans l’exemple, A et l’emoji donnent une longueur de 3, mais représentent deux points de code.

Exemples

public class Main {
    public static void main(String[] args) {
        String text = "A\uD83D\uDE00";
        System.out.println(text.length());
        System.out.println(text.codePointCount(0, text.length()));
        System.out.println("".length());
    }
}

Résultat

3
2
0

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