# berichtOntvangen

[Ingebouwde functies](LEESMIJ.md)

Canonieke ID: `events.messageReceived`. English: `messageReceived`.

Registreert een script voor een exacte, hoofdlettergevoelige berichtnaam. De naam staat rechtstreeks als niet-lege tekstliteral in de kop. Iedere passende uitzending maakt een nieuwe aanroep met verse lokale variabelen; globale variabelen blijven gedeeld. Alleen berichtscripts registreren houdt een verder afgerond programma niet open voor externe berichten.

## Aanroepvorm

```text
wanneer berichtOntvangen("bericht"):
```

## Argumenten

| Parameter | Type | Vereiste |
|---|---|---|
| `bericht` | Text literal | Directe niet-lege literal; exacte vergelijking, geen impliciete vertaling. |

## Terugkeerwaarde

Gebeurtenisbeschrijving.

## Voorbeeld

```pliro
# taal: nl
wanneer gestart():
    zendBericht("go")
wanneer berichtOntvangen("go"):
    zeg "Pliro"
```

Toont eenmaal `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.

Een **gebeurtenisbeschrijving** kiest de gebeurtenis in een `wanneer`-kop op programmaniveau, buiten andere blokken (`E3201`–`E3203`). Een **uitleesfunctie** is een gewone functie die een waarde teruggeeft, zoals `aanwijzerX`; ook `zendBericht` is een gewone aanroep. Een **handler** is het blok dat reageert. Toets- en aanwijzerhandlers houden een uitvoering gereed voor volgende invoer en vereisen [hostondersteuning](../gidsen/uitvoeromgevingen.md) (`E4019`). Aanwijzeruitleesfuncties hebben de huidige aanwijzergebeurtenis nodig (`E4020`). De hele uitvoering deelt één [grens voor gebeurteniswerk](../gidsen/uitvoergrenzen.md) (`E4018`). De gewone voorbereiding moet klaar zijn vóór handlers beurten krijgen. Zie [gebeurtenisregels](../gidsen/gebeurtenissen.md) en [aanwijzerposities](../gidsen/aanwijsapparaten.md).

## Gerelateerde lemma’s

[gestart](gestart.md) · [na](na.md) · [toetsGedrukt](toetsGedrukt.md) · [aanwijzerGedrukt](aanwijzerGedrukt.md) · [aanwijzerLosgelaten](aanwijzerLosgelaten.md) · [Programmeergidsen](../gidsen/gebeurtenissen.md) · [Hostondersteuning](../gidsen/uitvoeromgevingen.md) · [Aanroepen en argumenten](../syntaxis/aanroepen.md)