broadcast

Built-ins

Canonical ID: events.broadcast. Nederlands: zendBericht.

Queues every handler whose message literal exactly matches the argument, in source order. In a running event script it then yields cooperatively. During top-level initialization it records delivery for the later event phase. It is a local program event, not networking, a classroom message, or an operating-system broadcast. No matching handler is harmless.

Signature

broadcast(message)

Arguments

Parameter Type Requirement
message Text Nonempty Text; computed text is allowed here.

Return value

None.

Example

# language: en
let event = "go"
when started():
    broadcast(event)
when messageReceived("go"):
    say "A"
when messageReceived("go"):
    say "B"

Prints A, then B.

Notes and common mistakes

Use the function name for your source language. Its canonical ID is a shared documentation label; you do not type that ID as a call. Giving your own variable or function the same name can hide the built-in. Supply the documented arguments and value types. Pliro reports mismatches when checking can detect them, or when the call runs.

An event descriptor selects the event in a top-level when header, outside other blocks (E3201–E3203). A reporter is an ordinary function that returns a value, such as pointerX; broadcast is an ordinary call too. A handler is the block reacting to an event. Key and pointer handlers keep a run ready for future input and need host support (E4019). Pointer reporters need the current pointer event (E4020). The whole run has a shared event-work limit (E4018). Ordinary setup must finish before handlers get turns. See event rules and pointer positions.

started · after · messageReceived · keyPressed · pointerPressed · Programming guides · Host support · Calls and arguments