Section courante

A propos

Section administrative du site

Indentation et formatage

Indentation

L'indentation consiste à décaler visuellement les lignes de code afin de refléter la structure logique du programme :

Elle n'est généralement pas obligatoire pour le compilateur, mais indispensable pour le développeur.

Formatage

Le formatage regroupe l'ensemble des règles de présentation du code :

Un code bien formaté est plus facile à lire qu'à expliquer.

Pourquoi l'indentation et le formatage sont essentiels

Lisibilité immédiate

Réduction des erreurs

Maintenance facilitée

Travail en équipe

Indentation des blocs de code

Structures conditionnelles

Mauvais exemple (peu lisible) :

  1. if (x > 0) {
  2. printf("Positif");
  3. if (x > 10) {
  4. printf("Grand nombre");
  5. }
  6. }

Bon exemple :

  1. if (x > 0) {
  2.     printf("Positif");
  3.     if (x > 10) {
  4.         printf("Grand nombre");
  5.     }
  6. }

Boucles

  1. for i := 1 to 10 do
  2. begin
  3.   Writeln(i);
  4.   if i mod 2 = 0 then
  5.     Writeln('Pair');
  6. end;

Espaces et alignement

Autour des opérateurs

Mauvais :

  1. a=b+5*3;

Bon :

  1. a = b + 5 * 3;

Listes de paramètres

  1. function CalculerMoyenne(
  2.   note1: Integer;
  3.   note2: Integer;
  4.   note3: Integer
  5. ): Double;

Longueur des lignes

Règle générale

Découpage des lignes longues

  1. printf(
  2.     "Le résultat du calcul pour l'utilisateur %s est %d\n",
  3.     nomUtilisateur,
  4.     resultat
  5. );

Placement des blocs

Style avec accolades (C, C++)

Deux styles courants :

Style K&R

  1. if (x > 0) {
  2.     printf("Positif");
  3. }

Style Allman

  1. if (x > 0)
  2. {
  3.     printf("Positif");
  4. }

Le plus important n'est pas le style, mais la cohérence.

Style Pascal

  1. if x > 0 then
  2. begin
  3.   Writeln('Positif');
  4. end
  5. else
  6. begin
  7.   Writeln('Négatif ou nul');
  8. end;

Indentation logique vs indentation trompeuse

Mauvais exemple (dangereux) :

  1. if (x > 0)
  2.     printf("Positif");
  3.     printf("Toujours affiché");

Bon exemple :

  1. if (x > 0) {
  2.     printf("Positif");
  3.     printf("Toujours affiché si x > 0");
  4. }

L'indentation doit refléter exactement la logique réelle du code.

Outils de formatage automatique

Pourquoi les utiliser

Exemples d'outils

Bonnes pratiques

Indentation et POO

En programmation orientée objet :

  1. type
  2.   TCompte = class
  3.   private
  4.     solde: Double;
  5.   public
  6.     procedure Deposer(montant: Double);
  7.   end;

Résumé

Règle d'or : si le code est difficile à lire, il sera difficile à maintenir.



Dernière mise à jour : Jeudi, le 1er janvier 2026