CKTIS / Java
Character.toUpperCase(char): convertire in maiuscolo un’unità UTF-16
Il metodo restituisce un solo `char`. È adatto alla prima unità di codifica UTF-16 di una stringa, ma non a un punto di codice Unicode arbitrario o a un grafema intero.
Versione: Java SE 21
Sintassi
public static char toUpperCase(char ch)In Java SE 21, Character.toUpperCase(char) è un metodo statico di java.lang.Character. Riceve un’unità di codifica UTF-16 a 16 bit e restituisce un solo char: il suo equivalente maiuscolo, se la corrispondenza esiste, altrimenti il valore originale. Non applica le regole delle impostazioni locali (Locale) e non può restituire più caratteri.
In una stringa non vuota, text.charAt(0) legge la prima unità di codifica, quindi Character.toUpperCase(text.charAt(0)) seleziona l’overload char. L’operatore + concatena il risultato con il resto della stringa restituito da text.substring(1). Controlla prima text.isEmpty(): su una stringa vuota, charAt(0) lancia IndexOutOfBoundsException.
Un punto di codice Unicode supplementare occupa due unità UTF-16 (una coppia di surrogati) e charAt(0) può restituire solo la prima. Per convertire un punto di codice, usa text.codePointAt(0) e Character.toUpperCase(int). Questo overload gestisce anche i punti di codice supplementari, ma ne restituisce comunque uno solo. Un cluster grafemico esteso, come una lettera seguita da un accento combinante, può comprendere più punti di codice. Per operare sull’intero cluster, individua prima il suo confine, ad esempio con l’espressione regolare \X.
Per convertire tutta la stringa in maiuscolo, usa String.toUpperCase(Locale): scegli il Locale appropriato per la lingua oppure Locale.ROOT per il testo indipendente dalla lingua. La versione senza argomenti usa il Locale predefinito. La lunghezza può cambiare: ad esempio, ß può diventare SS.
Esempi
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);
}
}Risultato
Hello char: U+10428 int: U+10400
In `hello` cambia solo la `h` iniziale. Per la lettera deseret, l’overload `char` lascia U+10428 invariato, mentre l’overload `int` restituisce la maiuscola U+10400. L’output esadecimale non richiede che la console visualizzi i glifi deseret.
Lezioni correlate
- Java · Lezione 1 · Intermedio · Versione: 2