Verificando se um item existe: in, count e index

in e not in: a pergunta de uma palavra

Está na lista? Essa pergunta minúscula sustenta uma quantidade enorme de programas: o produto está no carrinho, o nome está entre os convidados, o e-mail já foi cadastrado. Em Python, ela se escreve quase como se fala: "café" in compras. O resultado é um bool dos bons e velhos módulos 4 e 6: True se o valor estiver lá, False se não. E como devolve bool, o in se encaixa direto no if, sem cerimônia.

compras = ["arroz", "feijão", "café"]

print("café" in compras)      # Saída: True
print("banana" in compras)    # Saída: False
print("banana" not in compras)  # Saída: True

in responde True ou False. O not in inverte: verdadeiro quando o item está ausente.

O not in merece um parágrafo próprio, porque iniciante costuma escrever a negação do jeito torto: not ("banana" in compras), com parênteses e tudo. Funciona, mas o Python tem a forma dedicada, que lê como inglês: "banana" not in compras. Use-a sempre que a ação acontecer na AUSÊNCIA do item: avisar que o produto não foi encontrado, adicionar um nome só se ainda não estiver na lista, cobrar um ingrediente que falta.

Contando com count() e localizando com index()

O in responde SE o valor existe; às vezes a pergunta é QUANTAS vezes. Numa lista de votos, quantos foram para a Ana? Numa lista de notas, quantos alunos tiraram 10? O método count responde: votos.count("Ana"). Se o valor não aparece nenhuma vez, ele devolve 0, sem drama e sem erro, o que o torna seguro de chamar a qualquer momento.

votos = ["Ana", "Bruno", "Ana", "Carla", "Ana"]

print(votos.count("Ana"))     # Saída: 3
print(votos.count("Bruno"))   # Saída: 1
print(votos.count("Diego"))   # Saída: 0  (não existe, e tudo bem)

count() conta as ocorrências do valor. Zero ocorrências devolve 0, nunca erro.

Já o index responde ONDE: a posição da PRIMEIRA ocorrência do valor. votos.index("Bruno") devolve 1, o índice dele. É a ponte entre o mundo dos valores e o mundo dos índices, útil quando você precisa da posição para alterar ou combinar com pop. Mas atenção ao contrato dele: se o valor não existir, o index não devolve -1 nem None; ele levanta ValueError, o mesmo erro do remove da aula 4. A defesa é a mesma de lá: pergunte com in antes de chamar.

votos = ["Ana", "Bruno", "Ana"]

print(votos.index("Bruno"))   # Saída: 1
print(votos.index("Ana"))     # Saída: 0  (a PRIMEIRA Ana)

# votos.index("Diego")  ->  ValueError: 'Diego' is not in list
if "Diego" in votos:
    print(votos.index("Diego"))
else:
    print("Diego não recebeu votos.")
# Saída: Diego não recebeu votos.

index() aponta a primeira ocorrência. Para valores que podem faltar, o in na frente evita o ValueError.

Decisões com listas: o if encontra o in

A combinação if + in é onde este módulo encontra o módulo 7 e o programa começa a parecer gente grande. Pense num caixa de mercado em código: se o produto está no carrinho, remove; senão, avisa que não foi encontrado. Ou num cadastro que não aceita nome repetido: só adiciona se o nome not in lista. São duas linhas de lógica que separam um programa frágil, que quebra com ValueError, de um programa educado, que conversa com o usuário.

carrinho = ["arroz", "feijão", "café"]
produto = input("Qual produto deseja tirar do carrinho? ")

if produto in carrinho:
    carrinho.remove(produto)
    print(f"{produto} removido! Restam {len(carrinho)} itens.")
else:
    print(f"{produto} não está no carrinho.")

# Digitando café:   café removido! Restam 2 itens.
# Digitando pizza:  pizza não está no carrinho.

if + in blindando o remove: o programa responde bem tanto ao item que existe quanto ao que não existe.

Faça o inventário do módulo até aqui: criar listas, acessar e alterar por índice, adicionar com append e insert, remover com remove, pop e del, percorrer com for e enumerate, somar e comparar, e agora conferir existência, contar e localizar. É exatamente o conjunto de peças de um gerenciador de itens de verdade. A próxima aula não ensina peça nova: ela monta todas essas numa lista de compras interativa com menu, o programa mais completo do curso até agora. Respire e vem.