Style d'indentation

En informatique, l'indentation consiste en l'ajout de tabulations ou d'espaces dans un fichier texte. Le style d'indentation décrit les différentes manières que les programmeurs utilisent pour faire ressortir un bloc de code.

L'indentation se définit par la manière d'arranger les blocs de code, mais surtout par le nombre d'espaces utilisés à chaque niveau.

L'indentation peut ne pas être qu'esthétique. En effet, elle s'avère obligatoire pour certains langages afin de former des blocs ou des lignes valides (par exemple Occam, Fortran ou Python).

Styles d'indentation en C

Style K&R

C'est le style employé par Brian Kernighan et Dennis Ritchie pour rédiger les exemples dans leur livre Le Langage C, connu comme le premier livre sur le langage C.

<syntaxhighlight lang="c"> void a_function(void) {

   if (x == y) {
       something1();
       something2();
   } else {
       somethingelse1();
       somethingelse2();
   }
   finalthing();

} </syntaxhighlight>

Il place donc l'accolade ouvrante d'une fonction sur la ligne suivant la partie déclarative, contrairement aux autres accolades (par exemple des structures de contrôle) qui sont laissées sur la même ligne que la déclaration.

Variantes

Il existe de nombreuses variantes de ce style. Une variante relativement commune consiste à placer l'accolade ouvrante des fonctions sur la même ligne que la partie déclarative ; en dehors du C, c'est un des usages recommandés par Sun pour son langage Java, par exemple<ref>Modèle:Lien web</ref>.

Une autre nuance couramment rencontrée peut venir du placement du mot-clé else. Certains développeurs préfèrent en effet positionner celui-ci sur une ligne à part entière.

Style Allman

Nommé d'après Eric Allman, ce style respecte un alignement strict des accolades ouvrantes et fermantes, comme dans l'exemple ci-dessous : <syntaxhighlight lang="c"> void a_function(void) {

   if (x == y)
   {
       something1();
       something2();
   }
   else
   {
       somethingelse1();
       somethingelse2();
   }
   finalthing();

} </syntaxhighlight>

L'avantage principal de ce style est qu'on peut visuellement repérer très facilement tout oubli d'accolade. De plus, on a une séparation claire entre le contenu de chaque bloc de code, ce qui améliore la lisibilité. Ceci est obtenu au prix d'un nombre de lignes plus important que pour d'autres styles. Il est très proche du style « Whitesmiths ».

Style Whitesmiths

<syntaxhighlight lang="c"> if (x == y)

   {
   something1();
   something2();
   }

else

   {
   somethingelse1();
   somethingelse2();
   }

finalthing(); </syntaxhighlight>

Les usages diffèrent sur la manière de placer les accolades pour les fonctions ; certains auteurs indentent le corps et les accolades par rapport à la partie déclarative, d'autres indentent le corps sans indenter les accolades, d'autres encore n'indentent ni le corps ni les accolades.

Style GNU

La recommandation officielle du GNU incite les programmeurs à placer le type de retour de la fonction sur une ligne à part, de sorte à aligner le nom de la fonction sur la première colonne. De même, les parenthèses servant aux appels de fonctions doivent être précédées d'une espace<ref>{{#invoke:Langue|indicationDeLangue}} Formatting Modèle:Lang</ref>.

Ces considérations ne sont toutefois pas limitées au style GNU et il n'est pas rare de rencontrer l'une ou l'autre de ces notations avec d'autres styles d'indentation. Par exemple, le KNF régissant la présentation du code des noyaux BSD requiert que le type de retour d'une fonction soit placé seul sur une ligne précédant le nom de celle-ci.

<syntaxhighlight lang="c"> void a_function (void) {

 if (x == y)
   {
     something1 ();
     something2 ();
   }
 else
   {
     somethingelse1 ();
     somethingelse2 ();
   }
 finalthing ();

} </syntaxhighlight>

Style Pico

<syntaxhighlight lang="c"> if (x == y) { something1 ();

 something2 (); }

else { somethingelse1 ();

 somethingelse2 (); }

finalthing (); </syntaxhighlight>

Ce style provient du langage Pico.

Styles d'indentation en C++

Style utilisé par Bjarne Stroustrup

C'est le style employé par Bjarne Stroustrup, inventeur du langage C++, pour rédiger les exemples dans son livre décrivant le langage C++.

Celui-ci s'apparente à une variation du style K&R, étendu aux nouveautés apportées par le C++.

Styles Ada, C++, Java, PHP...

Les langages de haut niveau de ce genre, qui dérivent tous d'Algol (1960), emploient un style similaire<ref name="Germe" />.

Turbo-Pascal, norme de fait du Pascal de 1983 à nos jours (Delphi), a introduit un style de codage plus efficace et plus lisible<ref>{{#invoke:Langue|indicationDeLangue}} Turbo-Pascal 3.0 (1986)</ref>, à deux caractères d'indentation, largement employé dans d'autres langages, par exemple en PHP ou en Ada<ref name="Germe" />. (program TimeInterrupt de l'unité standard GetTime.PAS) <syntaxhighlight lang="pascal"> begin

 ah := $2c;                             {initialize correct registers}
 with recpack do
 begin
   ax := ah shl 8 + al;
 end;
 intr($21,recpack);                     {call interrupt}
 with recpack do
 begin
   str(cx shr 8,hour);                  {convert to string}
   str(cx mod 256,min);                       { " }
   str(dx shr 8,sec);                         { " }
 end;
 time := hour+':'+min+':'+sec;

end; </syntaxhighlight>

Autres Styles

Occam

<syntaxhighlight lang="oberon2"> IF

 sgf.res <> 0
   SKIP
 TRUE
   IF
     compare.strings (ThfareKey, "99999999") <> 0
       SEQ
         ThfareKeyInt := AtoI (ThfareKey)
         ThfareOffsets [ThfareKeyInt] := Offset
     TRUE
       SKIP

</syntaxhighlight> En Occam, c'est l'indentation qui est porteuse de l'information d'appartenance à un bloc, ce qui évite les constructions de blocs ("begin", "then", "end"). L'indentation est de deux caractères. Ci-dessus, TRUE est l'équivalent de "default" ou "else" des constructions "if" ou "case of" ("switch" en C).

FORTRAN V

<syntaxhighlight lang="fortran"> subroutine ch_cap ( c )

 implicit none

 character c

 if ( 97 <= itemp .and. itemp <= 122 ) then
   c = char ( itemp - 32 )
 end if

 return

end </syntaxhighlight> Ce style est très proche du type "dérivé Turbo Pascal" ci-dessus. Notez qu'en FORTRAN standard, les 5 premiers caractères de chaque ligne sont théoriquement réservés, soit aux commentaires ("C" en première colonne), soit aux numéros de lignes (labels) d'après le format des cartes perforées Hollerith (1890) à 80 colonnes (@IBM 1926).

Lisp

<syntaxhighlight lang="lisp"> (defun compall ()

 (do-symbols (s)
   (when (fboundp s)
     (unless (compiled-function-p (symbol-function s))
       (print s)
       (compile s)))))

</syntaxhighlight> L'indentation recommandée est de 2 caractères sauf exceptions pour certaines formes spéciales, et évite les constructions de blocs ("begin", "then", "else", "end"). Les parenthèses fermantes sont regroupées et ne sont pas verticalement alignées avec les parenthèses ouvrantes correspondantes. L'écriture de programme Lisp est favorisée par l'utilisation d'éditeurs permettant de mettre en évidence les paires de parenthèses ouvrantes/fermantes correspondantes, et permettant d'indenter automatiquement le code en fonction de la structure.

Voir aussi

• indent
• astyle

Liens externes

• {{#invoke:Langue|indicationDeLangue}} Style - comp.lang.c Modèle:Lang
• {{#invoke:Langue|indicationDeLangue}} Modèle:Lang

Références

<references> <ref name="Germe">{{#invoke:Langue|indicationDeLangue}} standard et guide d'écriture des développements en Ada, JP Germe, société 3ip, 1989</ref> </references>