WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Character.toUpperCase(char): eine UTF-16-Codeeinheit großschreiben

Die Methode liefert genau einen `char`. Sie eignet sich für die erste UTF-16-Codeeinheit eines Strings, aber nicht für einen beliebigen Unicode-Codepunkt oder ein ganzes Graphem.

Version: Java SE 21

Syntax

public static char toUpperCase(char ch)

In Java SE 21 ist Character.toUpperCase(char) eine statische Methode von java.lang.Character. Sie nimmt eine 16-Bit-UTF-16-Codeeinheit entgegen und gibt genau einen char zurück: das entsprechende Großzeichen, falls diese Zuordnung existiert, sonst den ursprünglichen Wert. Die Methode berücksichtigt keine Spracheinstellungen (Locale) und kann nicht mehrere Zeichen zurückgeben.

Bei einem nicht leeren String liest text.charAt(0) die erste Codeeinheit. Damit wählt Character.toUpperCase(text.charAt(0)) die char-Überladung. Der Operator + hängt den Rest des Strings aus text.substring(1) an. Prüfe zuerst text.isEmpty(): Bei einem leeren String löst charAt(0) eine IndexOutOfBoundsException aus.

Ein ergänzender Unicode-Codepunkt benötigt zwei UTF-16-Codeeinheiten (ein Surrogatpaar), von denen charAt(0) nur die erste liefern kann. Verwende für einen einzelnen Codepunkt text.codePointAt(0) und Character.toUpperCase(int). Diese Überladung unterstützt auch ergänzende Codepunkte, liefert aber weiterhin nur einen Codepunkt. Ein erweiterter Graphemcluster, etwa ein Buchstabe mit nachfolgendem kombinierendem Akzent, kann mehrere Codepunkte umfassen. Soll die Operation den ganzen Cluster erfassen, bestimme zuerst seine Grenze, etwa mit dem regulären Ausdruck \X.

Verwende für den ganzen String String.toUpperCase(Locale): Wähle das passende Locale für die Sprache oder Locale.ROOT für sprachneutralen Text. Die Variante ohne Argument verwendet das voreingestellte Locale. Die Länge kann sich ändern: Aus ß kann beispielsweise SS werden.

Beispiele

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

Ergebnis

Hello
char: U+10428
int: U+10400

Bei `hello` ändert sich nur das anfängliche `h`. Beim Deseret-Buchstaben lässt die `char`-Überladung U+10428 unverändert, während die `int`-Überladung den zugehörigen Großbuchstaben U+10400 liefert. Dank der hexadezimalen Ausgabe muss die Konsole keine Deseret-Schriftzeichen darstellen.

Zugehörige Lektionen

  • Java · Lektion 1 · Mittlere Stufe · Version: 2

Quellen