berichtOntvangen

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

wanneer berichtOntvangen("bericht"):

Argumenten

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

Terugkeerwaarde

Gebeurtenisbeschrijving.

Voorbeeld

# 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 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.

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 (E4019). Aanwijzeruitleesfuncties hebben de huidige aanwijzergebeurtenis nodig (E4020). De hele uitvoering deelt één grens voor gebeurteniswerk (E4018). De gewone voorbereiding moet klaar zijn vóór handlers beurten krijgen. Zie gebeurtenisregels en aanwijzerposities.

Gerelateerde lemma’s

gestart · na · toetsGedrukt · aanwijzerGedrukt · aanwijzerLosgelaten · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten