Le faites vous updateDatabaseFields ()
ou udDBFields ()
? Ceci est Open Mike, une série de messages de discussion pour jeter le chat parmi les pigeons. Ces messages parlent de vous - nous voulons connaître votre opinion, vos idées et vos réflexions. Nous avons parlé de préfixes avant; maintenant parlons de la réelle mots vous utilisez pour nommer vos objets AS3.
Est-ce que vous épelez les mots entiers des noms de vos variables et fonctions ou utilisez-vous une sorte de sténographie??
checkAllOptionsHaveBeenEntered ()
contre. chkOptsEntd ()
Peut-être utilisez-vous un mélange: raccourci pour les mots de codage courants (comme num au lieu de nombre) et long pour les autres.
nombreDeTrophies
contre. numTrophies
Booléens: comme ils sont toujours vrais ou faux, j'aime bien les formuler de manière à pouvoir toujours répondre par «oui» ou par «non».
Exemples: hero.hasTheSword
, basketballPlayer.isQuiteTall
Les conventions de codage d’UrbanSquall vont plus loin et insistent pour que les noms booléens commencent toujours par est
, a
, ou pouvez
.
Et vous?
Les fonctions et méthodes impliquent généralement Faire quelque chose, il est donc logique de leur donner des noms qui sont des verbes (ou des associations ver / sujet).
Exemples: rafraîchir()
, annuler()
, recommencer le jeu()
, checkFormDataIsComplete ()
Suivez-vous cela comme une convention ou existe-t-il des cas où vous ne pourriez pas utiliser de verbe dans le nom de votre fonction??
Quand une fonction nécessite des arguments, essayez-vous de préciser à partir du nom quels arguments vous attendez?
Par exemple: pingPongBall.move (x, y)
contre. pingPongBall.moveTo (x, y)
Parfois, une fonction nécessite des arguments totalement différents, ce qui peut prêter à confusion. Par exemple, supposons que nous ayons un pistolet
objet qui déclenche une donnée balle
à une donnée cible
. Il existe quelques options pour ce que nous pourrions appeler cette méthode, notamment:
coup de feu (balle, cible); gun.fireAt (cible, balle); gun.fireAtTarget (cible, balle); gun.fireBulletAtTarget (balle, cible);
Ce qui est mieux?