База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Character.toUpperCase(char): преобразуване на една кодова единица UTF-16 в главна буква

Методът връща една стойност `char`. Подходящ е за първата кодова единица UTF-16 в низ, но не и за произволна кодова точка на Unicode или цяла графема.

Версия: Java SE 21

Синтаксис

public static char toUpperCase(char ch)

В Java SE 21 Character.toUpperCase(char) е статичен метод на java.lang.Character. Той приема една 16-битова кодова единица UTF-16 и връща една стойност char: съответната главна буква, ако има такова съответствие, или първоначалната стойност. Методът не използва езикови настройки (Locale) и не може да върне няколко знака.

При непразен низ text.charAt(0) прочита първата кодова единица, затова Character.toUpperCase(text.charAt(0)) избира варианта с параметър char. Операторът + долепва остатъка от низа, върнат от text.substring(1). Първо провери text.isEmpty(): при празен низ charAt(0) хвърля IndexOutOfBoundsException.

Допълнителна кодова точка на Unicode заема две кодови единици UTF-16 (сурогатна двойка), а charAt(0) може да върне само първата. За преобразуване на една кодова точка използвай text.codePointAt(0) и Character.toUpperCase(int). Този вариант поддържа и допълнителни кодови точки, но пак връща само една. Разширен графемен клъстер, например буква, последвана от комбиниращ знак за ударение, може да включва няколко кодови точки. За да обработиш целия клъстер, първо намери границата му, например с регулярния израз \X.

За преобразуване на целия низ в главни букви използвай String.toUpperCase(Locale): избери Locale за съответния език или Locale.ROOT за текст, независим от езика. Вариантът без аргумент използва Locale по подразбиране. Дължината може да се промени: например ß може да стане SS.

Примери

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

Резултат

Hello
char: U+10428
int: U+10400

В `hello` се променя само началното `h`. За буквата от азбуката Дезерет вариантът с `char` оставя U+10428 непроменена, а вариантът с `int` връща съответната главна буква U+10400. Шестнадесетичният изход не изисква конзолата да изобразява глифовете на Дезерет.

Свързани уроци

  • Java · Урок 1 · Средно · Версия: 2

Източници