Fiche de révision : Écrire un mini-algorithme documenté
En bref
Un mini-algorithme documenté en Python est une suite d'instructions claires, structurée avec des variables, conditions, boucles et listes, et commentée pour être compréhensible. Il peut lire/écrire un fichier CSV. La documentation (commentaires, noms explicites) est essentielle.
Points clés
- Un algorithme est une suite finie d'instructions pour résoudre un problème.
- Les variables stockent des données (entiers, chaînes, listes, etc.).
- Les conditions (if/elif/else) permettent de prendre des décisions.
- Les boucles (for, while) répètent des instructions.
- Les listes stockent plusieurs valeurs indicées.
- Le format CSV stocke des données tabulaires, lisible par Python avec le module csv.
- Documenter = commenter (#) et choisir des noms de variables explicites.
Définitions & formules
Algorithme
Suite finie d'instructions qui, à partir de données d'entrée, produit des données de sortie.
Variable
Zone mémoire nommée contenant une valeur (ex: age = 15).
Condition
Instruction if qui exécute un bloc si une expression booléenne est vraie.
Boucle for
Répète un bloc pour chaque élément d'une séquence (ex: for i in range(5):).
Boucle while
Répète un bloc tant qu'une condition est vraie.
Liste
Collection ordonnée et modifiable d'éléments, notée [ ].
CSV
Fichier texte où chaque ligne est un enregistrement et les champs sont séparés par des virgules.
Méthode flash
- 1Analyser le problème : identifier les entrées, sorties et traitements.
- 2Écrire l'algorithme en langage naturel, puis le traduire en Python avec des noms de variables explicites.
- 3Ajouter des commentaires (#) pour expliquer chaque étape importante.
- 4Tester avec des exemples simples et corriger les erreurs.
Exemple corrigé
Énoncé
Écrire un algorithme qui lit un fichier CSV 'notes.csv' (colonne 'nom' et 'note') et affiche les noms des élèves ayant une note >= 10.
Résolution
import csv with open('notes.csv', 'r') as f: lecteur = csv.DictReader(f) for ligne in lecteur: if int(ligne['note']) >= 10: print(ligne['nom'])
Pièges à éviter
❌ Faux : Oublier d'importer le module csv avant de l'utiliser.
✅ Correct : Toujours écrire import csv en début de fichier.
❌ Faux : Confondre = (affectation) et == (comparaison) dans une condition.
✅ Correct : Utiliser = pour donner une valeur, == pour tester l'égalité.
❌ Faux : Ne pas commenter le code, pensant que 'ça se comprend tout seul'.
✅ Correct : Ajouter des commentaires pour chaque bloc logique.
Auto-évaluation
Coche ce que tu sais faire. Le reste = à revoir en priorité.
0 / 5 — continue, tu y es presque !
Tu as revu la fiche ? Passe à l'action 💪
Teste-toi sur les exercices de SNT pour ancrer ce que tu viens de réviser.
