Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Character.toUpperCase(char): converter uma unidade UTF-16 em maiúscula

O método devolve um único `char`. Serve para converter a primeira unidade de código UTF-16 de uma cadeia, não um ponto de código Unicode arbitrário nem um grafema completo.

Versão: Java SE 21

Sintaxe

public static char toUpperCase(char ch)

Em Java SE 21, Character.toUpperCase(char) é um método estático de java.lang.Character. Recebe uma unidade de código UTF-16 de 16 bits e devolve um único char: o seu equivalente em maiúscula, se existir essa correspondência, ou o valor original. Não segue regras de configuração regional (Locale) e não pode devolver vários caracteres.

Numa cadeia não vazia, text.charAt(0) lê a primeira unidade de código, pelo que Character.toUpperCase(text.charAt(0)) seleciona a sobrecarga char. O operador + concatena o resultado com o resto da cadeia devolvido por text.substring(1). Verifica primeiro text.isEmpty(): numa cadeia vazia, charAt(0) lança IndexOutOfBoundsException.

Um ponto de código Unicode suplementar ocupa duas unidades UTF-16 (um par de substitutos) e charAt(0) só pode devolver a primeira. Para converter um ponto de código, usa text.codePointAt(0) e Character.toUpperCase(int). Esta sobrecarga suporta pontos de código suplementares, mas continua a devolver um só. Um grupo de grafemas estendido, como uma letra seguida de um acento combinante, pode abranger vários pontos de código. Para operar sobre o grupo inteiro, determina primeiro o seu limite, por exemplo com a expressão regular \X.

Para converter toda a cadeia em maiúsculas, usa String.toUpperCase(Locale): escolhe o Locale adequado ao idioma ou Locale.ROOT para texto independente do idioma. A versão sem argumentos usa o Locale predefinido. O comprimento pode mudar: por exemplo, ß pode passar a SS.

Exemplos

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);
    }
}

Resultado

Hello
char: U+10428
int: U+10400

Em `hello`, só muda o `h` inicial. Para a letra do alfabeto deseret, a sobrecarga `char` mantém U+10428, enquanto a sobrecarga `int` devolve a maiúscula U+10400. A saída hexadecimal dispensa a apresentação de glifos deseret na consola.

Lições relacionadas

  • Java · Lição 1 · Intermédio · Versão: 2

Fontes