Source() action

The Source() action reads a file containing actions, and executes them one after the other. (This is in contrast to the Script() action action, which runs an executable program as a child process of the emulator, and that program can provide actions for the emulator to execute.)

If one of the actions fails, Source() will stop reading the file.

Parameters

filename

The pathname of a text file to read.

Blocking behavior

Source() blocks until all of the actions in the file have been executed, or one of them fails.

Return value

Source() returns the output of the actions executed.

Examples

Read actions from a file.

Source(C:\Users\Bob\foo.txt)