CKTIS / Java
Character.toUpperCase(char): convertir una unidad UTF-16 a mayúscula
El método devuelve un solo `char`. Sirve para convertir la primera unidad de código UTF-16 de una cadena, no un punto de código Unicode arbitrario ni un grafema completo.
Versión: Java SE 21
Sintaxis
public static char toUpperCase(char ch)En Java SE 21, Character.toUpperCase(char) es un método estático de java.lang.Character. Recibe una unidad de código UTF-16 de 16 bits y devuelve un solo char: su equivalente en mayúscula si existe esa correspondencia, o el valor original en caso contrario. No usa reglas de configuración regional (Locale) ni puede devolver varios caracteres.
En una cadena no vacía, text.charAt(0) lee la primera unidad de código, por lo que Character.toUpperCase(text.charAt(0)) selecciona la sobrecarga char. El operador + concatena el resultado con el resto de la cadena que devuelve text.substring(1). Comprueba antes text.isEmpty(): en una cadena vacía, charAt(0) lanza IndexOutOfBoundsException.
Un punto de código Unicode suplementario ocupa dos unidades UTF-16 (un par sustituto); charAt(0) solo puede devolver la primera. Para convertir un punto de código, usa text.codePointAt(0) y Character.toUpperCase(int). Esta sobrecarga admite puntos de código suplementarios, pero sigue devolviendo uno solo. Un clúster de grafemas extendido, como una letra seguida de un acento combinante, puede abarcar varios puntos de código. Para operar sobre todo el clúster, localiza primero su límite, por ejemplo con la expresión regular \X.
Para poner toda la cadena en mayúsculas, usa String.toUpperCase(Locale): elige el Locale del idioma o Locale.ROOT para texto independiente del idioma. La versión sin argumentos usa el Locale predeterminado. La longitud puede cambiar: por ejemplo, ß puede convertirse en SS.
Ejemplos
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);
}
}Resultado
Hello char: U+10428 int: U+10400
En `hello` solo cambia la `h` inicial. Para la letra del alfabeto deseret, la sobrecarga `char` deja U+10428 intacto, mientras que la sobrecarga `int` devuelve la mayúscula U+10400. La salida hexadecimal no requiere que la consola muestre glifos deseret.
Lecciones relacionadas
- Java · Lección 1 · Intermedio · Versión: 2