Retornando Valores de uma Função em Python

Uma função pode retornar um resultado utilizando o operador return, seguido do valor que será devolvido:

def nome_funcao(parametros_opcionais):
    instruções
    return valor_a_ser_retornado

Vamos definir uma função simples que retorna um valor:

def get_message():
    return "Hello Programício!"

Aqui, após o operador return, especificamos a string que será retornada.

Esse resultado pode ser atribuído a uma variável ou utilizado diretamente:

def get_message():
    return "Hello Programício!"

message = get_message()  # Atribuímos o resultado da função à variável message
print(message)           # Saída: Hello Programício!

# Também podemos passar o resultado da função diretamente
print(get_message())     # Saída: Hello Programício!

O operador return pode ser seguido por uma expressão mais complexa, cujo resultado será devolvido pela função. Por exemplo, uma função que dobra um número:

O operador return pode ser seguido por uma expressão mais complexa, cujo resultado será retornado pela função. Por exemplo, uma função que dobra um número:

def double(number):
    return 2 * number

Aqui, a função double retornará o resultado da expressão 2 * number:

def double(number):
    return 2 * number

result1 = double(4)  # result1 será igual a 8
result2 = double(5)  # result2 será igual a 10
print(f"result1 = {result1}")  # Saída: result1 = 8
print(f"result2 = {result2}")  # Saída: result2 = 10

Outro exemplo seria uma função que retorna a soma de dois números:

def sum(a, b):
    return a + b

Neste caso:

result = sum(4, 6)               # result será igual a 10
print(f"sum(4, 6) = {result}")   # Saída: sum(4, 6) = 10
print(f"sum(3, 5) = {sum(3, 5)}")  # Saída: sum(3, 5) = 8

Saída de uma Função

O operador return não apenas retorna um valor, mas também faz com que a função termine sua execução. Portanto, ele deve ser colocado após as outras instruções, quando necessário. Por exemplo:

def get_message():
    return "Hello Programício!"
    print("End of the function")

Embora a função seja sintaticamente correta, a instrução print("End of the function") nunca será executada, pois o operador return devolve o valor e encerra a função antes que essa linha seja atingida.

Também é possível usar o operador return em funções que não retornam nenhum valor. Nesse caso, o return é usado sozinho, sem qualquer valor associado. Um exemplo típico é sair de uma função com base em certas condições:

def print_person(name, age):
    if age > 120 or age < 1:
        print("Idade inválida")
        return
    print(f"Nome: {name}  Idade: {age}")

print_person("Tom", 22)
print_person("Alice", 130)

Neste exemplo, a função print_person recebe como parâmetros o nome e a idade de uma pessoa. Primeiro, verificamos se a idade está dentro de um intervalo válido (entre 1 e 120). Se a idade estiver fora desse intervalo, exibimos uma mensagem de "Idade inválida" e saímos da função com o return. Caso contrário, a função exibe o nome e a idade da pessoa. A saída seria:

Nome: Tom  Idade: 22
Idade inválida

Dessa forma, o return é útil tanto para devolver resultados como para controlar o fluxo da função, garantindo que determinadas condições sejam respeitadas antes que a função continue sua execução.