Retorno

Parte de la sección Fundamentos del Journey de GDScript de Coddy. Lección 53 de 92.

La instrucción return envía un valor desde una función al código que la llamó. La llamada representa entonces ese valor:

func get_max_hp():
	return 100

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

hp contiene 100, el valor que devolvió la función, así que el programa imprime 100.

Una función con parámetros puede devolver un resultado calculado a partir de ellos. Puedes almacenar el resultado, imprimirlo o usarlo en una expresión:

func square(n):
	return n * n

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

16
10

return también termina la función. Las líneas que aparecen después dentro del mismo bloque no se ejecutan:

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

check_age(20) devuelve "adult" y se detiene. check_age(12) omite el bloque if y devuelve "minor".

Una función sin return devuelve null.

Estas funciones no indican qué tipo devuelven, así que GDScript no puede inferir un tipo a partir de ellas: var hp := get_max_hp() es un error. Escribe tú el tipo de la variable, como en var hp: int = get_max_hp(). La siguiente lección muestra cómo una función declara su tipo de retorno.

Desafío

Fácil

Debajo de _ready(), declara una función square_number con un parámetro n. Devuelve n * n.
En _ready(), llama a square_number() con input_num y almacena el valor devuelto en una variable llamada result.
Imprime result.

Para la entrada 5, la salida es:

Pruébalo tú mismo

extends Node

func _ready():
	var input_num := int(OS.read_string_from_stdin())
	# Guarda square_number(input_num) en result y luego imprime result

# Declara square_number(n) a continuación: devuelve n * n