Outils pour utilisateurs

Outils du site


microalg:mise_en_forme

Mise en forme officielle

Introduction

En programmation, on lit davantage que l’on écrit.

La mise en forme d’un programme est importante car elle donne beaucoup d’informations sur sa structure. Un programme pourrait être écrit sur une seule ligne et fonctionner correctement, mais serait illisible. En plaçant judicieusement des retours à la ligne et des espaces, on facilite la compréhension du programme. Et bien souvent, c’est le programmeur lui-même qui est le principal lecteur !

La mise en forme proposée ici est le fruit de l’écriture et de la lecture de nombreux programmes. Des suggestions sont toutefois encore possibles, bien sûr.

Nous insistons ici sur les commandes qui reçoivent des « blocs de code », c’est à dire des lignes de code qui sont groupées (ne pas confondre ces blocs avec les pièces de puzzle).

Notez que vous pouvez toujours utiliser l’export MicroAlg pour obtenir la mise en forme officielle.

Repeter

Ici, chaque ligne du code à répéter est indentée de quatre espaces.

Le mot-clé intermédiaire Fois est sur la même ligne que Repeter. En effet, bien souvent, le nombre qui vient avant ne prend pas de place, et ces trois éléments forment un tout.

On remarque que la parenthèse ouvrante de Repeter est rouge et est alignée avec la parenthèse de même couleur qui lui correspond. Les parenthèses ouvrantes des commandes à répéter sont oranges et alignées verticalement aussi.

Si

On retrouve les mêmes idées que pour Repeter, sauf pour le mot clé intermédiaire Alors : il est seul sur sa ligne et est indenté d’une espace.

Mettre Alors seul sur sa ligne permet de mieux visualiser et de mieux manipuler (copier-coller) les lignes de ce bloc.

La parenthèse ouvrante de la condition du Si est alignée avec les parenthèses ouvrantes des commandes du Alors.

Tant_que

On retrouve les mêmes idées que pour Si, sauf que la parenthèse de la condition d’une part et les parenthèses du bloc Faire d’autre part ne sont pas alignées.

Si Alors Sinon

On retrouve les mêmes idées que pour le Si sans Sinon. De même, le mot clé intermédiaire Sinon est seul sur sa ligne et est indenté d’une espace.

La parenthèse ouvrante de la condition du Si est alignée avec les parenthèses ouvrantes des commandes du Alors et du Sinon.

Faire

On retrouve les mêmes idées que pour le Tant_que. La parenthèse fermante du Faire est seule sur sa ligne pour deux raisons: ne pas interférer avec les parenthèses de la condition, et respecter l’alignement des parenthèses fermantes de toutes ces commandes.

Cumulation

L’indentation doit se cumuler bien sûr.

microalg/mise_en_forme.txt · Dernière modification: 2017/03/19 11:36 par profgra