Comprendre du code que tu n'as pas écrit
Comment lire une fonction précise et comprendre ce qu'elle fait
⏱ Estim. ~5 min
01 · Lire
Dans la leçon précédente tu as appris à avoir une vue d'ensemble d'une base de code. Maintenant on zoome. Comment lire une fonction précise et comprendre ce qu'elle fait ?
C'est une compétence que tu utiliseras tous les jours en tant qu'ingénieur. Tu vas ouvrir un fichier, voir une fonction écrite par quelqu'un d'autre, et tu auras besoin de comprendre ce qu'elle fait, comment elle fonctionne, et s'il y a des bugs.
La bonne nouvelle : le code est écrit de manière structurée et logique. Une fois que tu sais quoi regarder, lire une fonction ressemble presque à lire une recette.
02 · Lire
Voici l'approche systématique pour lire n'importe quelle fonction que tu rencontres. Suis ces étapes dans l'ordre et même la fonction la plus déroutante commence à prendre du sens.
Points clés
- Lis le nom de la fonction — il décrit généralement ce qu'elle fait
- Lis les paramètres — quelles entrées attend-elle ?
- Lis la valeur de retour — qu'est-ce qu'elle renvoie ?
- Suis la logique ligne par ligne
- Utilise Claude : « Explique-moi en mots simples ce que fait cette fonction »
03 · Exemple de code
Lis cette fonction et essaie de comprendre ce qu'elle fait avant de voir l'explication. Suis les étapes ci-dessus : nom, paramètres, valeur de retour, puis suis la logique.
Fonction mystère
function processItems(items, threshold) {
const filtered = items.filter(item => item.price > threshold);
const sorted = filtered.sort((a, b) => b.price - a.price);
return sorted.slice(0, 5);
}
Cette fonction prend une liste d'éléments et un seuil de prix, filtre ceux qui sont sous le seuil, les trie par prix (du plus haut au plus bas), et renvoie les 5 premiers. Les noms comme 'filter', 'sort', 'slice' sont tes indices. Sans commentaires, le code lui-même te dit ce qu'il fait — si tu sais le lire.
04 · Modèle de prompt
Quand tu es bloqué sur une fonction, utilise Claude pour confirmer ta compréhension. Remplace les placeholders par ton fichier réel et ton interprétation.
Explique ce que fait la fonction processItems dans {{filename}}. Je comprends que c'est {{your_understanding}}, c'est ça ?05 · Compléter
Quand tu lis une fonction, les trois éléments qui te disent le plus sont le nom, _____, et la valeur de retour.
06 · Quiz
Quand tu lis une fonction inconnue, que faut-il regarder en premier ?
- Les commentaires au-dessus de la fonction
- La dernière ligne de la fonction
- Les variables dans la fonction
- Le nom de la fonction et ses paramètres
Autres leçons de ce chapitre
⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.
※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.