Jogos de cartas

Uma list é uma coleção mutável de itens em sequência. Tal como a maioria das coleções (ver os tipos incorporados tuple, dict e set), as listas podem conter referências a qualquer tipo de dados (ou a vários), incluindo outras listas. Tal como qualquer sequência, podes aceder aos itens através de um número de 0-based index a partir da esquerda e de -1-based index a partir da direita. As listas podem ser copiadas na totalidade ou em parte através de notação de fatias ou de <list>.copy().

As listas suportam operações de sequência comuns e mutáveis, tais como min()/max(), <list>.index(), <list>.append() e <list>.reverse(). Os elementos de uma lista podem ser percorridos com a construção for item in <list>. Podes usar for index, item in enumerate(<list>) quando precisas tanto do índice como do valor do elemento.

Nos bastidores, as lists são implementadas como arrays dinâmicos, semelhantes ao tipo ArrayList do Java, e são usadas sobretudo para guardar grupos de dados semelhantes (strings, números, sets, etc.) de comprimento desconhecido. As listas são uma estrutura de dados extremamente flexível e útil, e muitos métodos e operações incorporados no Python produzem listas como resultado.

Construção

Uma list pode ser declarada como um literal com parênteses retos [] e vírgulas entre os elementos:

>>> no_elements = []

>>> no_elements
[]

>>> one_element = ["Guava"]

>>> one_element
['Guava']

>>> elements_separated_with_commas = ["Parrot", "Bird", 334782]

>>> elements_separated_with_commas
['Parrot', 'Bird', 334782]

Para maior legibilidade, podes usar quebras de linha quando há muitos elementos ou estruturas de dados aninhadas dentro de uma list:

>>> lots_of_entries = [
      "Rose",
      "Sunflower",
      "Poppy",
      "Pansy",
      "Tulip",
      "Fuchsia",
      "Cyclamen",
      "Lavender"
   ]
   
>>> lots_of_entries
['Rose', 'Sunflower', 'Poppy', 'Pansy', 'Tulip', 'Fuchsia', 'Cyclamen', 'Lavender']

# Each data structure is on its own line to help clarify what they are.
>>> nested_data_structures = [
      {"fish": "gold", "monkey": "brown", "parrot": "grey"},
      ("fish", "mammal", "bird"),
      ['water', 'jungle', 'sky']
   ]
   
>>> nested_data_structures
[{'fish': 'gold', 'monkey': 'brown', 'parrot': 'grey'}, ('fish', 'mammal', 'bird'), ['water', 'jungle', 'sky']]

O construtor list() pode ser usado sem argumentos ou com um iterável como argumento. O construtor percorre os elementos do iterável e adiciona-os à list pela ordem em que aparecem:

>>> no_elements = list()

>>> no_elements
[]

# The tuple is unpacked and each element is added.
>>> multiple_elements_from_tuple = list(("Parrot", "Bird", 334782))

>>> multiple_elements_from_tuple
['Parrot', 'Bird', 334782]

# The set is unpacked and each element is added.
>>> multiple_elements_from_set = list({2, 3, 5, 7, 11})

>>> multiple_elements_from_set
[2, 3, 5, 7, 11]

Os resultados de usar o construtor list com uma string ou um dict podem ser surpreendentes:

# String elements (Unicode code points) are iterated through and added *individually*.
>>> multiple_elements_string = list("Timbuktu")

>>> multiple_elements_string
['T', 'i', 'm', 'b', 'u', 'k', 't', 'u']

# Unicode separators and positioning code points are also added *individually*.
>>> multiple_code_points_string = list('अभ्यास')

>>> multiple_code_points_string
['अ', 'भ', '्', 'य', 'ा', 'स']

# The iteration default for dictionaries is over the keys, so only key data is inserted into the list.
>>> source_data = {"fish": "gold", "monkey": "brown"}

>>> multiple_elements_dict_1 = list(source_data)
['fish', 'monkey']

Como o construtor list só aceita iteráveis (ou nada) como argumentos, os objetos que não são iteráveis provocam um erro de tipo. Por isso, é muito mais fácil criar uma list com um único item através do método literal.

# Numbers are not iterable, and so attempting to create a list with a number passed to the constructor fails.
>>> one_element = list(16)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'int' object is not iterable

# Tuples *are* iterable, so passing a one-element tuple to the constructor does work, but it's awkward
>>> one_element_from_iterable = list((16,))

>>> one_element_from_iterable
[16]

Aceder aos elementos

Podes aceder aos itens dentro das listas (bem como aos itens de outros tipos de sequência, str e tuple) através de 0-based index e de notação de parênteses retos. Os índices podem ir da left --> right (a começar em zero) ou da right --> left (a começar em -1).

índice a partir da esquerda ⟹

0 👇🏾 1 👇🏾 2 👇🏾 3 👇🏾 4 👇🏾 5 👇🏾 P y t h o n 👆🏾 -6 👆🏾 -5 👆🏾 -4 👆🏾 -3 👆🏾 -2 👆🏾 -1

⟸ índice a partir da direita

>>> breakfast_foods = ["Oatmeal", "Fruit Salad", "Eggs", "Toast"]

# Oatmeal is at index 0 or index -4.
>>> breakfast_foods[0]
'Oatmeal'

>>> breakfast_foods[-4]
'Oatmeal'

# Eggs are at index -2 or 2
>>> breakfast_foods[-2]
'Eggs'

>>> breakfast_foods[2]
'Eggs'

# Toast is at -1
>>> breakfast_foods[-1]
'Toast'

Podes aceder a uma secção dos elementos dentro de uma list através da notação de fatias (<list>[start:stop]). Uma fatia é definida como uma sequência de elementos na posição index, tal que start <= index < stop. O fatiamento devolve uma cópia dos itens "fatiados" e não modifica a list original.

Também podes usar um parâmetro step em [start:stop:step] para "saltar" ou filtrar os elementos da list (por exemplo, um step de 2 seleciona um elemento sim, outro não, dentro do intervalo):

>>> colors = ["Red", "Purple", "Green", "Yellow", "Orange", "Pink", "Blue", "Grey"]

# If there is no step parameter, the step is assumed to be 1.
>>> middle_colors = colors[2:6]

>>> middle_colors
['Green', 'Yellow', 'Orange', 'Pink']

# If the start or stop parameters are omitted, the slice will
# start at index zero, and will stop at the end of the list.
>>> primary_colors = colors[::3]

>>> primary_colors
['Red', 'Yellow', 'Blue']

Trabalhar com listas

Usar a função incorporada sum() numa lista devolve a soma de todos os números da lista:

>>> number_list = [1, 2, 3, 4]
>>> sum(number_list)
10

Também podes obter o comprimento de uma lista com a função len():

>>> long_list = ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J"]
>>> len(long_list)
10

As listas também podem ser combinadas de várias formas:

# Using the plus + operator unpacks each list and creates a new list, but it is not efficient.
>>> new_via_concatenate = ["George", 5] + ["cat", "Tabby"]

>>> new_via_concatenate
['George', 5, 'cat', 'Tabby']

# Likewise, using the multiplication operator * is the equivalent of using + n times.
>>> first_group = ["cat", "dog", "elephant"]
>>> multiplied_group = first_group * 3

>>> multiplied_group
['cat', 'dog', 'elephant', 'cat', 'dog', 'elephant', 'cat', 'dog', 'elephant']

As listas fornecem um iterador e podem ser percorridas da mesma forma que outros tipos de sequência.

#  Looping through the list and printing out each element.
>>> colors = ["Orange", "Green", "Grey", "Blue"]

>>> for item in colors:
...     print(item)
...
Orange
Green
Grey
Blue

Para uma explicação mais aprofundada sobre loops e iterators, completa o conceito loops.