# JSON: een tekstformaat voor gegevens

[Begrippen uitgelegd](LEESMIJ.md)

**JSON** betekent *JavaScript Object Notation*. Het is een manier om gestructureerde gegevens als tekst te schrijven, zodat verschillende programma's ze kunnen uitwisselen. Je hoeft geen JavaScript te leren om een klein JSON-document te lezen.

## Lees een spelerskaart

Dit zijn JSON-gegevens, geen Pliro-programma:

```json
{"naam": "Mila", "score": 12, "medailles": ["starter"], "klaar": true}
```

De accolades groeperen benoemde waarden. `"score"` is een sleutel en `12` is de bijbehorende waarde. De vierkante haakjes bevatten een lijst. JSON noemt de groep met accolades een **object** en de lijst een **array**.

JSON kent tekst, getallen, waar/onwaar-waarden, arrays, objecten en `null` voor geen waarde. Sleutels zijn tekst tussen dubbele aanhalingstekens. JSON staat geen commentaar of afsluitende komma's toe. Deze regels staan in de [JSON-standaard](https://www.rfc-editor.org/rfc/rfc8259) (Engels).

## Bij gegevens bewaren in Pliro

Een Pliro-map lijkt erop, maar volgt Pliro's eigen regels. Pliro gebruikt `geen` waar JSON `null` gebruikt; ook `waar` en `onwaar` zijn Pliro-woorden. De woorden van JSON blijven in het Nederlands onveranderd: `true`, `false` en `null`.

Pliro's bewaarfuncties accepteren JSON-geschikte waarden. Dat zijn waarden die je met deze gegevenssoorten kunt weergeven. Functies kun je niet als JSON bewaren. De opslaglaag regelt de omzetting; je geeft gewone Pliro-waarden aan `bewaarGegeven`.

Je hoeft geen JSON-tekst samen te stellen om een score te bewaren. Bij [gegevens bewaren](../gidsen/gegevens-bewaren.md) staan de ondersteunde aanroepen en grenzen. Dit artikel introduceert geen ingebouwde JSON-leesfunctie.

Lees de kaart hardop: wat is de waarde van `klaar` en hoeveel medailles staan erin?