f-strings: mensagens formatadas do jeito moderno

A f-string em um minuto

Todo programa que você escreveu até aqui termina do mesmo jeito: mostrando um resultado para o usuário. E montar essa mensagem final juntando texto fixo com valores de variáveis é uma tarefa tão constante que o Python ganhou, na versão 3.6, uma ferramenta dedicada a ela. O nome oficial é literal de string formatada, mas o mundo inteiro chama de f-string, por causa da letra que a ativa: um f encostado antes das aspas de abertura.

nome = "Ana"
idade = 30

print(f"Olá, {nome}! Você tem {idade} anos.")
# Olá, Ana! Você tem 30 anos.

O f liga o modo formatado; cada par de chaves é substituído pelo valor da variável.

A leitura é natural: o texto fica inteiro, na ordem em que será exibido, e as chaves marcam os buracos que o Python preenche na hora. Repare num detalhe valioso do exemplo: idade é um número, do tipo int, e mesmo assim entrou na frase sem conversão nenhuma. A f-string transforma qualquer valor em texto automaticamente. Guarde essa cortesia, porque a última seção mostra quanto trabalho ela economiza.

Contas nas chaves e o formato do dinheiro

As chaves aceitam mais que nomes de variáveis: aceitam expressões completas. Uma conta, uma chamada de método, uma f-string consegue avaliar ali dentro e encaixar o resultado no texto. Isso dispensa variáveis intermediárias quando o cálculo é curto.

preco = 25.9
quantidade = 3
nome = "maria"

print(f"Total da compra: {preco * quantidade}")
# Total da compra: 77.69999999999999

print(f"Cliente: {nome.title()}")
# Cliente: Maria

Contas e métodos funcionam dentro das chaves. Mas olhe o total: aquele monte de noves pede socorro.

O total esquisito do exemplo não é defeito da f-string: é o comportamento dos números float que você conheceu no módulo 4, somado a uma exibição sem formato. Nenhum cliente aceita pagar R$ 77.69999999999999. A solução é o especificador de formato: dentro das chaves, depois da expressão, escreva dois-pontos e uma instrução de exibição. A instrução que você mais vai usar na vida é .2f, que significa número com exatamente duas casas decimais, o formato do dinheiro.

preco = 25.9
quantidade = 3
total = preco * quantidade

print(f"Total da compra: R$ {total:.2f}")
# Total da compra: R$ 77.70

print(f"Pi com 4 casas: {3.14159265:.4f}")
# Pi com 4 casas: 3.1416 (repare que ele arredonda, não corta)

O :.2f arredonda para duas casas e completa com zero quando falta dígito: 10.5 vira 10.50.

Uma nota de honestidade brasileira: o .2f usa ponto como separador decimal, no padrão americano, então o resultado sai 77.70 e não 77,70. Para o terminal dos exercícios deste curso, está ótimo. Quando quiser a vírgula, o truque simples é trocar depois de formatar: f"{total:.2f}".replace(".", ","), reaproveitando o método da aula passada. Existe um caminho mais formal, com configuração de localidade, mas ele fica para etapas futuras da trilha.

f-string contra concatenação: por que ela venceu

Você já sabe, desde o módulo 6, que o operador + junta strings: "bom" + " dia" resulta em "bom dia". Então seria justo perguntar por que não montar as mensagens assim. A resposta honesta é que dá para montar, o Python aceita, e muito código antigo faz exatamente isso. Mas compare as duas versões da mesma mensagem e tire a sua conclusão.

nome = "Ana"
idade = 30

# Com concatenação: str() obrigatório e espaços na mão
mensagem1 = "Olá, " + nome + "! Você tem " + str(idade) + " anos."

# Com f-string: o texto inteiro, legível, sem conversão
mensagem2 = f"Olá, {nome}! Você tem {idade} anos."

print(mensagem1 == mensagem2)  # True: o resultado é idêntico

As duas produzem a mesma string. A diferença está no caminho até ela.

O erro mais comum da concatenação merece destaque: esquecer o str() em volta de um número. "Você tem " + idade explode com TypeError, porque o Python se recusa a somar texto com número, exatamente como você viu no módulo 5 ao converter entradas. A f-string elimina essa classe inteira de erro. Por isso a documentação oficial a apresenta como o primeiro recurso de formatação do tutorial, e por isso este curso a adota como padrão daqui até o projeto final. Conhecer o + para juntar strings continua útil, para ler código dos outros e para junções simples de dois pedaços; para mensagens, f-string sempre.