CKTIS / Java
String.charAt — lire une unité de code UTF-16
String.charAt(int index) renvoie le char à un index commençant à zéro. Il lit une unité de code UTF-16, pas nécessairement un caractère Unicode complet.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public char charAt(int index)String.charAt(int index) renvoie un char, c’est-à-dire une unité de code UTF-16. Un index valide satisfait 0 <= index && index < text.length(). La première unité porte l’index 0.
Un index négatif ou égal à length() ou supérieur à cette valeur provoque IndexOutOfBoundsException. Une chaîne vide ne possède aucun index valide.
Un caractère situé hors du BMP occupe une paire de substituts. charAt ne renvoie qu’une seule unité de cette paire. Dans l’exemple, text.charAt(1) est le substitut haut ; text.codePointAt(1) lit le point de code complet. Les deux méthodes utilisent des index d’unités de code UTF-16.
Exemples
public class Main {
public static void main(String[] args) {
String text = "A\uD83D\uDE00B";
System.out.println(text.charAt(0));
System.out.println(text.length());
System.out.println((int) text.charAt(1));
System.out.println(text.codePointAt(1));
}
}Résultat
A 4 55357 128512
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.