# kies

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `input.choose`. English: `choose`.

Biedt een begrensde verzameling tekstkeuzes en geeft exact de geselecteerde optietekst terug. Opties zijn uniek op exacte, hoofdlettergevoelige vergelijking en mogen niet blank zijn. Het resultaat is geen index. Optietekst wordt niet automatisch vertaald; kies de toepassingswoorden zelf.

## Aanroepvorm

```text
kies(vraagtekst, opties)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `vraagtekst` | Text | Vraag die de host toont. |
| `opties` | List<Text> | 1–100 unieke, niet-blanke tekstopties. |

## Terugkeerwaarde

`Text`.

## Voorbeeld

```pliro
# taal: nl
laat color = kies("Color?", ["red", "groen", "blue"])
wisScherm(color)
```

De gekozen kleur vult het grafische beeld; een consolehost geeft nog steeds de gekozen tekst terug.

## Aandachtspunten en veelgemaakte fouten

Gebruik de functienaam van je brontaal. De [canonieke ID](../begrippen/canonieke-identiteit.md) 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](../begrippen/parameters-en-argumenten.md) en waardesoorten mee. Pliro meldt verschillen wanneer controle ze kan vinden, of wanneer de aanroep draait.

De gekozen host bemiddelt invoer. Programma-antwoorden zijn maximaal 64 KiB geldige [UTF-8](../begrippen/utf-8.md); onbeschikbare invoer geeft E4010. Toetsnamen en optieteksten zijn gegevens en veranderen niet bij syntaxisconversie. Voltooide vragen zijn coöperatieve controlepunten.

## Gerelateerde lemma’s

[vraag](vraag.md) · [vraagGetal](vraagGetal.md) · [vraagJaNee](vraagJaNee.md) · [toetsIngedrukt](toetsIngedrukt.md) · [Programmeergidsen](../gidsen/invoer.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)