laadGegeven
Canonieke ID: storage.get. English: loadData.
Laadt een nieuwe kopie van de opgeslagen waarde, of van de standaardwaarde wanneer de sleutel ontbreekt. Ook de standaardwaarde moet JSON-compatibel zijn. Wijzigen van een teruggegeven verzameling schrijft niets terug: roep bewaarGegeven expliciet aan. None kan een opgeslagen waarde zijn en betekent dus niet automatisch dat een sleutel ontbreekt.
Aanroepvorm
laadGegeven(sleutel, standaard)
Argumenten
| Parameter | Type | Vereiste |
|---|---|---|
sleutel |
Text | Niet leeg, geen omringende witruimte/besturingstekens, maximaal 128 UTF-8-bytes. |
standaard |
JSON-compatible | Wordt als nieuwe kopie teruggegeven wanneer de sleutel ontbreekt. |
Terugkeerwaarde
Opgeslagen waarde of standaard.
Voorbeeld
# taal: nl
verwijderGegeven("new-score")
laat fallback = [0]
laat score = laadGegeven("new-score", fallback)
zet score[0] = 7
zeg fallback[0]
Toont 0; de standaardwaarde wordt gekopieerd.
Aandachtspunten en veelgemaakte fouten
Gebruik de functienaam van je brontaal. De canonieke ID is een gezamenlijk documentatielabel; die ID typ je niet als aanroep. Een eigen variabele of functie met dezelfde naam kan de ingebouwde functie verbergen. Geef de beschreven argumenten en waardesoorten mee. Pliro meldt verschillen wanneer controle ze kan vinden, of wanneer de aanroep draait.
Sleutels en opgeslagen tekst worden niet vertaald. Limieten zijn 128 sleutels, 64 KiB per JSON-waarde, 512 KiB per document, 32 nestniveaus en 8.192 waarden/nodes per waarde. Functies, niet-eindige getallen en maps zonder uitsluitend tekstsleutels zijn niet op te slaan. Een bruikbare projectidentiteit geeft blijvende gegevens; losse bron tijdelijke sessieopslag. Zie de opslaggids voor E4014–E4017 en kopie-/identiteitsregels.
Gerelateerde lemma’s
bewaarGegeven · verwijderGegeven · bewaardeSleutels · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten