Dominando
Funções em Python

copiardef saudacao():
    print("Olá!")

saudacao()   # chama a função

copiardef nome_da_funcao(parametros):
    # código
    return resultado

copiardef somar(a, b):     # a, b são parâmetros
    return a + b

resultado = somar(2, 3)   # 2, 3 são argumentos
print(resultado)              # 5

copiardef saudacao(nome):
    print(f"Olá {nome}")

saudacao("Igor")    # obrigatório passar o argumento

copiardef saudacao(nome="Visitante"):
    print(f"Olá {nome}")

saudacao()             # Olá Visitante
saudacao("Igor")      # Olá Igor

copiardef pessoa(nome, idade):
    print(nome, idade)

pessoa(idade=25, nome="Igor")   # ordem não importa

copiardef soma(*numeros):             # recebe qualquer qtd
    return sum(numeros)

print(soma(1, 2, 3, 4))        # 10
print(soma(10, 20))              # 30

copiardef mostrar_dados(**dados):
    for chave, valor in dados.items():
        print(chave, valor)

mostrar_dados(nome="Igor", idade=25, cidade="SP")

nome Igor
idade 25
cidade SP

copiardef soma(a, b):
    return a + b

resultado = soma(3, 4)
print(resultado)   # 7

copiardef teste():
    print("oi")

print(teste())   # oi
                 # None

copiardef operacoes(a, b):
    return a + b, a * b    # retorna uma tupla

soma, mult = operacoes(2, 3)
print(soma, mult)          # 5 6

copiardef teste():
    x = 10               # local
    print(x)

teste()
# print(x)           # ❌ NameError — x não existe aqui

copiarx = 5                   # global

def teste():
    print(x)             # lê global — ok

teste()                  # 5

copiarx = 5

def alterar():
    global x            # declara intenção de modificar global
    x = 10

alterar()
print(x)               # 10

copiar# lambda parâmetros: expressão

dobro = lambda x: x * 2
print(dobro(5))   # 10

# equivale a:
def dobro(x):
    return x * 2

copiarnumeros = [1, 2, 3, 4]

dobrados = list(map(lambda x: x * 2, numeros))
print(dobrados)   # [2, 4, 6, 8]

copiarnumeros = [1, 2, 3, 4, 5, 6]

pares = list(filter(lambda x: x % 2 == 0, numeros))
print(pares)      # [2, 4, 6]

copiarpessoas = [("Igor", 25), ("Ana", 20), ("João", 30)]

ordenado = sorted(pessoas, key=lambda p: p[1])
print(ordenado)
# [('Ana', 20), ('Igor', 25), ('João', 30)]

copiardef executar(func):
    func()

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

executar(ola)    # Olá!

copiarminha_func = print       # sem parênteses = referência
minha_func("Olá!")       # Olá!

copiardef dobrar(x): return x * 2
def triplicar(x): return x * 3

operacoes = [dobrar, triplicar]

for op in operacoes:
    print(op(5))   # 10, 15

copiardef externa():
    def interna():
        print("Dentro da função interna")

    interna()                      # chamada dentro da externa
    print("Dentro da função externa")

externa()

Dentro da função interna
Dentro da função externa

copiardef multiplicador(x):
    def multiplicar(y):
        return x * y        # lembra o x do contexto externo
    return multiplicar

dobro    = multiplicador(2)
triplo   = multiplicador(3)

print(dobro(5))    # 10
print(triplo(5))   # 15

copiardef log(func):
    def wrapper(*args, **kwargs):
        print(f"Executando: {func.__name__}")
        resultado = func(*args, **kwargs)
        print("Concluído!")
        return resultado
    return wrapper

@log                         # aplica o decorator
def somar(a, b):
    return a + b

somar(2, 3)

Executando: somar
Concluído!

copiardef repetir(n):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(n):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repetir(3)
def ola():
    print("Olá!")

ola()   # Olá! (3 vezes)

copiardef soma(a: int, b: int) -> int:
    return a + b

def saudacao(nome: str = "Visitante") -> None:
    print(f"Olá {nome}")

def dividir(a: float, b: float) -> float | None:
    return a / b if b != 0 else None

copiardef soma(a: int, b: int) -> int:
    """
    Soma dois números inteiros.

    Args:
        a: Primeiro número.
        b: Segundo número.

    Returns:
        A soma de a e b.
    """
    return a + b

print(soma.__doc__)    # acessa a docstring
help(soma)              # exibe documentação formatada

copiardef fatorial(n: int) -> int:
    if n == 0:
        return 1                    # caso base
    return n * fatorial(n - 1)   # chamada recursiva

print(fatorial(5))   # 120  →  5 * 4 * 3 * 2 * 1

copiar# ❌ Esquecer return
def soma(a, b):
    a + b                  # não retorna nada → None

# ❌ Ordem errada de parâmetros
def func(a=1, b):          # SyntaxError
    pass

# ❌ Mutabilidade perigosa no default
def adicionar(lista=[]):   # mesmo objeto reutilizado!
    lista.append(1)
    return lista

# ✅ Correto
def adicionar(lista=None):
    if lista is None:
        lista = []
    lista.append(1)
    return lista

copiardef filtrar_pares(numeros: list) -> list:
    """Retorna apenas os números pares."""
    return [n for n in numeros if n % 2 == 0]

def somar_lista(numeros: list) -> int:
    """Soma todos os elementos."""
    return sum(numeros)

def pipeline(*funcs):
    """Aplica funções em sequência."""
    def executar(dados):
        for func in funcs:
            dados = func(dados)
        return dados
    return executar

processar = pipeline(filtrar_pares, somar_lista)

lista = [1, 2, 3, 4, 5, 6]
print(processar(lista))    # 12  (2+4+6)