Padrões de projeto em Python

Padrão de projeto Iterator em Python

Nesta lição, você vai usar o padrão Iterator para percorrer uma coleção sem precisar saber como os dados são guardados por dentro.

  • Avançado
  • 2 min de leitura
  • 1 exemplo executável

Introdução

O problema

O código que percorre uma coleção não deveria precisar saber como ela é guardada: uma lista, uma árvore, um arquivo ou valores calculados na hora. O laço for do Python funciona com qualquer objeto que siga o protocolo de iteração.

Pense assim

Um iterador é como o dispensador de senhas no balcão de uma padaria. Cada puxada dá o próximo número. Você não vê como os números são guardados lá dentro. Só continua puxando até o dispensador dizer que acabou.

Do dispensador de senhas ao código
for number in Countdown(3):🎫 Puxe senhas até acabar
__iter__⚙️ O mecanismo do dispensador
yield current➡️ Entregue o próximo número
while current > 0:🏁 Pare quando não sobrar número
Os valores vêm um de cada vez; o armazenamento fica escondido.
Em uma frase

O padrão Iterator dá acesso sequencial aos elementos de uma coleção sem mostrar como eles são guardados. Em Python, um objeto é iterável quando o seu método __iter__ devolve um iterador.

Pontos-chave

  1. Countdown(3) guarda só o número inicial.
  2. __iter__ é o que o laço for chama para começar a iterar.
  3. Como contém yield, __iter__ devolve um gerador que produz 3, 2 e 1, um de cada vez.
  4. O laço para sozinho quando o gerador termina.

Quando usar?

  • Fazer suas próprias coleções funcionarem com for, list(), sum() e compreensões.
  • Produzir valores sob demanda em vez de montar uma lista inteira na memória.
  • Esconder como os dados são guardados ou calculados.

Quando não é preciso

  • Uma lista ou range simples já resolve.
  • Você precisa de acesso aleatório por posição: um iterador só anda para a frente.

Código de exemplo

Executar código →
main.py
class Countdown:
    # Iterator: traverse values without exposing representation details.
    def __init__(self, start): self.start = start

    def __iter__(self):
        # Yield values without exposing collection storage.
        current = self.start
        while current > 0:
            yield current
            current -= 1


for number in Countdown(3):
    print(number)
Gerar um botão Run para este exemplo

Resultado da execução

3
2
1

Explicação do código

A classe Countdown implementa o método __iter__ como um gerador (generator). A cada yield, o gerador entrega um valor e pausa até o laço pedir o próximo. Por isso, o laço for number in Countdown(3) imprime 3, 2 e 1, nessa ordem.

Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.

Exercícios práticos

Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.

  1. Substitua o domínio do exemplo preservando a estrutura do padrão.
  2. Compare o padrão com uma implementação mais simples e explique as diferenças.
  3. Escreva testes para cada participante antes de adicionar outra implementação.
Executar no compilador Python →

Erros comuns

Devolver uma lista em __iter__

__iter__ precisa devolver um iterador, não uma lista.

Problema
def __iter__(self):
    return [3, 2, 1]  # TypeError
Correção
def __iter__(self):
    return iter([3, 2, 1])

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios