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

CKTIS / Java

String.toLowerCase — converter para minúsculas

String.toLowerCase devolve o texto em minúsculas. A escolha de Locale afeta o resultado; use Locale.ROOT para texto independente do idioma.

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

Sintaxe

public String toLowerCase()
public String toLowerCase(Locale locale)

String.toLowerCase devolve o texto em minúsculas sem modificar o String original. Guarde o valor devolvido se pretender utilizá-lo mais tarde.

toLowerCase() utiliza Locale.getDefault(). A sobrecarga toLowerCase(Locale locale) aplica regras selecionadas explicitamente. Escolha Locale.ROOT para texto independente do idioma; para texto em linguagem natural, escolha a locale adequada.

As regras Unicode nem sempre fazem corresponder um char a um único char, pelo que o comprimento do resultado pode mudar. O exemplo mostra a diferença entre Locale.ROOT e uma Locale turca, bem como o facto de o original permanecer inalterado.

Exemplos

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        String text = "TITLE";
        System.out.println(text.toLowerCase(Locale.ROOT));
        System.out.println(text.toLowerCase(Locale.forLanguageTag("tr")));
        System.out.println(text);
    }
}

Resultado

title
tıtle
TITLE

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