Pourquoi j’utilise un préfixe pour mes membres privés

Julien on mai 21st 2008

J'utilise un préfixe (A savoir: "_") pour indiquer les membres privés de mes classes. Autrement dit, une de mes classes ressemblera à cela:

  1. public class Car
  2. {
  3. private string _model;
  4. private string _owner;
  5. [...]
  6. }

Différentes notations existent ici et là, notamment "m_". Mais de nombreuses personnes ont aussi choisi de ne simplement pas démarquer les membres privés des variables locales et autres paramètres. Je suis tout à fait conscient que c'est un sujet polémique, et que les avis sont très partagés. J'aimerai toutefois expliquer pourquoi je trouve personnellement qu'il est important d'avoir cette distinction.

En guise de référence, voici ce à quoi pourrait ressembler une classe sans préfixe:

  1. public class Transportation
  2. {
  3. private TransportStatus status;
  4.  
  5. public TransportStatus Status
  6. {
  7. get { return status; }
  8. }
  9.  
  10. public void ChangeTransportStatus(TransportStatus status)
  11. {
  12. this.status= status;
  13. DoSomeStuff();
  14. }
  15. }

Il y a plusieurs problèmes avec cette classe:

  • Utiliser un préfixe permet de se passer du mot clef "this", ce qui réduit le "bruit" dans les sources. En effet, écrire "this.model" revient en quelque sorte à utiliser un préfixe ("this."). Autant utiliser quelque chose de plus court du coup!
  • Qui plus est, l'utilisation de "this" est optionnelle en C#. On se retrouve rapidement avec un mélange des genres ou certains accès sont fait avec "this". et d'autres le sont sans aucun préfixe. Si on ne connait pas bien le code, on est obligé de constamment vérifier si telle variable est privée avec l'intellisense ou en naviguant dans la classe.
  • L'absence de préfixe provoque rapidement des confusions. Par exemple, dans la fonction ChangeTransportStatus, 2 variables ont le même nom: mon paramètre et mon membre privé. Le code étant ici très simple, il est difficile de se tromper. Dans une fonction de 50 lignes, il peut y avoir potentiellement beaucoup plus d'erreurs: il est courant d'utiliser le paramètre à la place du membre...
  • J'ai également une propriété "Status" qui ressemble énormément à mon membre privé "status" dans mon exemple. L'utilisation du mot clef "this" ne règle en rien la confusion potentielle. Sans préfixe il faut donc être très attentif à l'utilisation des majuscules. Sur certaines lettres la distinction est évidente, sur d'autres, elle l'est beaucoup moins! L'expérience montre que sans préfixe, le code d'une classe utilisera plus ou moins aléatoirement la propriété ou le membre privé en fonction de la rigueur et/ou de l'humeur des développeurs. Pour peu que la propriété encapsule un peu de logique, on se retrouve rapidement avec des effets de bord indésirable.
  • Enfin, et je vous accorde que c'est un argument très discutable mais les nouveaux outils de Microsoft génère le code avec des préfixes (voir Linq to Sql par exemple). Si eux le font, c'est peut être qu'il y a du bon ;-).

Alors, prêt à utiliser un préfixe? :-)

Filed in Qualité du code, Trucs et Astuces | One response so far

One Response to “Pourquoi j’utilise un préfixe pour mes membres privés”

  1. Dominique Gratpain nov 20th 2008 at 08:14 1

    Il y a un autre argument (et de taille) en faveur du préfixe.

    Je ne travaille pas en C# mais en VB (pourquoi se compliquer la vie avec tout plein d’hiéroglyphes quand on peut faire la même chose plus simplement). J’arrête car je sens que certains vont s’irriter ;))
    Ceci sera d’autant plus vrai depuis le dernier PDC 2008 où Microsoft a annoncé que les deux langages (C# et VB) auront les mêmes fonctionnalités (il était temps).

    Donc quand je vois un code intéressant en C#, je lance mon traducteur favori pour passer ce code en VB, et là il y a problème s’il n’y a pas de préfixe car le VB n’est pas « case sensitive » (status = Status).
    En conséquence, moi aussi je recommande l’utilisation de préfixes.

Comments RSS

Leave a reply