Parâmetros com valor padrão

O que é um valor padrão

No Básico você criou funções em que todo parâmetro precisava ser informado. Se a função pedia dois valores, você tinha que passar os dois, sempre. Muitas vezes, porém, existe um valor que serve na maioria dos casos. Uma função que formata dinheiro quase sempre usa Real. Uma que cumprimenta quase sempre diz Olá. Repetir esse valor a cada chamada é chato e abre espaço para erro. O parâmetro com valor padrão resolve isso: você define o valor combinado uma vez, na função, e quem chama só informa quando quer algo diferente.

def saudar(nome, saudacao="Olá"):
    return f"{saudacao}, {nome}!"

print(saudar("Ana"))            # Olá, Ana!
print(saudar("Bruno", "Bom dia")) # Bom dia, Bruno!

A mesma função serve para o caso comum e para o caso especial, sem duplicar código.

Repare que saudar foi chamada de duas formas com a mesma definição. Na primeira, só o nome foi informado e o Python completou com Olá. Na segunda, quem chamou passou a saudação e o padrão ficou de lado. Um único parâmetro padrão dobrou a flexibilidade da função sem nenhuma linha a mais. É esse ganho, multiplicado por vários parâmetros, que deixa as funções realmente reaproveitáveis.

Por que a ordem dos parâmetros importa

Existe uma regra firme: todo parâmetro com valor padrão precisa vir depois dos parâmetros sem padrão. O motivo é lógico. O Python casa os argumentos que você passa com os parâmetros na ordem em que aparecem. Se um parâmetro opcional viesse antes de um obrigatório, o interpretador não teria como saber qual valor pertence a qual, e o programa ficaria ambíguo. Por isso o Python nem deixa: tentar definir assim dá erro já na leitura do arquivo.

# Errado: parametro com padrao antes de um sem padrao
def formatar(moeda="BRL", valor):
    return f"{moeda} {valor:.2f}"
# SyntaxError: non-default argument follows default argument
# O Python recusa o arquivo inteiro antes de rodar.

Padrão antes de obrigatório é erro de sintaxe: o Python nem executa.

def formatar(valor, moeda="BRL"):
    return f"{moeda} {valor:.2f}"

print(formatar(19.9))          # BRL 19.90
print(formatar(19.9, "USD"))   # USD 19.90

Certo: o obrigatório (valor) primeiro, o opcional (moeda) depois.

Fixando parâmetros padrão

Antes de seguir, vale amarrar a ideia. Parâmetros padrão existem para o caso comum: você define o valor mais provável uma vez e deixa quem chama sobrescrever quando precisa. A ordem obrigatória depois de opcional não é capricho, é o que permite ao Python casar cada argumento com o parâmetro certo sem ambiguidade. Guardando esses dois pontos, você já escreve funções bem mais convenientes de usar.