Criando funções com def: anatomia completa

A anatomia: quatro peças, nenhuma opcional

Criar uma função tem uma receita fixa, e cada peça dela tem um motivo. Começa com a palavra-chave def, que avisa o Python: uma função vai ser definida aqui. Depois vem o nome que você escolhe, seguindo as mesmas regras das variáveis do módulo 4: letras minúsculas, números e underline, sem espaço e sem acento. Depois do nome, um par de parênteses, que por enquanto fica vazio. A linha fecha com dois pontos, o mesmo sinal que você já usa no if e no while para anunciar um bloco. E abaixo, indentado com 4 espaços, vem o corpo: as linhas que a função executa.

def saudar():
    print("Olá! Bem-vindo ao programa.")
    print("Vamos começar?")

# def       -> palavra-chave que inicia a definição
# saudar    -> nome escolhido por você (regras de variável)
# ()        -> parênteses, vazios por enquanto
# :         -> dois pontos anunciam o bloco
# 4 espaços -> corpo da função (o que ela faz)

A anatomia completa. As duas linhas indentadas pertencem à função.

A indentação aqui funciona igual à do if e à do while, que você domina desde os módulos 7 e 8: ela diz onde o bloco começa e onde termina. Tudo que estiver indentado abaixo do def pertence à função. A primeira linha que voltar à margem esquerda já está fora dela. Um deslize de indentação muda o significado do programa, então mantenha o padrão de 4 espaços que o curso usa desde o início. Sobre o nome: escolha um verbo que diga o que a função faz, como saudar, calcular_media ou imprimir_cabecalho. Um bom nome economiza comentário.

A pegadinha clássica: definir não é executar

Agora a pegadinha que derruba praticamente todo iniciante na primeira semana de funções. Digite o código abaixo no Playground e execute. Prepare-se para uma surpresa: a tela fica vazia.

def saudar():
    print("Olá! Bem-vindo ao programa.")

# Executou? A saída fica VAZIA.
# O def apenas GUARDA a função na memória.
# Ninguém mandou executar ainda.

O programa rodou sem erro e não mostrou nada. Está tudo certo: definir é só guardar.

Não é defeito, é o comportamento correto. O def apenas ensina a receita ao Python: guarda o bloco na memória, associado ao nome saudar, e segue em frente sem executar linha nenhuma do corpo. É como anotar a receita do bolo no caderno: o caderno anotado não produz bolo. Para o bolo existir, alguém precisa abrir o caderno e cozinhar. No Python, esse ato é a chamada: o nome da função seguido de parênteses.

def saudar():
    print("Olá! Bem-vindo ao programa.")

saudar()
saudar()

# Olá! Bem-vindo ao programa.
# Olá! Bem-vindo ao programa.

Uma definição, duas chamadas, duas execuções. Esse é o ciclo completo.

Repare no que aconteceu: o corpo foi escrito uma vez e executou duas, porque houve duas chamadas. Quando o Python encontra saudar(), ele pula para dentro da função, executa o corpo linha por linha e, ao terminar, volta para o ponto onde estava e continua o programa. Esse vai e volta é o coração do módulo inteiro, e vale digitar o exemplo no Playground para ver com os próprios olhos.

A ordem importa: definir antes de chamar

Falta uma regra para fechar a anatomia: a definição precisa vir antes da primeira chamada. O Python lê o arquivo de cima para baixo, e só conhece a função depois de passar pela linha do def. Se a chamada aparecer antes, ele encontra um nome que ainda não existe e para com um NameError, o mesmo erro de quando você usa uma variável antes de criá-la.

saudar()

def saudar():
    print("Olá!")

# NameError: name 'saudar' is not defined
# Na linha 1, o Python ainda não conhece a função.

Chamada antes da definição: o Python lê de cima para baixo e não adivinha o futuro.

Por isso, o costume que você vai ver em todo código bem organizado: as definições de função ficam agrupadas no topo do arquivo, e o programa principal, a sequência de chamadas, fica no final. Essa organização vira o assunto central da aula 6. Por enquanto, grave o resumo da anatomia: def nome(): na primeira linha, corpo com 4 espaços, definição antes da chamada, e a certeza de que nada executa até alguém escrever o nome com parênteses.