CKTIS / Java
Character.toUpperCase(char): één UTF-16-code-eenheid omzetten naar hoofdletter
Deze methode geeft één `char` terug. Ze is geschikt voor de eerste UTF-16-code-eenheid van een string, maar niet voor een willekeurig Unicode-codepunt of een volledig grafeem.
Versie: Java SE 21
Syntax
public static char toUpperCase(char ch)In Java SE 21 is Character.toUpperCase(char) een statische methode van java.lang.Character. De methode neemt één 16-bits UTF-16-code-eenheid en geeft één char terug: de overeenkomstige hoofdletter als die omzetting bestaat, anders de oorspronkelijke waarde. De methode houdt geen rekening met taal- of regio-instellingen (Locale) en kan geen meerdere tekens teruggeven.
Bij een niet-lege string leest text.charAt(0) de eerste code-eenheid. Daardoor kiest Character.toUpperCase(text.charAt(0)) de overload met char. De operator + voegt de rest van de string uit text.substring(1) toe. Controleer eerst text.isEmpty(): bij een lege string gooit charAt(0) een IndexOutOfBoundsException.
Een aanvullend Unicode-codepunt neemt twee UTF-16-code-eenheden in beslag (een surrogaatpaar), waarvan charAt(0) alleen de eerste kan teruggeven. Gebruik voor één codepunt text.codePointAt(0) en Character.toUpperCase(int). Deze overload ondersteunt aanvullende codepunten, maar geeft nog steeds maar één codepunt terug. Een uitgebreid grafeemcluster, zoals een letter gevolgd door een combinerend accent, kan meerdere codepunten omvatten. Bepaal eerst de grens als de bewerking het hele cluster moet omvatten, bijvoorbeeld met de reguliere expressie \X.
Gebruik String.toUpperCase(Locale) om de hele string naar hoofdletters om te zetten: kies de Locale voor de gewenste taal, of Locale.ROOT voor taalonafhankelijke tekst. De versie zonder argument gebruikt de standaard-Locale. De lengte kan veranderen: ß kan bijvoorbeeld SS worden.
Voorbeelden
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);
}
}Resultaat
Hello char: U+10428 int: U+10400
Bij `hello` verandert alleen de eerste `h`. Voor de Deseret-letter laat de overload met `char` U+10428 ongewijzigd, terwijl die met `int` de bijbehorende hoofdletter U+10400 teruggeeft. Door de hexadecimale uitvoer hoeft de console geen Deseret-tekens weer te geven.
Gerelateerde lessen
- Java · Les 1 · Gemiddeld · Versie: 2