# vraag

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `input.readLine`. English: `ask`.

Vraagt de host om één tekstantwoord en wacht coöperatief. Het antwoord blijft Text, ook als het op een getal lijkt. Antwoorden zijn maximaal 64 KiB geldige [UTF-8](../begrippen/utf-8.md). Een ontbrekende of onbruikbare invoerhost geeft een gestructureerde invoerdiagnose. Dit is een programmavraag, geen ruwe terminal-, toetsenbordapparaat- of bestandstoegang.

## Aanroepvorm

```text
vraag(vraagtekst)
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `vraagtekst` | Text | Vraag die de host toont. |

## Terugkeerwaarde

`Text`.

## Voorbeeld

```pliro
# taal: nl
laat name = vraag("Name?")
zeg "Pliro", name
```

Vul een naam in; die verschijnt na `Pliro`.

## 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; onbeschikbare invoer geeft E4010. Toetsnamen en optieteksten zijn gegevens en veranderen niet bij syntaxisconversie. Voltooide vragen zijn coöperatieve controlepunten.

## Gerelateerde lemma’s

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