A instrução return em Python

Suponha que temos uma função que exibe na tela o quadrado de um número passado:

pythondef func(num):
  print(num ** 2)

Caso não seja necessário exibir o valor imediatamente na tela, é possível primeiro gravá-lo em alguma variável:

pythonres = func(3) # na variável res agora está 9

Para isso, existe no Python uma instrução especial return, que permite especificar o valor que a função retorna. A palavra retorna entende-se como o valor que será gravado na variável, se for atribuída a ela a função chamada.

Vamos reescrever nossa função para que ela não exiba o resultado no console, mas o retorne para uma variável:

pythondef func(num):
  return num ** 2

Agora vamos gravar o resultado da função em uma variável:

pythonres = func(3)

Depois que os dados são gravados em uma variável, eles podem, por exemplo, ser exibidos na tela:

pythonres = func(3)
print(res) # exibirá 9

Ou pode-se primeiro modificar esses dados, e depois exibi-los na tela:

pythonres = func(3)
res = res + 1

print(res) # exibirá 10

É possível realizar imediatamente algumas ações com o resultado da função antes de gravá-lo em uma variável:

pythonres = func(3) + 1
print(res) # exibirá 10

Podemos chamar nossa função várias vezes para números diferentes e somar seus resultados:

pythonres = func(2) + func(3)
print(res) # exibirá 13

Para encurtar o código escrito, pode-se chamar a função diretamente, passando-a como parâmetro para print:

pythonprint(func(3))