Description:
SEND transmits data to a subprocess, but only on multi-user systems. The data
to be sent is passed as the first parameter. The receiving subprocess is passed
as the second parameter. Control does not return to the edit session until the
process responds to the text sent. When the text sent to a subprocess is a
range or buffer, the lines of text are considered separate records. User output
from the subprocess is sent to the buffer bound to the process during the
CREATE_PROCESS built-in.
Syntax:
SEND ( {buffer | range | string}, process)
Example:
The following command sends data from the current buffer (as defined by the
nu/TPU built-in CURRENT_BUFFER) to the subprocess user_process.
SEND (CURRENT_BUFFER, user_process);
Errors:
TPU$_CONTROLC Execution aborted by [CTRL-C].
TPU$_DELETEFAIL Couldn't terminate subprocess.
TPU$_NOPROCESS Subprocess already terminated.
TPU$_NOTMODIFIABLE Output buffer is READ_ONLY.
TPU$_SENDFAIL Subprocess would not read data.
Related Builtins:
SEND