base.Channel.openPipe

Syntax

openPipe(
   command STRING,
   mode STRING )

1. command is the system command to be executed.
2. mode is the open mode. Can be "r", "w" or "u" (combined with "b" if needed).

Usage

With the openPipe() method, you can read from the standard output of a subprocess, write to the standard input, or both.

Any of these modes can be followed by b, to use binary mode and avoid CR/LF translation on Windows® platforms. The binary mode is only required in specific cases, and will only take effect when writing data.

If the opening mode is not one of the above letters, the method will raise error -8085.

Some commands like the Unix tr command buffer the stdout stream. This may block the readLine() calls, when using the openPipe() method with "u" option, and writing to stdin / reading from stdout line by line. To avoid readLine() to block in such case, you must force the command to flush each line written to stdout, for example with the stdbuf -oL command.

When using the "u" mode to write to and read from a child process, it is possible to close only the writing stream with the closeOut() method. Using this method is equivalent to an EOF in a command-line pipe.

To get the exit status of the command executed by the pipe channel, use the getExitStatus() method after closing the channel with close().