Aller au contenu principal

⚙️ Création de fonctions

Rappel sur les fonctions
  • Une fonction est un bloc de code réutilisable qui effectue une tâche spécifique.
  • Nous avons déjà utilisé des fonctions existantes, comme print(), max() ou round(). Dans cette rencontre, nous allons créer les nôtres.
  • Une fonction peut prendre des paramètres (des valeurs d'entrée) et retourner une valeur de sortie.
  • Les fonctions permettent de structurer le code, de réduire la répétition et de faciliter la maintenance du code.

Fonction simple

Voici une fonction très simple :

def double(x):
return 2 * x
  • Première ligne : def double(x):
    • def est un mot-clé qui indique que nous sommes en train de définir une fonction.
    • double est le nom que nous avons décidé de donner à notre fonction.
      • 💡 Bien nommer une fonction : utilisez un verbe qui décrit ce qu'elle fait, écrit en snake_case (minuscules et _), par exemple calculer_moyenne ou afficher_rapport.
    • Les parenthèses () indiquent que c'est une fonction, et peuvent contenir des paramètres (ici un seul : x).
    • x est un paramètre que nous avons décidé de nommer x et qui prend la valeur transmise lors de l'appel de la fonction.
    • Le : à la fin de la ligne indique que le corps (le code) de la fonction commence à la ligne suivante.
  • Toutes les lignes suivantes (ici seulement une ligne : return 2 * x)
    • Elles forment le corps de la fonction : elles sont indentées (décalées vers la droite) avec la touche TAB.
      • ⚠️ En Python, c'est l'indentation qui indique quelles lignes font partie de la fonction. Voir l'explication détaillée plus bas.
    • return est un mot-clé qui indique quelle valeur la fonction renvoie, ici le résultat de l'évaluation de l'expression 2 * x.

👉 Définir une fonction, ce n'est pas l'exécuter.
Quand Python lit ces deux lignes, il ne calcule rien : il retient simplement que la fonction double existe et ce qu'elle doit faire.
C'est comme écrire une recette de cuisine : la recette est prête, mais le plat n'est pas encore préparé.
Le code de la fonction ne sera exécuté que lorsque nous l'appellerons, ce que nous verrons juste après.


Appel d'une fonction

Une fois qu'une fonction est ainsi définie, on peut l'appeler, en lui transmettant une valeur pour x :

def double(x):
return 2 * x

double(5) # Appel de la fonction en lui passant la valeur 5

Pour appeler une fonction, on écrit son nom suivi de parenthèses contenant les valeurs à transmettre aux paramètres.
Lorsqu'une fonction est appelée, le code à l'intérieur de la fonction est exécuté, et la valeur spécifiée par return est renvoyée à l'endroit où la fonction a été appelée.

Ici, la fonction double est appelée en lui passant la valeur 5, ce qui signifie que x reçoit la valeur 5 à l'intérieur de la fonction.
La fonction calcule 2 * 5 et retourne 10.

Cependant, ici, la valeur retournée par la fonction est perdue : la fonction fonctionne, mais le résultat disparaît si on ne le stocke pas.
Il est plus utile de stocker cette valeur dans une variable. Remplaçons la ligne 4 par :

resultat = double(5) # Appel de la fonction et stockage de la valeur retournée dans la variable 'resultat'
print(resultat) # Affiche 10

👉 Une fonction qui fait un return renvoie une valeur, elle ne l'affiche pas. Pour la voir, il faut l'afficher avec print().
Si vous confondez print() et return, lisez l'aide-mémoire return vs print.


Une fois une fonction définie, elle peut être appelée autant de fois que souhaité dans le code, en utilisant son nom suivi de parenthèses et des valeurs nécessaires :

resultat1 = double(5) # Appel de la fonction avec la valeur 5
resultat2 = double(10) # Appel de la fonction avec la valeur 10
resultat3 = double(2) # Appel de la fonction avec la valeur 2

print(resultat1) # Affiche 10
print(resultat2) # Affiche 20
print(resultat3) # Affiche 4

Pour passer des valeurs à une fonction, il est aussi possible d'utiliser des variables :

a = 5
resultat = double(a) # Appel de la fonction en lui passant la valeur contenue dans la variable 'a'
print(resultat) # Affiche 10

Ici, la variable a contient la valeur 5, et lorsque nous appelons double(a), la fonction reçoit la valeur de a (c'est-à-dire 5) et retourne 10.

👉 La variable s'appelle a et le paramètre s'appelle x : ce n'est pas un problème! C'est la valeur qui est transmise, pas le nom de la variable.


Deux erreurs fréquentes lors de l'appel

Erreur 1 : appeler la fonction avant de la définir

resultat = double(5)
def double(x):
return 2 * x

Dans la console, Python affiche ce message d'erreur :

Traceback (most recent call last):
  File "...\r03_fonction.py", line 1, in <module>
    resultat = double(5)
               ^^^^^^
NameError: name 'double' is not defined

🔎 Lisez d'abord la dernière ligne : elle donne le type d'erreur (NameError) et sa cause. La ligne line 1 indique où chercher.
Python lit le code de haut en bas : à la ligne 1, il ne connaît pas encore double.
👉 Écrivez toujours vos fonctions en haut du fichier, avant le code qui les appelle.

Erreur 2 : oublier les parenthèses

def double(x):
return 2 * x

print(double) # Affiche <function double at 0x000001D540C71440>

Sans parenthèses, la fonction n'est pas appelée : Python affiche la fonction elle-même (son adresse en mémoire), et non son résultat.
👉 Pour l'appeler, il faut les parenthèses et la valeur : print(double(5)).


📏 L'indentation : un élément essentiel en Python

En Python, l'indentation est le décalage vers la droite que l'on met au début d'une ligne.
Ce décalage n'est pas décoratif : il indique à Python quelles lignes forment un bloc de code.
L'indentation peut changer complètement le sens d'un programme!

Un bloc de code, c'est par exemple :

  • 🔧 le corps d'une fonction (ce que nous voyons dans cette rencontre)
  • 🔀 le contenu d'une structure conditionnelle (plus tard dans le cours)
  • 🔁 le contenu d'une boucle (plus tard dans le cours)

Comment ça fonctionne :

  1. Une ligne qui se termine par : annonce qu'un bloc va suivre (ex : def double(x):).
  2. Les lignes du bloc sont décalées vers la droite par rapport à cette ligne.
  3. Le bloc se termine à la première ligne qui revient au niveau de la ligne qui contient le :.
def double(x):
y = 2 * x # Indentée : fait partie de la fonction
return y # Indentée : fait partie de la fonction
z = 3 # Non indentée : le bloc est terminé, cette ligne est hors de la fonction
  • Les lignes 2 et 3 sont indentées : elles forment le corps de la fonction double.
  • La ligne 4 revient au niveau de la ligne def : elle est en dehors de la fonction.

Règle d'or : toutes les lignes d'un même bloc doivent avoir exactement la même indentation.


⌨️ Comment indenter : utilisez la touche TAB
  • ✅ TAB : ajoute une indentation (décale la ligne vers la droite).
  • ✅ Maj + TAB : retire une indentation (décale la ligne vers la gauche).
  • ❌ Ne jamais utiliser la barre d'espace pour indenter!

Si vous sélectionnez plusieurs lignes, TAB et Maj + TAB les décalent toutes en même temps.

Pourquoi ✅ TAB et jamais la ❌ barre d'espace?

  • TAB crée toujours le même décalage : l'indentation est uniforme.
  • Avec la barre d'espace, il est très facile d'oublier un espace ou d'en ajouter un de trop, et l'erreur est presque invisible à l'œil.
  • Un seul espace de trop suffit pour provoquer une IndentationError.

👉 Voir aussi la section sur la tabulation de l'aide-mémoire ⌨️ Symboles au clavier.


IndentationError : une erreur fréquente chez les débutants

Une indentation incorrecte empêche le programme de s'exécuter. Python affiche alors une erreur IndentationError.
Dans PyCharm, la ligne fautive est généralement soulignée en rouge avant même l'exécution, et l'erreur s'affiche dans la console si on lance le programme.

Cas 1 : on oublie d'indenter le corps de la fonction

def double(x):
return 2 * x # IndentationError: expected an indented block after function definition on line 1

Cas 2 : une ligne est plus indentée que les autres du même bloc

def double(x):
y = 2 * x
return y # IndentationError: unexpected indent

Pour corriger : donnez la même indentation à toutes les lignes du bloc, en utilisant TAB.

def double(x):
y = 2 * x
return y

Une fonction vide : pass

Une fonction doit contenir au moins une instruction indentée. Mais parfois, on veut déclarer une fonction qu'on écrira plus tard, par exemple pour construire un programme étape par étape.

On utilise alors pass : une instruction qui ne fait rien, mais qui sert d'espace réservé.

def calculer_moyenne(notes):
pass # À écrire plus tard

print("Le reste du programme fonctionne déjà!")

Sans pass, Python afficherait une erreur : IndentationError: expected an indented block after function definition on line 1.

👉 N'oubliez pas de remplacer le pass par le vrai code de la fonction une fois prêt!

Les explications de cette section étaient-elles claires ?