HOWTO · Python

Converter um dicionário em uma lista em Python

Este artigo apresenta como converter um dicionário em uma lista em Python.

Nesta página

Um dicionário Python armazena pares de chave e valor. “Converter um dicionário em uma lista” pode significar três resultados diferentes: uma lista de chaves, uma lista de valores ou uma lista de tuplas (key, value). Escolha o formato necessário para a próxima operação; envolva a visão correspondente do dicionário em list() para materializá-la.

Escolha qual parte do dicionário converter

Use keys() quando a lista deve conter as chaves do dicionário, values() para obter os valores e items() para os pares de chave e valor. Os exemplos a seguir usam sempre o mesmo dicionário. Execute cada exemplo Python para conferir o resultado no seu ambiente.

Converta as chaves e os valores do dicionário em listas

keys() e values() são métodos de dicionário. No Python 3, eles fornecem visões, que list() transforma em listas. As listas de chaves e valores seguem a ordem de iteração do dicionário, e seus elementos correspondem posição por posição.

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

dictionary = {"a": "Apple", "b": "Banana", "c": "Cherries", "d": "Dragon Fruit"}

keys = list(dictionary.keys())
values = list(dictionary.values())

print(type(dictionary.keys()))
print(keys)
print(values)

Use list(dictionary) como uma forma mais curta de criar uma lista de chaves. Escolha list(dictionary.keys()) quando mencionar o método deixar a intenção mais clara. Se você só precisa percorrer as chaves ou os valores, pode iterar diretamente pela visão em vez de criar uma lista.

Converta os itens do dicionário em uma lista de tuplas

Para obter pares de chave e valor, chame items() e passe a visão para list(). Cada elemento da lista resultante é uma tupla com dois itens: primeiro a chave, depois seu valor.

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

dictionary = {"a": "Apple", "b": "Banana", "c": "Cherries", "d": "Dragon Fruit"}

pairs = list(dictionary.items())
print(type(dictionary.items()))
print(pairs)

Esta é a abordagem direta quando você precisa de pares. zip(dictionary.keys(), dictionary.values()) também combina as duas sequências do mesmo dicionário, mas não traz benefício para esta tarefa e é mais fácil de usar incorretamente se as entradas vierem de fontes diferentes. Para obter pares comuns de um dicionário, prefira items().

Entenda as visões de dicionário e a ordenação no Python 3

No Python 3, keys(), values() e items() retornam objetos de visão, e não listas. Uma visão é útil para percorrer os elementos; list() cria uma lista separada quando uma lista é necessária. A inspeção de tipo nos exemplos diferencia uma visão de uma lista materializada.

Os exemplos mostram as entradas na ordem de iteração do dicionário, com chaves e valores alinhados. Se você precisar de uma ordem específica, independentemente de como o dicionário foi criado, ordene explicitamente; por exemplo, ordene as chaves antes de usá-las. Não use a ordem exibida por outro dicionário como substituto para definir a ordem exigida pela sua tarefa.

Lide com a compatibilidade com Python 2

iteritems() é um método legado de dicionário do Python 2. Ele não é o exemplo de Python 3 com items() mostrado acima. A sintaxe legada a seguir é apenas ilustrativa; não a execute como código Python 3:

pairs = list(dictionary.iteritems()) (somente Python 2; sintaxe ilustrativa, não é um exemplo para Python 3.)

Para Python 3, use list(dictionary.items()). O exemplo legado fornecido no artigo não dá motivo confiável para afirmar uma ordenação ou exibição de tipo específica no Python 2, por isso esses detalhes foram omitidos. Se você mantém código antigo em Python 2, verifique o comportamento no interpretador e na base de código exatos que utiliza, em vez de presumir que o exemplo de Python 3 se aplica sem alterações.