Duidelijke namen kiezen
Een naam vertelt de lezer wat een waarde of een stukje code betekent. score geeft een nuttige aanwijzing. x kan een score, een positie, een prijs of bijna alles betekenen.
Je schrijft code één keer, maar leest die vaak opnieuw. Duidelijke namen helpen je latere zelf en iemand die je helpt.
Geef de dozen een etiket
Stel je twee dozen voor met ‘spullen’ en ‘meer spullen’ erop. Je tekenpotloden vinden zou langer duren dan wanneer op één doos ‘tekenpotloden’ stond. Variabelen zijn geen echte kartonnen dozen, maar duidelijke etiketten helpen op dezelfde manier.
Een goede naam beschrijft waarvoor de waarde dient. Voeg een eenheid toe als verwarring mogelijk is. afstandPixels en wachtSeconden vertellen meer dan hoeveelheid. Houd namen redelijk kort zonder er raadsels van te maken.
Lees deze berekening
# taal: nl
laat verzameldeSterren = 4
laat puntenPerSter = 3
laat totaleScore = verzameldeSterren * puntenPerSter
zeg "Score:", totaleScore
De namen verklaren beide getallen en de berekende score. De hoofdletters geven aan waar nieuwe woorden beginnen. Die schrijfwijze heet camelCase. Het is een keuze voor jouw namen, geen verplichting voor elke naam.
Voorspel en probeer
Hoeveel punten krijg je per ster? Welke uitvoer verschijnt?
Score: 12
De eerste vraag kun je beantwoorden door de naam puntenPerSter te lezen. Daarvoor heb je geen apart commentaar nodig.
Jouw uitdaging
Verander het spel van sterren naar schelpen. Pas de namen aan en werk elke plek bij waar zo’n naam wordt gebruikt. Laat de getallen hetzelfde. Het resultaat moet nog steeds twaalf zijn.
Een veelgemaakte fout
Als je een naam bij het aanmaken verandert maar later vergeet, kan er een onbekende naam achterblijven. Pliro maakt ook verschil tussen hoofdletters en kleine letters: score en Score zijn verschillende namen.
Gebruik geen sleutelwoord, zoals als, als eigen naam. Gebruik ook liever geen ingebouwde functienaam, zoals zeg, voor gewone gegevens. Daardoor kun je de functie verbergen die je juist wilde gebruiken. Jouw eigen namen worden niet automatisch vertaald wanneer Pliro de syntaxis omzet.