Style d'indentation

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.

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

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^[1].

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

Style Whitesmiths

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

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

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

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'un espace^[2].

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.

Style Pico

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

Ce style provient du langage Pico et n'est guère populaire en C.

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^[3].

Turbo-Pascal, norme de fait du Pascal de 1983 à nos jours (Delphi), a introduit un style de codage plus efficace et plus lisible^[4], à deux caractères d'indentation, considéré par certains programmeurs expérimentés comme le meilleur et largement employé dans d'autres langages, par exemple en PHP ou en Ada^[3]. (program TimeInterrupt de l'unité standard GetTime.PAS)

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;

Autres Styles

Occam

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

En Occam (langage), 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

subroutine ch_cap ( c )
  implicit none
 
  character c
 
  if ( 97 <= itemp .and. itemp <= 122 ) then
    c = char ( itemp - 32 )
  end if
 
  return
end

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

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

L'indentation n'est pas obligatoire, est de 2 caractères, et évite les constructions de blocs ("begin", "then", "else", "end").

Voir aussi

• Indent

Liens externes

• (en) Style - comp.lang.c Frequently Asked Questions
• (en) Peter Naur (ed): Revised Report on the Algorithmic Language Algol-60 In Communications of the ACM, 6(1):1--17, 1963.

Références

• Portail de la programmation informatique