Gör du updateDatabaseFields ()
eller udDBFields ()
? Det här är Open Mike, en serie diskussionsposter för att kasta katten bland duvorna. Dessa inlägg handlar om dig - vi vill höra era åsikter, idéer och tankar. Vi har talat om prefix innan nu ska vi prata om själva ord du använder för att namnge dina AS3-objekt.
Ställer du ut de fullständiga orden i dina variabler "och fungerar namn eller använder du någon typ av stenografi?
checkAllOptionsHaveBeenEntered ()
mot. chkOptsEntd ()
Kanske använder du en blandning: stenografi för vanliga kodande ord (som num istället för nummer) och longhand för andra.
numberOfTrophies
mot. numTrophies
Booleaner: Eftersom dessa alltid är antingen sanna eller falska, tycker jag om att ordna dem på ett sätt som alltid kan svaras "ja" eller "nej".
Exempel: hero.hasTheSword
, basketballPlayer.isQuiteTall
UrbanSqualls kodningskonventioner går vidare och insisterar på att booleska namn alltid börjar med är
, har
, eller kan
.
Hur är det med dig?
Funktioner och metoder involverar i allmänhet gör något, så det brukar vara meningsfullt att ge dem namn som är verb (eller verb-ämnesföreningar).
Exempel: uppdatera ()
, ångra()
, restartGame ()
, checkFormDataIsComplete ()
Följ du detta som en konvention, eller finns det några fall där du kanske inte använder ett verb i ditt funktionsnamn?
När en funktion kräver argument försöker du göra klart från namnet vilka argument du förväntar dig?
Till exempel: pingPongBall.move (x, y)
mot. pingPongBall.moveTo (x, y)
Ibland kräver en funktion helt olika typer av argument, vilket kan leda till förvirring. Anta till exempel att vi har en pistol
objekt som bränder en given kula
vid en given mål
. Det finns några alternativ för vad vi kan kalla den här metoden, inklusive:
gun.fire (kula, mål); gun.fireAt (mål, bullet); gun.fireAtTarget (mål, kula); gun.fireBulletAtTarget (kula, mål);
Vilket är bättre?