# Duidelijke namen kiezen

[Programmeergidsen](LEESMIJ.md)

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

```pliro
# 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?

```text
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.

## Verder leren

[Namen en sleutelwoorden](../syntaxis/namen.md) · [Code verbeteren](code-verbeteren.md) · [Commentaar](../syntaxis/commentaar.md)