Python Acessando Itens

Na aula Listas, a Ana guardou a lista de compras inteira numa variável e mostrou tudo de uma vez. Mas, no mercado, ela quer saber um item: "qual é o primeiro da lista?", "e o último?", "em que posição está o café?". Nesta aula você aprende a pegar um item (ou um pedaço da lista) pela sua posição, o índice.

A ideia: os armários numerados

Pense nos armários de guardar bolsa na entrada do mercado. Ficam em fila, um do lado do outro, e cada um tem um número pintado na porta. Para pegar a sua bolsa, você não abre todos: vai direto no número certo.

A lista é essa fileira de armários, e cada item mora num deles. O número da porta é o índice (em inglês, index). Só tem um detalhe, que confunde todo mundo no começo: em Python, o primeiro armário é o número 0, e não o 1.

Por que começar no 0? Pense no índice como "quantos passos andar a partir do começo". Para chegar no primeiro item, você anda 0 passos; para o segundo, 1 passo; e assim por diante. É a mesma regra das letras de um texto, que você viu na aula Índices e Fatias. Uma consequência importante: numa lista de 4 itens, o último índice é 3, e não 4.

1. Pegando um item pelo índice

compras = ["arroz", "feijão", "café", "leite"]
print(compras[0])
print(compras[1])
print(compras[3])
primeiro = compras[0]
print(f"Primeiro da lista: {primeiro}")

compras

A lista de onde você quer tirar o item.

[

Colado no nome da lista, sem espaço, o colchete agora quer dizer "o item da posição…". (Lembre: [ sozinho, depois do =, cria uma lista; colado no nome de uma lista, pega um item dela.)

0

O índice, sempre um número inteiro. Pode ser um número escrito direto ou uma variável que guarde um inteiro.

]

Fecha o índice.

primeiro = compras[0]

O item é um valor como outro qualquer: dá para guardar numa variável, usar numa f-string, numa conta, num if.

$ python3 posicoes.py
arroz
feijão
leite
Primeiro da lista: arroz

compras[0] é o arroz, o primeiro; compras[1] é o feijão, o segundo; compras[3] é o leite, o quarto e último. Repare que o print de um item sozinho mostra o texto sem aspas e sem colchetes: o que sai é o texto arroz, e não uma lista.

2. Do fim para o começo: índices negativos

Quase sempre você quer o último item, mas nem sempre sabe quantos itens a lista tem. O Python resolve isso com índices negativos, que contam a partir do fim: -1 é o último, -2 é o penúltimo.

compras = ["arroz", "feijão", "café", "leite"]
print(compras[-1])
print(compras[-2])
print(compras[len(compras) - 1])

$ python3 ultimo.py
leite
café
leite

A última linha mostra o jeito "longo" de pegar o último item: len(compras) é 4, menos 1 dá 3, o último índice. Funciona, mas compras[-1] diz a mesma coisa de um jeito muito mais curto e claro. Pense no -1 como "um passo para trás a partir do fim". (Não existe -0 para o último: -0 é o mesmo que 0, o primeiro.)

compras = ["arroz", "feijão", "café", "leite", "sabão"]
print(compras[0])

compras = ["arroz", "feijão", "café", "leite", "sabão"]
print(compras[-1])

3. Um pedaço da lista: fatias

Às vezes a Ana quer mais de um item: "os dois primeiros", "do segundo ao terceiro". Para isso existe a fatia (em inglês, slice): lista[início:fim]. O resultado é uma nova lista, com os itens do índice início até o índice fim, sem incluir o fim.

>>> compras = ["arroz", "feijão", "café", "leite", "sabão"]
>>> compras[1:3]
['feijão', 'café']
>>> compras[:2]
['arroz', 'feijão']
>>> compras[2:]
['café', 'leite', 'sabão']
>>> compras[-2:]
['leite', 'sabão']
>>> compras[:]
['arroz', 'feijão', 'café', 'leite', 'sabão']

Por que o fim fica de fora? Porque assim a conta fecha: compras[1:3] tem 3 - 1 = 2 itens, e compras[:2] tem exatamente 2. Os números das fatias funcionam igualzinho aos de um texto (aula Índices e Fatias).

Item × fatia

Compare com cuidado:

>>> compras[0]
'arroz'
>>> compras[0:1]
['arroz']

compras[0] (com um número só) devolve o item: o texto 'arroz'. compras[0:1] (com dois-pontos) devolve uma lista com um item só: ['arroz']. Os colchetes na saída mostram a diferença.

Fatias não dão erro

Uma fatia que passa do fim da lista não reclama: pega o que existe. E uma fatia que começa depois do fim devolve uma lista vazia:

>>> compras[3:100]
['leite', 'sabão']
>>> compras[10:20]
[]

Pulando itens: o passo

Um terceiro número, depois de mais um :, diz de quantos em quantos pegar. Com passo -1, a lista sai de trás para frente:

>>> compras[::2]
['arroz', 'café', 'sabão']
>>> compras[::-1]
['sabão', 'leite', 'café', 'feijão', 'arroz']

[::2] pega um sim, um não (os índices 0, 2 e 4). [::-1] é um jeito curto de ter a lista ao contrário; a aula Ordenando Listas mostra outros.

4. Onde está o café? index() e count()

Até aqui você sabia o índice e queria o item. E quando é o contrário: você sabe o item e quer o índice? A lista tem um método para isso, o index(). Um método é uma função que pertence ao valor e se escreve depois de um ponto: compras.index("café") quer dizer "lista de compras, me diga o índice do café".

compras = ["arroz", "feijão", "café", "leite"]
posicao = compras.index("café")
print(f"O café está na posição {posicao}.")
print(compras.index("açúcar"))

$ python3 procurar.py
O café está na posição 2.
Traceback (most recent call last):
  File "/home/ana/procurar.py", line 4, in <module>
    print(compras.index("açúcar"))
          ~~~~~~~~~~~~~^^^^^^^^^^
ValueError: list.index(x): x not in list

O café está no índice 2, e o programa mostrou isso. Na linha 4, a Ana pediu o índice do açúcar, que não está na lista, e o programa parou com um erro. Você vai ver esse erro com calma em Quando dá errado; o jeito seguro é perguntar antes com in:

compras = ["arroz", "feijão", "café", "leite"]
procurado = "açúcar"
if procurado in compras:
    print(f"{procurado} está na posição {compras.index(procurado)}.")
else:
    print(f"{procurado} não está na lista.")

$ python3 procurar2.py
açúcar não está na lista.

Itens repetidos

Na cesta da padaria, o pão aparece três vezes. O count() ("contar") diz quantas vezes um item aparece, e o index() devolve só a primeira posição. Um segundo número no index() diz a partir de qual índice procurar:

>>> cesta = ["pão", "leite", "pão", "ovos", "pão"]
>>> cesta.count("pão")
3
>>> cesta.count("café")
0
>>> cesta.index("pão")
0
>>> cesta.index("pão", 1)
2

O count() nunca dá erro: se o item não está lá, a resposta é 0. O cesta.index("pão", 1) começou a procurar no índice 1 e achou o próximo pão no índice 2.

compras = ["arroz", "feijão", "café", "leite"]
posicao = 0
print(f"O café está na posição {posicao}.")

compras = ["arroz", "feijão", "café", "leite"]
posicao = compras.index("café")
print(f"O café está na posição {posicao}.")

5. O item de um item

O que você pega de uma lista é um valor comum, então dá para continuar "abrindo" esse valor. Um item que é texto tem letras; um item que é uma lista tem itens.

>>> compras[0][0]
'a'
>>> compras[-1].upper()
'SABÃO'

compras[0] é 'arroz', e o [0] seguinte pega a primeira letra do arroz. compras[-1] é 'sabão', e o .upper() (aula Métodos de Texto) o põe em maiúsculas.

Listas dentro de listas

Uma lista pode guardar outras listas. A professora anotou cada aluno com a sua nota, num par [nome, nota]:

>>> turma = [["Ana", 9.5], ["Bruno", 7.0], ["Carla", 8.0]]
>>> turma[1]
['Bruno', 7.0]
>>> turma[1][0]
'Bruno'
>>> turma[1][1]
7.0
>>> len(turma)
3

turma[1]

O item de índice 1 da turma: o par do Bruno, que é uma lista.

turma[1][0]

Leia da esquerda para a direita: "na turma, o item 1; nele, o item 0". O nome do Bruno.

turma[1][1]

No par do Bruno, o item 1: a nota.

len(turma)

3: a turma tem 3 itens (os 3 pares). O len não conta o que está dentro de cada par.

Isso funciona, mas lembrar que "0 é o nome e 1 é a nota" cansa. Para fichas assim, as aulas Tuplas e Dicionários mostram jeitos mais claros.

Formas diferentes de pegar itens

Quando dá errado

compras = ["arroz", "feijão", "café", "leite"]
print(f"A lista tem {len(compras)} itens.")
print(compras[len(compras)])

$ python3 fora.py
A lista tem 4 itens.
Traceback (most recent call last):
  File "/home/ana/fora.py", line 3, in <module>
    print(compras[len(compras)])
          ~~~~~~~^^^^^^^^^^^^^^
IndexError: list index out of range

>>> compras = ["arroz", "feijão", "café", "leite", "sabão"]
>>> compras[-6]
Traceback (most recent call last):
  File "<python-input-1>", line 1, in <module>
    compras[-6]
    ~~~~~~~^^^^
IndexError: list index out of range

ValueError: list.index(x): x not in list

alunos = ["Ana", "Bruno", "Carla", "Davi", "Eva"]
numero = input("Número na chamada: ")
print(alunos[numero])

$ python3 chamada.py
Número na chamada: 4
Traceback (most recent call last):
  File "/home/ana/chamada.py", line 3, in <module>
    print(alunos[numero])
          ~~~~~~^^^^^^^^
TypeError: list indices must be integers or slices, not str

>>> compras[1.0]
Traceback (most recent call last):
  File "<python-input-2>", line 1, in <module>
    compras[1.0]
    ~~~~~~~^^^^^
TypeError: list indices must be integers or slices, not float

alunos = ["Ana", "Bruno", "Carla", "Davi", "Eva"]
numero = int(input("Número na chamada: "))
posicao = numero - 1
print(f"O número {numero} é {alunos[posicao]}.")

$ python3 chamada2.py
Número na chamada: 4
O número 4 é Davi.
$ python3 chamada2.py
Número na chamada: 9
Traceback (most recent call last):
  File "/home/ana/chamada2.py", line 4, in <module>
    print(f"O número {numero} é {alunos[posicao]}.")
                                 ~~~~~~^^^^^^^^^
IndexError: list index out of range

compras = ["arroz", "feijão", "café", "leite"]
print(compras(0))

$ python3 parenteses.py
Traceback (most recent call last):
  File "/home/ana/parenteses.py", line 2, in <module>
    print(compras(0))
          ~~~~~~~^^^
TypeError: 'list' object is not callable

Referência rápida

Exercícios

Missão final: a chamada da turma

alunos = ["Ana", "Bruno", "Carla", "Davi", "Eva"]
notas = [9.5, 7.0, 8.0, 6.5, 10.0]
numero = input("Número na chamada: ")
posicao = numero
print(f"{alunos[posicao]} tirou {notas[posicao]}")

alunos = ["Ana", "Bruno", "Carla", "Davi", "Eva"]
notas = [9.5, 7.0, 8.0, 6.5, 10.0]
numero = int(input("Número na chamada: "))
posicao = numero - 1
print(f"{alunos[posicao]} tirou {notas[posicao]}")

Repare que as duas listas usam o mesmo índice: o aluno do índice 3 tem a nota do índice 3. É um jeito simples de guardar dados que andam juntos; a aula enumerate() e zip() mostra como percorrer as duas de uma vez.

Resumo

• Cada item tem um índice, e o primeiro é o 0. O último é len(lista) - 1.
• lista[i] pega um item; o resultado é um valor comum, que dá para guardar e usar.
• Índices negativos contam do fim: lista[-1] é o último, lista[-2] o penúltimo.
• lista[a:b] é uma fatia: uma lista nova do índice a até antes do b. Fatias nunca dão erro.
• lista.index(x) diz onde está o item (a primeira vez); lista.count(x) diz quantas vezes ele aparece.
• Índice que não existe: IndexError. Item que não existe no index(): ValueError (pergunte antes com in).
• O índice tem de ser inteiro: o que vem do input() precisa de int().
• Em listas dentro de listas, leia da esquerda para a direita: turma[1][0].