TinyMUX

@include

Commands

Description

COMMAND: @include[/] /

Includes the contents of an attribute in the current command stream. Unlike @trigger, which queues commands for later execution, @include inserts the commands directly into the currently executing action list, allowing them to share the same evaluation context.

If present, can be any combination of:

/nobreak - Prevents a @break or @assert within the included attribute from propagating back to the calling action list.

/localize - Saves and restores the registers (%q0-%q9, %qa-%qz) around the execution of the included attribute, so that register changes within the included code do not affect the caller.

/clearregs - Clears all registers before executing the included attribute.

Examples

> @include me/SUBROUTINE

Includes the commands from the SUBROUTINE attribute into the current execution stream.

> @include/localize me/HELPER

Includes HELPER while preserving the current register values.

> @include/nobreak/localize me/SAFECALL

Includes SAFECALL with both break isolation and register preservation.

@trigger, @break, @assert.