HOWTO · Python
Converter lista em conjunto em Python
Ele demonstra como converter uma lista em um conjunto em Python.
Nesta página
Para converter uma lista em um conjunto, passe-a ao construtor integrado set() do Python, por exemplo, com set(my_list).
O resultado contém uma única ocorrência de cada valor distinto que seja hasheável. Uma lista mantém suas posições e valores repetidos; um conjunto é mutável, contém elementos únicos e hasheáveis e não garante uma ordem de iteração. Use um conjunto quando a unicidade e as verificações de pertencimento forem mais importantes que a posição ou a repetição.
Por que converter uma lista em conjunto altera os dados
Uma lista como ["tea", "coffee", "tea"] registra três itens em uma ordem definida. Ao convertê-la em conjunto, os valores distintos são mantidos, mas a repetição de "tea" e a estrutura posicional da lista são descartadas. Um conjunto pode conter valores de tipos diferentes, desde que cada valor seja hasheável, como strings, números e tuplas formadas por valores hasheáveis. O conjunto em si pode ser alterado, mas seus elementos precisam ser hasheáveis; listas e dicionários não podem ser elementos de um conjunto.
Converter uma lista em conjunto com set()
Chame set(iterable) para criar um conjunto a partir de um iterável, como uma lista ou tupla. Com uma entrada sem repetições, como [1, 2, 3], a conversão mantém os três valores. Uma lista com tipos mistos, como [1, "two", (3, 4)], também é válida, pois inteiros, strings e tuplas formadas por valores hasheáveis podem coexistir em um conjunto. Estes exemplos convertem as duas entradas; verificações de pertencimento permitem conferir o resultado misto sem depender da ordem:
O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.
unique_values = [1, 2, 3]
unique_set = set(unique_values)
assert unique_set == {1, 2, 3}
mixed_values = [1, "two", (3, 4)]
mixed_set = set(mixed_values)
assert len(mixed_set) == 3
assert 1 in mixed_set and "two" in mixed_set and (3, 4) in mixed_set
As asserções verificam os elementos do conjunto sem depender da ordem de iteração.
Use este exemplo para ver como os valores repetidos na entrada afetam a quantidade de resultados distintos:
Execute este exemplo:
values = [3, 1, 3, 2]
converted = set(values)
print(len(converted))
3
A conversão mantém uma cópia de cada valor; portanto, o comprimento corresponde à quantidade de valores distintos na entrada. Essa quantidade é determinística, embora a exibição do próprio conjunto possa apresentar os valores em ordens diferentes. Chamar set() sem argumento cria um conjunto vazio.
Lidar com duplicatas, ordem e itens que não são hasheáveis
Os valores duplicados são eliminados durante a conversão. Não dependa da ordem em que um conjunto é percorrido e não use indexação nem fatiamento nele. Se precisar de valores únicos mantendo a ordem em que aparecem pela primeira vez, mantenha uma lista e registre separadamente os valores já vistos, ou escolha uma abordagem que preserve a ordem e seja adequada aos seus dados.
Todo elemento passado a set() precisa ser hasheável. Por exemplo, não é possível converter diretamente uma lista que contém outra lista, porque a lista interna não é hasheável; o Python gera TypeError. Se os valores internos representarem registros, escolha qual chave hasheável deve definir a unicidade e então crie o conjunto a partir dessas chaves ou de representações imutáveis adequadas. Tuplas só funcionam quando todos os seus elementos são hasheáveis.
Quando é adequado converter uma lista em conjunto
Faça a conversão quando as duplicatas forem indesejadas, a ordem não importar e todos os valores forem hasheáveis. Isso é útil para remover tags repetidas ou verificar se um valor aparece entre opções distintas. Mantenha a lista original se o código posterior depender da ordem, das ocorrências repetidas ou das posições associadas a cada valor. Converter de volta com list(my_set) cria uma lista, mas não restaura as repetições nem a ordem original descartadas pelo conjunto.