Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Character.toUpperCase(char): wielka litera w jednej jednostce UTF-16

Metoda zwraca pojedynczy `char`. Nadaje się do zmiany pierwszej jednostki UTF-16 napisu, ale nie obsługuje dowolnego punktu kodowego Unicode ani całego grafemu.

Wersja: Java SE 21

Składnia

public static char toUpperCase(char ch)

W Java SE 21 Character.toUpperCase(char) to statyczna metoda klasy java.lang.Character. Przyjmuje jedną 16-bitową jednostkę kodową UTF-16 i zwraca jeden char: jej odpowiednik w postaci wielkiej litery, jeśli istnieje w tym odwzorowaniu, albo tę samą wartość. Metoda nie uwzględnia ustawień językowych (Locale) i nie może zwrócić kilku znaków.

Dla niepustego napisu text.charAt(0) pobiera pierwszą jednostkę kodową, więc Character.toUpperCase(text.charAt(0)) wybiera przeciążenie z char. Operator + dołącza resztę napisu, zwróconą przez text.substring(1). Najpierw sprawdź text.isEmpty(): dla pustego napisu charAt(0) zgłasza IndexOutOfBoundsException.

Punkt kodowy spoza podstawowej płaszczyzny wielojęzycznej zajmuje dwie jednostki UTF-16 (parę surogatów), a charAt(0) może zwrócić tylko pierwszą z nich. Aby przekształcić jeden punkt kodowy, użyj text.codePointAt(0) i Character.toUpperCase(int). To przeciążenie obsługuje także dodatkowe punkty kodowe, ale nadal zwraca tylko jeden. Rozszerzony klaster grafemów, na przykład litera z dołączonym znakiem akcentu, może obejmować kilka punktów kodowych. Jeśli operacja ma objąć cały klaster, najpierw wyznacz jego granicę, np. wzorcem \X.

Aby zamienić cały napis na wielkie litery, użyj String.toUpperCase(Locale): wybierz ustawienia odpowiednie dla języka lub Locale.ROOT dla tekstu niezależnego od języka. Wersja bez argumentu korzysta z domyślnych ustawień językowych. Wynik może zmienić długość, np. ß może przejść w SS.

Przykłady

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

Wynik

Hello
char: U+10428
int: U+10400

Dla `hello` zmienia się tylko początkowe `h`. Dla litery alfabetu Deseret przeciążenie z `char` pozostawia punkt kodowy U+10428 bez zmian, a przeciążenie z `int` zwraca wielką literę U+10400. Zapis szesnastkowy nie wymaga wyświetlania glifów tego alfabetu.

Powiązane lekcje

  • Java · Lekcja 1 · Średniozaawansowany · Wersja: 2

Źródła