Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.toUpperCase — converter para maiúsculas

String.toUpperCase devolve o texto em maiúsculas. A Locale escolhida afeta o resultado; Locale.ROOT aplica regras independentes do idioma.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public String toUpperCase()
public String toUpperCase(Locale locale)

String.toUpperCase devolve o texto em maiúsculas sem alterar o objeto String original. Guarda o valor devolvido se quiseres utilizar o resultado.

toUpperCase() utiliza Locale.getDefault(). A sobrecarga toUpperCase(Locale locale) permite escolher explicitamente as regras. Utiliza Locale.ROOT para texto independente do idioma; para texto apresentado aos utilizadores, escolhe a locale adequada.

A conversão Unicode pode alterar o comprimento: ß transforma-se em SS. Em turco, i transforma-se em İ, não em I. O exemplo demonstra ambas as diferenças e a preservação do original.

Exemplos

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        String text = "stra\u00dfe";
        System.out.println(text.toUpperCase(Locale.ROOT));
        System.out.println(text);
        System.out.println("title".toUpperCase(Locale.forLanguageTag("tr")));
    }
}

Resultado

STRASSE
straße
TİTLE

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes