Åpne Mike Ordtak

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.


Forkorter du?

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



Hvordan heter du Booleans?

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?



Hva kaller du dine funksjoner?

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?