CKTIS / Java
Character.toUpperCase(char): převod jedné jednotky UTF-16 na velké písmeno
Metoda vrací jediný `char`. Hodí se k převodu první kódové jednotky UTF-16 v řetězci, nikoli libovolného kódového bodu Unicode nebo celého grafému.
Verze: Java SE 21
Syntaxe
public static char toUpperCase(char ch)V Java SE 21 je Character.toUpperCase(char) statická metoda třídy java.lang.Character. Přijímá jednu 16bitovou kódovou jednotku UTF-16 a vrací jediný char: odpovídající velké písmeno, pokud takové mapování existuje, jinak původní hodnotu. Nepoužívá jazyková nastavení (Locale) a nemůže vrátit více znaků.
V neprázdném řetězci text.charAt(0) načte první kódovou jednotku, takže Character.toUpperCase(text.charAt(0)) zvolí přetížení pro char. Operátor + připojí zbytek řetězce získaný z text.substring(1). Nejdřív zkontroluj text.isEmpty(): na prázdném řetězci charAt(0) vyvolá IndexOutOfBoundsException.
Doplňkový kódový bod Unicode zabírá dvě jednotky UTF-16 (náhradní pár) a charAt(0) může vrátit jen první z nich. Pro převod jednoho kódového bodu použij text.codePointAt(0) a Character.toUpperCase(int). Toto přetížení zvládá i doplňkové kódové body, ale pořád vrací jen jeden. Rozšířený grafémový shluk, například písmeno následované kombinačním diakritickým znaménkem, se může skládat z více kódových bodů. Chceš-li pracovat s celým shlukem, nejdřív urči jeho hranici, například regulárním výrazem \X.
Pro převod celého řetězce na velká písmena použij String.toUpperCase(Locale): vyber Locale pro daný jazyk nebo Locale.ROOT pro jazykově neutrální text. Verze bez argumentu používá výchozí Locale. Délka výsledku se může změnit: například z ß může vzniknout SS.
Příklady
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);
}
}Výsledek
Hello char: U+10428 int: U+10400
V `hello` se změní jen počáteční `h`. U písmene deseret přetížení pro `char` ponechá U+10428 beze změny, zatímco přetížení pro `int` vrátí velké písmeno U+10400. Díky šestnáctkovému výstupu nemusí konzole zobrazovat znaky písma deseret.
Související lekce
- Java · Lekce 1 · Středně pokročilá · Verze: 2