« Algorithmique impérative/Rédaction » : différence entre les versions

Contenu supprimé Contenu ajouté
→‎Comment faire : déplacé
Aucun résumé des modifications
Ligne 1 :
Lorsqu'on rédige un algorithme, il faut toujours garder à l'esprit qu'il doit pouvoir être lu et compris par quelqu'un d'autresautre. A fur et à mesure de la pratique :, les rédacteurs ont dégagésdégagé quelques principes dont les plus simples sont expliqués ici. Il convient de respecter ces principes d'une façon rigoureuse.
 
Remarque pour les étudiants : il est parfaitement admis que le respect de ces règles de rédaction soit pris en compte dans la note finale. Quand vous écrivez une dissertation, il convient de respecter la grammaire et l'orthographe même si ce n'est pas ce qui doit être évalué, il en est de même ici.
Ligne 52 :
=== Comment faire ===
 
Pour bien indenter, considérez les '''blocs''' et mettez au même niveau le début du bloc et la fin du bloc. Par exemple, un <code>fin</code> devrait se trouver au même niveau que son <code>début</code> : on devrait l'appercevoirapercevoir immédiatement étant donné que tout ce qu'il y a entre les deux devrait se trouver un niveau d'indentatationindentation plus loin.
 
début
Ligne 70 :
De même : placez les <code>alors</code> et les <code>sinon</code> au même niveau.
 
Vous pouvez transformer ces règles, l'important étant de les fixer et de s'y tenir. Il existe plusieurs façonfaçons d'indenter, et chaque auteur à ses préférences.
 
== Utiliser des identifiants pertinents ==
 
Pour choisir un identifiant de variablesvariable ou de fonction :, souvenez-vous qu'il doit remplir deux utilitéutilités principales
* décrire son rôle (sans toufefoistoutefois remplacer le commentaire en déclaration)
* distinguer des autres (ne pas se retrouver avec deux fonctions <code>calculer_nombre</code> et <code>calculer_nb</code>, <code>quotient</code> et <code>division</code>...)
 
EvitezÉvitez :
* de répéter le type de la variable dans son identifiant (<code>entier_n</code>, <code>chaine_départ</code>)
* les conventions utilisées en maths (<code>n</code> ou <code>x</code> ne suffisent pas pour décrire le rôle d'un entier/réel)
Ligne 98 :
* <code>(* i va de 1 à 24 *)</code> n'est pas pertinent. Il ne répond pas à la question "pourquoi 24 et pas 23 ?".
 
Servez -vous également des commentaires pour indiquer ce que vous supposez : les conditions dans lesquelslesquelles votre algorithme fonctionne.
 
[[Catégorie:Algorithmique impérative (livre)]]