CKTIS / Java
Character.toUpperCase(char) : mettre en majuscule une unité UTF-16
Cette méthode renvoie un seul `char`. Elle convient à la première unité de code UTF-16 d’une chaîne, mais pas à un point de code Unicode arbitraire ni à un graphème entier.
Version : Java SE 21
Syntaxe
public static char toUpperCase(char ch)Dans Java SE 21, Character.toUpperCase(char) est une méthode statique de java.lang.Character. Elle reçoit une unité de code UTF-16 de 16 bits et renvoie un seul char : son équivalent majuscule si cette correspondance existe, sinon la valeur d’origine. Elle ne tient pas compte des paramètres régionaux (Locale) et ne peut pas renvoyer plusieurs caractères.
Pour une chaîne non vide, text.charAt(0) lit la première unité de code : Character.toUpperCase(text.charAt(0)) choisit donc la surcharge char. L’opérateur + concatène le résultat avec le reste de la chaîne fourni par text.substring(1). Vérifiez d’abord text.isEmpty() : sur une chaîne vide, charAt(0) déclenche une IndexOutOfBoundsException.
Un point de code Unicode supplémentaire occupe deux unités UTF-16 (une paire de substituts). charAt(0) ne peut en renvoyer que la première. Pour convertir un point de code, utilisez text.codePointAt(0) et Character.toUpperCase(int). Cette surcharge traite aussi les points de code supplémentaires, mais ne renvoie toujours qu’un seul point de code. Un graphème étendu, tel qu’une lettre suivie d’un accent combinant, peut couvrir plusieurs points de code. Pour traiter le graphème entier, repérez d’abord sa limite, par exemple avec l’expression régulière \X.
Pour mettre toute la chaîne en majuscules, utilisez String.toUpperCase(Locale) : choisissez le Locale adapté à la langue, ou Locale.ROOT pour un texte indépendant de la langue. La version sans argument utilise le Locale par défaut. La longueur peut changer : par exemple, ß peut devenir SS.
Exemples
import java.util.Locale;
public class Main {
static String uppercaseFirstCodeUnit(String text) {
if (text.isEmpty()) {
return text;
}
return Character.toUpperCase(text.charAt(0)) + text.substring(1);
}
public static void main(String[] args) {
System.out.println(uppercaseFirstCodeUnit("hello"));
String deseret = "\uD801\uDC28"; // U+10428
int afterChar = uppercaseFirstCodeUnit(deseret).codePointAt(0);
int afterCodePoint = Character.toUpperCase(deseret.codePointAt(0));
System.out.printf(Locale.ROOT, "char: U+%X%nint: U+%X%n", afterChar, afterCodePoint);
}
}Résultat
Hello char: U+10428 int: U+10400
Dans `hello`, seul le `h` initial change. Pour la lettre déséret, la surcharge `char` laisse U+10428 inchangé, tandis que la surcharge `int` renvoie sa majuscule U+10400. Grâce à la sortie hexadécimale, la console n’a pas besoin d’afficher les glyphes déséret.
Leçons associées
- Java · Leçon 1 · Intermédiaire · Version : 2