HOWTO · Python

Converter uma lista em minúsculas em Python

Este tutorial discute como converter uma lista em minúsculas em Python.

Nesta página

Para converter todas as strings de uma lista Python para minúsculas, chame o método lower() de cada uma e reúna as strings retornadas. O método altera as letras de cada string; não altera a própria lista. Uma compreensão de lista é uma opção concisa quando você quer criar uma nova lista, enquanto um loop for deixa cada etapa explícita e map() oferece uma alternativa baseada em iterador. Os exemplos abaixo usam a mesma entrada e mostram a saída após cada exemplo executável.

Converter uma lista com um loop for

Um loop for pode criar uma lista de resultados separada sem alterar a lista original. Comece com uma lista para os resultados e acrescente a versão em minúsculas de cada string. str.lower() é o nome do método de string aplicado a cada item.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

original_list = ['Hello', 'WORLD', 'Python', 'Programming']
lowercase_list = []

for item in original_list:
    lowercase_list.append(item.lower())

print(lowercase_list)
['hello', 'world', 'python', 'programming']

Se você precisar atualizar uma lista existente, percorra os índices e atribua cada string retornada de volta à lista, como em for index, item in enumerate(original_list): original_list[index] = item.lower(). Isso altera os elementos da lista, mas não modifica os objetos string; strings são imutáveis, então lower() retorna uma nova string.

Converter uma lista com uma compreensão de lista

Uma compreensão de lista expressa a mesma transformação e cria uma nova lista. Ela costuma ser uma opção legível quando cada item de entrada corresponde diretamente a um item de saída e não são necessárias etapas adicionais.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

original_list = ['Hello', 'WORLD', 'Python', 'Programming']
lowercase_list = [item.lower() for item in original_list]

print(lowercase_list)
['hello', 'world', 'python', 'programming']

A expressão antes de for é avaliada para cada item, e as strings resultantes formam lowercase_list. A lista original continua disponível com as letras em sua capitalização original. Escolha essa forma quando a transformação for simples; se o processamento de cada item exigir várias instruções, um loop explícito pode ser mais fácil de acompanhar.

Converter uma lista com map()

map() aplica uma função a cada item e retorna um iterador. Passar str.lower aplica o método de string a cada item; envolva o iterador em list() quando precisar de uma lista como resultado.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

original_list = ['Hello', 'WORLD', 'Python', 'Programming']
lowercase_list = list(map(str.lower, original_list))

print(lowercase_list)
['hello', 'world', 'python', 'programming']

O iterador é avaliado à medida que seus valores são consumidos, neste caso por list(). Isso é útil quando um iterador é adequado para a próxima operação. Se você precisar de um resultado indexável ou quiser exibir toda a coleção transformada, converta-o em lista como no exemplo. Uma expressão lambda, como map(lambda item: item.lower(), original_list), é outra maneira de expressar a mesma transformação, mas não é necessária aqui. Escolha entre essas formas considerando a clareza e o tipo de resultado de que precisa, sem presumir que uma delas será mais rápida para listas de qualquer tamanho.

Escolher um método e lidar com casos extremos

As três abordagens esperam que cada item da lista seja uma string. Se um item for um número inteiro, None ou outro objeto sem o método lower(), a transformação gera um AttributeError. Decida como lidar com esses valores antes de transformar os dados: valide a entrada, filtre os valores que devem ser ignorados ou converta-os explicitamente em strings, se isso fizer sentido para os dados. Uma conversão indiscriminada pode alterar o significado, portanto nem sempre é apropriada.

Uma string vazia continua vazia após lower(), e uma lista de entrada vazia produz um resultado vazio com qualquer uma dessas abordagens. lower() converte as letras de acordo com o comportamento de strings Unicode do Python; não é uma etapa genérica de normalização de texto específica de um idioma ou região. Para converter para maiúsculas, use o método correspondente upper() seguindo os mesmos padrões.

Use uma compreensão para criar uma lista compacta, um loop quando o controle explícito ou a atribuição na própria lista forem úteis e map() quando um iterador se encaixar no restante do código. Todas as opções aplicam o mesmo método de string; as principais diferenças práticas são a legibilidade, manter ou atualizar a lista de entrada e precisar ou não converter map() em uma lista.