Les fonctions
Partie 6 sur 6
11Bien écrire une fonction
Quelques règles, issues de l’expérience, rendent les fonctions plus agréables à lire et à maintenir.
- Une fonction, une tâche. Si vous avez du mal à décrire ce qu’elle fait sans dire « et », elle fait trop de choses. Découpez.
- Un nom qui dit ce qu’elle fait. Un verbe pour une action (
envoyer_message), une question pour un test (est_valide). Évitez les noms vagues (traiter,faire) et les abréviations obscures. - Courte. Une trentaine de lignes au plus, souvent bien moins. Ce qui dépasse un écran se lit mal.
- Peu de paramètres. Au-delà de trois ou quatre, regroupez-les dans un objet ou une structure :
creer_compte(utilisateur)vaut mieux que huit paramètres dans un ordre à retenir. - Pas de surprise. Évitez qu’une fonction modifie ses arguments ou des variables globales sans que son nom ne l’annonce.
- Vérifier ce qu’elle reçoit. Une fonction qui reçoit des données venues de l’extérieur (formulaire, fichier, réseau) doit contrôler leur forme avant de s’en servir (voir les attaques sur le Web).
- La documenter. Un commentaire de deux lignes au-dessus : ce qu’elle fait, ce qu’elle attend, ce qu’elle rend. Les outils de documentation automatique l’exploitent.
- La tester. Écrire quelques appels avec des valeurs connues, y compris des cas limites (liste vide, zéro, texte vide) : c’est la façon la plus sûre de garder un code fiable au fil des modifications (voir la gestion de versions).
11.1Les erreurs de débutant
Presque tous les débutants rencontrent les mêmes problèmes. Oublier le return et obtenir une valeur vide. Écrire le nom de la fonction sans les parenthèses, qui ne l’appelle donc pas. Modifier une variable à l’intérieur d’une fonction en croyant qu’elle changera à l’extérieur (partie 5). Utiliser une variable avant de l’avoir créée. Confondre l’affichage (print) et le retour (return) : afficher un résultat ne le met pas à la disposition du reste du programme. Écrire une fonction récursive sans cas de base, ou dont les appels ne se rapprochent jamais du cas de base. Se tromper de nombre ou d’ordre d’arguments. La lecture attentive des messages d’erreur, qui indiquent presque toujours le numéro de ligne, règle la grande majorité de ces cas.
12Les fonctions dans les principaux langages
Ce tableau résume les différences les plus visibles entre cinq langages classiques et trois langages plus récents.
| Langage | Mot-clé | Type de retour | Prototype | Surcharge | Valeur par défaut |
|---|---|---|---|---|---|
| C | aucun | obligatoire | oui | non | non |
| C++ | aucun | obligatoire | oui | oui | oui (dans le prototype) |
| Java | aucun (méthode) | obligatoire | non | oui | non |
| JavaScript | function | aucun | non (remontée) | non | oui |
| PHP | function | facultatif | non | non | oui |
| Python | def | facultatif (annotation) | non | non | oui |
| Rust | fn | obligatoire (sauf rien) | non | non | non |
| Go | func | obligatoire (plusieurs possibles) | non | non | non |
Le message à retenir : les idées (nom, paramètres, corps, retour, portée) sont les mêmes partout. Quand vous apprenez un nouveau langage, vous ne repartez pas de zéro : vous cherchez comment ce langage écrit ces idées que vous connaissez (voir les langages de programmation).
13Erreurs courantes et évolutions
Les explications d’usage sont justes sur l’essentiel, mais plusieurs points ont vieilli ou contenaient des erreurs.
- Le caractère « & » dans les noms. On lit parfois que les noms de fonctions peuvent comporter « des lettres, des chiffres et les caractères _ et & ». C’est une coquille pour le dollar (
$), accepté en Java et en JavaScript. Le « & » sert à autre chose : la référence en PHP et en C++. - Le type
intpar défaut en C. Le texte le signalait comme « vilain » ; il est désormais interdit par le standard. - Les variables sans
var. En JavaScript, l’oubli créait une variable globale. Aujourd’hui, on utiliseletetconst, et le mode strict interdit cet oubli. onLoadet les scripts dans l’en-tête. Remplacés pardeferet les écouteurs d’événements.document.write. Déconseillée ; on modifie la page par le DOM.- Les boîtes de dialogue. Elles « sont à éviter car elles sont énervantes » ; l’avis reste valable.
- Les fonctions sont devenues des valeurs. Lambdas, fermetures, rappels et fonctions asynchrones n’existaient pas dans ces textes.
- Les types reviennent partout. TypeScript, annotations Python, Rust, Go : les langages dynamiques se sont dotés d’outils de vérification.
- Ce qui reste vrai. La fonction comme bloc nommé et réutilisable, la nécessité de la définir avant l’usage, la différence entre local et global,
return, la condition de sortie de la récursivité, la signature qui détermine la surcharge.