Retorno

Parte da seção Fundamentos do Journey de GDScript da Coddy. Lição 53 de 92.

A instrução return envia um valor de volta de uma função para o código que a chamou. A chamada então representa esse valor:

func get_max_hp():
	return 100

var hp: int = get_max_hp()
print(hp)

hp contém 100, o valor retornado pela função, então o programa imprime 100.

Uma função com parâmetros pode retornar um resultado calculado a partir deles. Você pode armazenar o resultado, imprimi-lo ou usá-lo em uma expressão:

func square(n):
	return n * n

print(square(4))
print(square(3) + 1)

16
10

return também encerra a função. As linhas depois dele no mesmo bloco não são executadas:

func check_age(age):
	if age >= 18:
		return "adult"
	return "minor"

check_age(20) retorna "adult" e para. check_age(12) ignora o bloco if e retorna "minor".

Uma função sem return retorna null.

Essas funções não informam o tipo que retornam, então o GDScript não consegue inferir um tipo a partir delas: var hp := get_max_hp() é um erro. Escreva você mesmo o tipo da variável, como em var hp: int = get_max_hp(). A próxima lição mostra como uma função declara seu tipo de retorno.

Desafio

Fácil

Abaixo de _ready(), declare uma função square_number com um parâmetro n. Ela retorna n * n.
Em _ready(), chame square_number() com input_num e armazene o valor retornado em uma variável chamada result.
Imprima result.

Para a entrada 5, a saída é:

Experimente você mesmo

extends Node

func _ready():
	var input_num := int(OS.read_string_from_stdin())
	# Armazene square_number(input_num) em result e depois imprima result

# Declare square_number(n) abaixo: ela retorna n * n