Nommage des paramètres : nom de fichier ou nom de fichier ?

Question

J'essaie d'être grammaticalement correct dans mes appellations*. J'ai toujours utilisé filename au lieu de fileName . La convention java semble également utiliser ceci, mais FxCop préfère fileName .

Il y a un discussion sur WikiPedia à ce sujet. Plus je lis, plus j'ai l'impression d'avoir raison (ce qui est plutôt habituel ! :) ). Quelqu'un a-t-il une réponse définitive ou s'agit-il simplement de quelque chose de subjectif ?

* J'espère juste qu'il n'y a pas de fautes de grammaire dans ce post !

Answer 1

Cas de camel inférieur est recommandé pour les champs et les paramètres.

Exemple 1 :

fileName // for fields, parameters, etc.
FileName // for properties, class names, etc.

En général, **fileName** est utilisé et NON **filename** vous pouvez le vérifier en lisant le code source des logiciels libres créés par Microsoft, tels que Bibliothèque d'entreprise .

Raisons :

1. Le site point principal derrière cela est que les noms sont plus lisibles dans ce cas.
2. Cette approche ajoute également cohérence lorsque plusieurs paramètres (champs, variables..) sont utilisés dans la même méthode (classe..) et avec le même préfixe "file", comme démontré ci-dessous :
3. ...il y a quelques autres raisons, mais elles sont plus subjectives.

Exemple 2 :

fileName, fileSize... // instead of filename AND filesize

Voir aussi :

• Conventions d'appellation à Wikipedia
• Conventions générales d'appellation à MSDN

Pour un ensemble complet de règles relatives aux conventions de nommage, je vous recommande de consulter ce livre :

• Directives de conception du cadre : Conventions, idiomes et modèles pour des bibliothèques .NET réutilisables
  (2ème édition) par Krzysztof, publié le Nov, 2008
  (personnellement nous n'utilisons pas 100% des recommandations de ce livre, mais dans l'ensemble il y a d'assez bonnes directives)

Et vérifiez également certaines choses à IDesign.net

Answer 2

'filename' suppose que ce mot décrit un objet singulier comme "vache" ou "chaise".
'fileName' suppose qu'il s'agit d'un objet complexe, qu'il existe un objet appelé fichier et que cet objet décrit le nom de ce fichier.

Deux approches philosophiques, faites votre choix.

Answer 3

En ce qui me concerne,

thisIsMuchMoreReadable que readingthis .

Answer 4

Je pense que les réponses ici couvrent deux questions.

• Nom de fichier" vs "Nom de fichier" (le mot "nom" devrait-il nom' devrait être un mot séparé)

  et

• fileName' vs 'FileName' (le premier caractère doit être une minuscule). caractère doit être minuscule).

Dans la plupart des cas, je préfère traiter ce mot comme un seul mot entier "filename". Je préfère également commencer les variables/méthodes en minuscules pour faciliter la navigation dans le menu de complétion de code.

Je suppose que la question de la casse est également présente ici, et je pense qu'elle devrait être utilisée pour distinguer les noms à plusieurs mots.

Answer 5

La réponse évidente n'est-elle pas que FxCop est un outil automatisé ? Il reconnaît que "nom" est un mot, et suggère donc de le commencer par un N majuscule. Nous savons que "nom de fichier" est également un mot, et donc que seul le premier F doit être mis en majuscule.