Gjør du updateDatabaseFields ()
eller udDBFields ()
? Dette er Open Mike, en rekke diskusjonsposter for å kaste katten blant duene. Disse innleggene handler om deg - vi vil høre dine meninger, ideer og tanker. Vi har snakket om prefikser før; nå la oss snakke om selve ord du bruker til å navngi dine AS3 objekter.
Staver du ut de fulle ordene til variablene dine 'og funksjoner' navn eller bruker du en slags stenografi?
checkAllOptionsHaveBeenEntered ()
vs. chkOptsEntd ()
Kanskje du bruker en blanding: shorthand for vanlige kodende ord (som num i stedet for nummer) og longhand for andre.
numberOfTrophies
vs. numTrophies
Booleans: siden disse er alltid enten sanne eller falske, liker jeg å ordne dem på en måte som alltid kan besvares 'ja' eller 'nei'.
eksempler: hero.hasTheSword
, basketballPlayer.isQuiteTall
UrbanSqualls kodingskonvensjoner går videre og insisterer på at boolske navn alltid begynner med er
, har
, eller kan
.
Hva med deg?
Funksjoner og metoder involverer generelt driver med noe, så det er vanligvis fornuftig å gi dem navn som er verb (eller verb-emne-parringer).
eksempler: forfriske()
, angre ()
, restartGame ()
, checkFormDataIsComplete ()
Følger du dette som en konvensjon, eller er det noen tilfeller der du kanskje ikke bruker et verb i funksjonsnavnet ditt?
Når en funksjon krever argumenter, prøver du å gjøre det klart fra navnet hvilke argumenter du forventer?
For eksempel: pingPongBall.move (x, y)
vs. pingPongBall.moveTo (x, y)
Noen ganger krever en funksjon helt forskjellige typer argumenter, noe som kan føre til forvirring. For eksempel, anta at vi har en våpen
objekt som branner en gitt kule
på en gitt mål
. Det er noen alternativer for hva vi kan kalle denne metoden, inkludert:
gun.fire (bullet, target); gun.fireAt (mål, kule); gun.fireAtTarget (mål, kule); gun.fireBulletAtTarget (kule, mål);
Som er bedre?