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.