Usar argumentos nomeados e valores padrão

Você já conhece a diferença entre parâmetros e argumentos. Em uma chamada com argumentos posicionais, o primeiro argumento é associado ao primeiro parâmetro, o segundo argumento ao segundo parâmetro e assim por diante.

Na chamada, "Caio" ocupa a posição de nome, enquanto "Bom dia" ocupa a posição de saudacao.

Compare as associações por posição e por nome.

Em uma chamada totalmente nomeada, escreva nome=valor para indicar diretamente qual parâmetro receberá o argumento. Como a associação depende dos nomes, você pode mudar a ordem dos argumentos nomeados sem mudar o resultado.

As duas chamadas fornecem os mesmos valores aos mesmos parâmetros.

Na definição, escreva parâmetro=valor para estabelecer um valor padrão. Um parâmetro sem padrão é obrigatório; um parâmetro com padrão pode ser omitido na chamada. Em assinaturas simples, coloque primeiro os parâmetros obrigatórios e depois os que possuem padrão.

texto é obrigatório. prefixo e final possuem valores padrão.

Observe que o mesmo sinal = desempenha papéis diferentes conforme o lugar em que aparece.

Quando um argumento opcional é omitido, a função usa o padrão da definição. Quando o argumento é fornecido, o valor recebido substitui o padrão somente naquela chamada.

Em uma chamada simples, escreva primeiro os argumentos posicionais e depois os nomeados. Os posicionais preenchem os parâmetros na ordem; cada argumento nomeado seleciona, pelo nome, um parâmetro que ainda não foi preenchido.

O texto é obrigatório. prefixo e final têm valores padrão.

Na chamada do exemplo, o argumento posicional ocupa o primeiro parâmetro. O argumento nomeado salta diretamente para final, enquanto prefixo conserva seu padrão.

Um parâmetro obrigatório pode ser fornecido pelo nome. Se todos os argumentos forem nomeados, a ordem deles na chamada pode mudar. Isso permite escolher uma opção posterior sem informar as opções anteriores.

Compare o preenchimento dos parâmetros em cada chamada.

Para diagnosticar uma chamada, leia primeiro a assinatura e marque quais parâmetros já receberam valores. Procure um obrigatório vazio, um nome inexistente, dois valores destinados ao mesmo parâmetro ou um argumento posicional colocado depois de um nomeado.

Todas as chamadas inválidas estão comentadas para que o arquivo possa ser executado. Descomente apenas uma, execute e volte a comentá-la antes de testar a próxima. O último caso precisa permanecer isolado: seu SyntaxError impede que o Python execute qualquer parte do arquivo.

Use os encaixes para distinguir as quatro causas: espaço obrigatório vazio, nome sem encaixe, duas setas para o mesmo espaço e argumento posicional atravessando a barreira criada por um nomeado.

As linhas permanecem comentadas porque são inválidas. Reescreva cada chamada de modo que texto receba "Falha" e prefixo receba "ERRO", sem alterar a definição da função.

A expressão usada como valor padrão é avaliada quando a instrução def é executada — não a cada chamada. O objeto obtido nesse momento fica armazenado como padrão e é reutilizado quando o argumento correspondente é omitido.

Por isso, reatribuir depois a variável usada na definição não atualiza automaticamente o padrão.

Observe a ordem de execução e compare as duas chamadas finais.

Como visto no step anterior, o valor padrão é avaliado quando a instrução def é executada. Portanto, historico=[] cria uma única lista. Se uma chamada omite esse argumento, o parâmetro recebe uma referência para essa mesma lista padrão.

Execute o código completo sem redefinir a função entre as chamadas:

Em cada chamada, historico é um nome local. Porém, criar novamente esse nome não cria outra lista: nas chamadas que omitem o argumento, ele aponta para o mesmo objeto armazenado como padrão. A chamada termina, mas esse objeto continua associado à definição da função.

As três chamadas acessam a mesma lista. Cada append acrescenta um cartão ao objeto compartilhado, fazendo seu conteúdo crescer.

O mesmo risco aparece quando um dicionário ou conjunto é usado como padrão e modificado pela função. Atualizar um dicionário ou adicionar elementos a um conjunto altera o objeto reutilizado pelas próximas chamadas que omitirem o argumento.

Primeiro, preveja cada linha impressa. Depois, execute o código no seu computador sem redefinir a função.

Em vez de usar uma lista como valor padrão, use None como marcador. Dentro da função, is None indica que uma nova lista deve ser criada. Se o chamador fornecer uma lista, a função usa essa mesma lista — mesmo que ela esteja vazia.

A lista é criada durante cada chamada que recebe o marcador, e não durante a definição da função.

O teste separa duas situações: criar uma lista nova ou continuar com a lista recebida.

Com essa definição, omitir destino e fornecer None explicitamente têm o mesmo efeito: uma lista nova é criada. Já uma lista fornecida pertence ao chamador e continua sendo o mesmo objeto após a chamada.

Copie o código para seu editor e observe tanto o conteúdo quanto as verificações de identidade.

A função deve receber uma mensagem obrigatória, usar "INFO" como prefixo padrão e adicionar o texto formatado a uma lista. Quando destino for omitido ou receber None, ela deve criar uma lista nova.

Copie o código-base para seu editor e substitua os três comentários # complete antes de executar.

Complete somente as três linhas indicadas.

A assinatura coloca o parâmetro obrigatório primeiro. prefixo pode ser substituído sem informar destino, e destino=None evita a reutilização acidental de uma lista entre chamadas.

Compare esta versão com a que você completou.

Quando o destino é None, cada chamada segue para uma lista recém-criada. Quando uma lista é fornecida, a função usa e modifica esse mesmo objeto.

Mantenha a função no mesmo arquivo e acrescente as chamadas abaixo. Antes de executar, preveja quais listas serão independentes e quais chamadas modificarão a mesma lista.

Este trecho verifica o padrão, a substituição por nome, None explícito e uma lista fornecida pelo chamador.