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