Apri Mike testo

Fai updateDatabaseFields () o udDBFields ()? Questo è Open Mike, una serie di post di discussione per gettare il gatto tra i piccioni. Questi post riguardano tutto te - vogliamo ascoltare le tue opinioni, idee e pensieri. Abbiamo parlato di prefissi prima; ora parliamo del reale parole usi per nominare i tuoi oggetti AS3.


Abbreviare?

Esprimi le parole complete dei nomi delle variabili e delle funzioni o usi una sorta di stenografia?

checkAllOptionsHaveBeenEntered () vs. chkOptsEntd ()

Forse usi una mistura: abbreviazione di parole di codifica comuni (come num invece di numero) e longhand per altri.

numberOfTrophies vs. numTrophies



Come si fa a denominare booleani?

Booleans: poiché questi sono sempre o veri o falsi, mi piace esprimerli in un modo che possa sempre essere risposto "sì" o "no".

Esempi: hero.hasTheSword, basketballPlayer.isQuiteTall

Le convenzioni di programmazione di UrbanSquall vanno oltre e insistono sul fatto che i nomi booleani iniziano sempre con è, ha, o può.

E tu?



Come chiamate le tue funzioni?

Le funzioni e i metodi generalmente coinvolgono fare qualcosa, quindi di solito ha senso dare loro nomi che sono verbi (o abbinamenti soggetto-verbo).

Esempi: ricaricare(), disfare(), restartGame (), checkFormDataIsComplete ()

Lo segui come una convenzione, o ci sono casi in cui potresti non usare un verbo nel nome della tua funzione?


Quando una funzione richiede argomenti, provi a chiarire dal nome quali argomenti ti aspetti?

Per esempio: pingPongBall.move (x, y) vs. pingPongBall.moveTo (x, y)

A volte una funzione richiede tipi di argomenti completamente diversi, che possono portare a confusione. Ad esempio, supponiamo di avere un pistola oggetto che spara un dato proiettile ad un dato bersaglio. Ci sono alcune opzioni per ciò che potremmo chiamare questo metodo, tra cui:

 gun.fire (proiettile, bersaglio); gun.fireAt (bersaglio, proiettile); gun.fireAtTarget (target, bullet); gun.fireBulletAtTarget (bullet, target);

Che è migliore?