Submódulo 3: Funções: definição, parâmetros, retorno e escopo

🎯 Definição de Funções: por que usar e como começar

Vamos entender o conceito central por trás das funções: encapsular uma tarefa com um nome significativo para reutilizá-la e manter o código organizado. Imagine que você precisa somar dois números várias vezes no mesmo programa; em vez de repetir o código, criamos uma função chamada soma. Em Python, definimos funções com a palavra-chave def, seguida pelo nome da função, um conjunto de parâmetros entre parênteses e dois pontos. O corpo da função fica indentado, e o valor de retorno é especificado com return. Exemplo básico: def soma(a, b): return a + b. Ao chamar soma(3, 5), obtemos 8 como resultado imediato. (1)

def soma(a, b):
    """Retorna a soma de dois números."""
    return a + b

Notas importantes: o nome da função deve ser descritivo e o corpo da função deve realizar apenas uma tarefa bem definida. Docstrings ajudam a documentar o propósito da função para quem lê o código, por exemplo: def soma(a, b): """Retorna a soma de dois números.""". (2)

Além disso, o escopo define onde as variáveis existem. Variáveis criadas dentro da função são locais e não alteram o estado do módulo por padrão. Este é um ponto crucial para evitar efeitos colaterais indesejados. (3)