Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti