Les fonctions
Partie 3 sur 6
5La portée des variables
Voici un piège qui attrape tous les débutants. On le décrit ainsi : lorsque vous manipulerez des variables dans des fonctions, il vous arrivera de constater que vous avez beau modifier la variable dans la fonction, celle-ci retrouve sa valeur d’origine dès que l’on en sort. Ce n’est pas un défaut du langage : c’est la portée des variables, c’est-à-dire la zone du programme où une variable existe.
5.1Locale ou globale
Une variable locale est créée dans une fonction et n’existe qu’à l’intérieur ; elle disparaît à la fin de l’appel, avec la valeur qu’elle contenait. Toute référence à cette variable hors de la fonction provoque une erreur, variable inconnue. C’est le comportement voulu : chaque fonction travaille dans son propre espace, sans risque de se marcher sur les pieds. Une variable globale est définie en dehors de toute fonction : elle est visible partout, mais n’importe quelle fonction peut la modifier, ce qui rend les erreurs difficiles à retrouver. On l’utilise pour des constantes (un taux de TVA, un nom de fichier) plutôt que pour des valeurs qui changent.
Le comportement de JavaScript s’expliquait autrefois par le mot var : une variable déclarée implicitement, sans le mot var, sera globale et accessible après exécution de la fonction ; une variable déclarée explicitement, précédée de var, sera locale. Cette règle est vraie mais dangereuse : un simple oubli du mot var transformait la variable en globale et provoquait des bogues très difficiles à repérer. Le langage a corrigé cela. Depuis 2015, on déclare les variables avec let (valeur modifiable) ou const (valeur fixe), dont la portée se limite au bloc d’instructions où elles sont écrites, et le « mode strict », activé par défaut dans les modules, interdit la création involontaire de variables globales. Le mot var reste valable pour l’ancien code, mais on n’en écrit plus.
5.2Les variables de PHP : local, global, static
PHP distingue trois niveaux, qui restent un bon exercice de compréhension. Par défaut, la variable a le niveau local : elle n’est modifiée qu’à l’intérieur de la fonction et retrouve, à la sortie, la valeur qu’elle avait juste avant l’appel. En la déclarant global dans la fonction, on lui donne une portée qui n’est plus limitée à la fonction : toutes les fonctions peuvent l’utiliser et la modifier. Enfin, le niveau static définit une variable locale à la fonction, mais qui persiste pendant toute la durée d’exécution du script : elle garde sa valeur d’un appel à l’autre. Exemple : un compteur d’appels.
function compter() {
static $nb = 0; // créé une seule fois, conservé entre les appels
$nb = $nb + 1;
return $nb;
}
compter(); // 1
compter(); // 2
compter(); // 3
Le C a le même mot, static, avec le même sens pour une variable locale. C’est pratique, mais cela cache un état à l’intérieur de la fonction : deux appels identiques ne donnent plus le même résultat. Les programmeurs préfèrent souvent ranger cet état dans un objet (partie 9) ou le passer en paramètre.
5.3Une règle d’hygiène
La meilleure pratique est de donner à une fonction ce dont elle a besoin par ses paramètres, et de recevoir ce qu’elle produit par son retour. Une fonction qui ne dépend que de ses paramètres et ne modifie rien autour d’elle est dite pure : appelée deux fois avec les mêmes arguments, elle rend deux fois le même résultat. Elle est facile à comprendre, à tester et à réutiliser. À l’inverse, une fonction qui lit et modifie des variables globales ne peut se comprendre qu’en lisant tout le programme.
Pour s’exercer
Exercice 3 : le piège de la portée
Que s’affiche-t-il ? Pourquoi ?
total = 10
def ajouter(n):
total = n + 5
return total
ajouter(3)
print(total)
Voir la réponse
Il s’affiche 10. Dans la fonction, total = n + 5 crée une variable locale, qui cache la variable globale du même nom ; elle disparaît à la fin de l’appel. La variable globale n’a pas changé. Pour obtenir 8, il faut utiliser le résultat renvoyé : total = ajouter(3). (Modifier la globale depuis la fonction est possible avec le mot global, mais déconseillé.)
6Le moment où la fonction doit être connue
Avant d’appeler une fonction, il faut que le traducteur du code la connaisse. Comment cela se passe-t-il selon les langages ? Il existe trois réponses.
6.1En C et C++ : le prototype
Le compilateur lit le fichier de haut en bas. Si une fonction est définie plus bas que son appel, il ne la connaît pas encore. La solution est le prototype : une description de la fonction, placée en début de programme, avant la fonction principale main(), qui annonce que la fonction existe et en précise la forme. Cette description permet au compilateur de « vérifier » la validité de la fonction chaque fois qu’il la rencontre, en lui indiquant son type de retour, son nom et le type de ses arguments.
int aire_rectangle(int, int); /* prototype : se termine par ; */
int main(void) {
int s = aire_rectangle(4, 3); /* appel : le compilateur connaît déjà la forme */
return 0;
}
int aire_rectangle(int largeur, int hauteur) { /* définition : avec le corps */
return largeur * hauteur;
}
Trois différences avec la définition : le prototype n’est pas suivi du corps de la fonction ; il ne comprend pas le nom des paramètres, seulement leur type (on peut toutefois les écrire pour la lisibilité) ; et c’est une instruction, donc suivie d’un point-virgule. Pour de grands programmes, on regroupe les prototypes dans des « fichiers d’en-tête » (.h), que les autres fichiers incluent : c’est ainsi que les fonctions d’une bibliothèque sont rendues connues.
6.2En JavaScript : de haut en bas, et la remontée
Une recommandation ancienne : veillez toujours à ce qu’une fonction soit déclarée avant d’être appelée, sachant que le navigateur traite la page de haut en bas. Pour éviter les erreurs de ce type, on déclarait généralement les fonctions dans des balises SCRIPT situées dans l’en-tête de la page. On suggérait aussi le gestionnaire d’événement onLoad (placé dans la balise BODY) pour exécuter une fonction au chargement de la page, par exemple pour initialiser des variables ou tester si le navigateur est apte à faire fonctionner le script. Ces conseils appartiennent à une autre époque. Aujourd’hui, les fonctions JavaScript déclarées avec le mot function sont « remontées » : le moteur les connaît dès qu’il entre dans leur zone, même si l’appel est écrit plus haut. On charge les scripts en fin de page ou avec l’attribut defer, et l’on réagit au chargement par un écouteur d’événement (DOMContentLoaded) plutôt que par onLoad dans la balise BODY (voir JavaScript et HTML).
6.3En PHP : n’importe où
En PHP, la définition s’appelle « déclaration » et peut se faire n’importe où dans le code : l’interpréteur lit d’abord tout le fichier. Il y a une exception (les fonctions déclarées à l’intérieur d’une condition n’existent qu’une fois la condition passée).
6.4En Java et en Python
En Java, l’ordre des méthodes à l’intérieur d’une classe n’a pas d’importance : le compilateur lit toute la classe avant de vérifier les appels. En Python, la fonction doit exister au moment de l’appel (et non de la définition) : une fonction peut donc en appeler une autre écrite plus bas, tant que les deux sont définies avant que le programme ne démarre l’exécution de l’appel.