O que é uma tupla: a lista que não muda

A lista que não muda

No módulo 10 você aprendeu a lista, a coleção que cresce, encolhe e troca itens conforme o programa roda. A tupla é a irmã disciplinada dela: também guarda vários valores em ordem, também aceita acesso por índice, mas fecha a porta depois de criada. Nenhum item entra, nenhum sai, nenhum troca de valor. O nome vem do inglês tuple, e a marca registrada dela são os parênteses no lugar dos colchetes.

ponto = (3, 5)
cores_da_bandeira = ("verde", "amarelo", "azul", "branco")

print(ponto)
print(type(ponto))

# Saída:
# (3, 5)
# <class 'tuple'>

Duas tuplas: um par de coordenadas e as cores da bandeira. O type confirma: tuple.

Por que alguém iria querer uma coleção travada? Porque nem todo dado deveria mudar. As coordenadas de um ponto no mapa, o par dia e mês de um aniversário, os nomes dos meses do ano: são informações que formam um bloco fechado. Guardar isso numa lista funciona, mas deixa a porta aberta para um erro seu, dez linhas depois, trocar um valor sem querer. A tupla transforma esse acidente em erro visível na hora.

Acessar pode, mudar não: o TypeError

Ler uma tupla é idêntico a ler uma lista. O primeiro item mora no índice 0, o segundo no 1, e o índice negativo conta de trás para a frente. Até o len funciona igual. Tudo o que você treinou com listas no módulo passado vale aqui, desde que seja leitura.

cores_da_bandeira = ("verde", "amarelo", "azul", "branco")

print(cores_da_bandeira[0])
print(cores_da_bandeira[-1])
print(len(cores_da_bandeira))

# Saída:
# verde
# branco
# 4

Índice, índice negativo e len: a leitura da tupla é igualzinha à da lista.

A diferença aparece na primeira tentativa de escrita. Troque um item, e o Python interrompe o programa com um TypeError explicando, em bom inglês técnico, que tupla não aceita atribuição de item. Rode o exemplo abaixo no Playground para ver o erro de perto; conhecer a mensagem agora evita o susto depois.

cores_da_bandeira = ("verde", "amarelo", "azul", "branco")
cores_da_bandeira[0] = "roxo"

# TypeError: 'tuple' object does not support item assignment
# Tradução: o objeto tupla não aceita atribuição de item.

A tentativa de mudança derruba o programa na hora, apontando a linha exata.

Esse erro é a tupla fazendo o trabalho dela. Imagine um programa de entregas em que as coordenadas do depósito são fixas. Se elas morarem numa lista, qualquer linha distraída pode sobrescrevê-las e mandar o entregador para o bairro errado, sem nenhum aviso. Na tupla, a linha distraída explode com TypeError no primeiro teste, e você corrige antes de qualquer estrago. Erro cedo e barulhento vale mais que erro silencioso.

Desempacotamento: a tupla que vira variáveis

A tupla tem um truque de conveniência que você vai usar o resto da trilha: o desempacotamento. Em vez de acessar ponto[0] e ponto[1] em duas linhas, você declara duas variáveis de uma vez e o Python distribui os valores na ordem. O código fica mais curto e, principalmente, mais legível: x e y contam uma história que ponto[0] e ponto[1] escondem.

ponto = (3, 5)
x, y = ponto

print(f"A posição horizontal é {x} e a vertical é {y}")

# Saída:
# A posição horizontal é 3 e a vertical é 5

Uma linha, duas variáveis: x recebe o primeiro valor da tupla, y recebe o segundo.

A única regra é o pareamento: o número de variáveis do lado esquerdo precisa bater com o número de itens da tupla. Duas variáveis para uma tupla de três itens geram ValueError, com a mensagem too many values to unpack, ou seja, valores demais para desempacotar. Como sempre, o Python avisa a linha e o motivo.

data_de_aniversario = (14, "março")
dia, mes = data_de_aniversario

print(f"O aniversário é dia {dia} de {mes}")

# Saída:
# O aniversário é dia 14 de março

O desempacotamento também funciona com tipos misturados: um número e um texto.