Convention de nommage - Définition

Introduction

Une convention de nommage dans la programmation informatique est un ensemble de règles destinées à choisir la séquence de caractères à utiliser pour les identifiants dans le code source et la documentation.

Les raisons pour lesquelles on utilise une convention de nommage (par opposition à l'autorisation accordée aux programmeurs de choisir n'importe quelle séquence de caractères) sont les suivantes :

• rendre le code source plus facile à lire et à comprendre avec moins d'efforts ;
• améliorer l'apparence du code source (par exemple, en interdisant les noms trop longs ou les abréviations) ;

Le choix de conventions de nommage peut prêter à d'énormes controverses, les partisans de chaque convention tenant la leur pour la meilleure, les autres étant inférieures.

Avantages

L'utilisation d'une convention de nommage peut procurer une sécurité beaucoup plus grande dans l'utilisation des programmes informatiques, du fait que le code source doit respecter des règles précises.

Il sera ainsi plus facile d'atteindre des niveaux EAL plus élevés, par exemple dans le logiciel libre, lorsqu'il s'agit de vérifier le code source.

Les bénéfices détaillés peuvent se décliner de la façon suivante :

• fournir une information supplémentaire (ie métadonnées) sur l'utilisation d'un identifiant ;
• aider à formaliser les attentes et promouvoir la cohérence dans une équipe de développement ;
• permettre l'utilisation de maintenance automatisée ou de recherche, et remplacer les outils avec des risques minimum d'erreur ;
• améliorer la clarté dans les cas d'ambiguïtés ;
• améliorer l'apparence esthétique et professionnelle du produit (par exemple, en interdisant les noms trop longs, comiques ou "cute", ou les abréviations) ; et
• aider à éviter les "doublons" qui peuvent se produire quand les logiciels de différentes organisations interopèrent entre eux (voir aussi : espace de noms)

Éléments communs

Longueur des identifants

Casse des lettres et nombres

Identifiants à mots multiples

Défis

Le choix des conventions de nommage (et leur domaine d'application) fait souvent l'objet de débats.

De plus, même avec des conventions en place connues et bien définies, il peut arriver que des organisations ne parviennent pas à les mettre en oeuvre d'une façon cohérente, ce qui peut causer de l'incohérence, de la causing inconsistency et de la confusion.

Ces défis peuvent être exacerbés si les règles en interne de la convention de nommage sont incohérentes, arbitraires, difficiles à mémoriser ou, au contraire, plus fastidieuses que bénéfiques.

Exemples

Norme ISO/IEC 11179 de registre de métadonnées

la norme ISO/IEC 11179-5 sur les registres de métadonnées contient des conventions de nommage pour les concepts des éléments (noms d'éléments), les domaines conceptuels, et les domaines de valeur.

Cette norme concerne tous les langages de balisage (HTML, XML,...), mais aussi, à travers les éléments de métadonnées, les données qui peuvent être utilisées par d'autres types de langages.

Langage Java

En Java, dès l'origine de la création de ce langage, des conventions ont établi des exigences strictes sur les classes et les variables à capitaliser différemment. Ainsi, pour un programmeur Java, widget.expand() et Widget.expand() impliquent des comportements significativement différents, même sans connaissance préalable de la classe Widget et malgré le fait que le compilateur n'oblige à aucune règle.

Langage C

Les identifiants qui représentent des macros en C et C++ sont, par convention, écrits en utilisant seulement des lettres en capitales. Ceci est relatif à la convention selon laquelle, dans beaucoup de langages de programmation, on doit utiliser des métadonnées en capitales pour les constantes.