Mike ouvert libellé

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 abréger?

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



Comment nommez-vous les booléens?

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?



Comment appelez-vous vos fonctions?

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?