Valeur de retour

Fait partie de la section Fondamentaux du Journey GDScript de Coddy. Leçon 53 sur 92.

L’instruction return renvoie une valeur d’une fonction au code qui l’a appelée. L’appel représente alors cette valeur :

func get_max_hp():
	return 100

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

hp contient 100, la valeur renvoyée par la fonction, donc le programme affiche 100.

Une fonction avec des paramètres peut renvoyer un résultat calculé à partir de ceux-ci. Vous pouvez stocker le résultat, l’afficher ou l’utiliser dans une expression :

func square(n):
	return n * n

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

16
10

return termine également la fonction. Les lignes qui le suivent dans le même bloc ne s’exécutent pas :

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

check_age(20) renvoie "adult" et s'arrête. check_age(12) ignore le bloc if et renvoie "minor".

Une fonction sans return renvoie null.

Ces fonctions n’indiquent pas le type qu’elles renvoient, donc GDScript ne peut pas en déduire un type : var hp := get_max_hp() provoque une erreur. Écris toi-même le type de la variable, comme dans var hp: int = get_max_hp(). La prochaine leçon montre comment une fonction déclare son type de retour.

Défi

Facile

Sous _ready(), déclare une fonction square_number avec un paramètre n. Elle renvoie n * n.
Dans _ready(), appelle square_number() avec input_num et stocke la valeur renvoyée dans une variable nommée result.
Affiche result.

Pour l’entrée 5, la sortie est :

Essayez vous-même

extends Node

func _ready():
	var input_num := int(OS.read_string_from_stdin())
	# Stocke square_number(input_num) dans result, puis affiche result

# Déclare square_number(n) ci-dessous : cette fonction renvoie n * n