|
IN stage v1.2 |
Pipelines v2.0 |
|
Purpose, Operands, Streams used, Usage notes, Examples, See also |
|
Syntax |
>>__IN_________________________________________________________________________________><
|
Purpose |
IN
is dual purpose. When IN is specified in a pipeline that is launched through
the CALLPIPE stage command; IN reads records from that calling pipeline. When
IN is specified in a pipeline that is connected to the STDOUT stream of another
WIN32 process; IN reads records from its STDIN stream. IN splits its input at Line-Feed characters;
discarding both individual and groups of Carriage-Return characters and writes the resulting records to its primary output stream.
|
Operands |
|
Streams used |
The following streams are used by the IN stage:
|
Stream |
Action |
|
|
|
|
Input streams |
IN
reads records from the CALLPIPE stage command of the calling pipeline or from
its STDIN stream. |
|
Primary output stream |
IN writes records to its primary output stream. |
|
Usage notes |
|
1) |
IN does not delay the records. |
|
2) |
When IN reads from its STDIN
stream, it reads its input records one at a time; waiting for each one to be
consumed from its primary output stream before reading another. When IN
reaches end-of-file on its STDIN stream, IN disconnects its primary output stream
and the stage ends. |
|
3) |
IN splits its input at Line-Feed characters; discarding both
individual and groups of Carriage-Return characters and writes the resulting
records to its primary output stream. IN discards the last Line-Feed
character of its input where this would produce a null output record. |
|
4) |
You
should only specify the IN stage command once in a pipeline; otherwise the
results will be unpredictable. |
|
5) |
IN verifies
that its secondary input and secondary output streams are not connected and
then begins execution. |
|
Examples |
The following
pipeline shows the path environment variable parsed into its individual values.
environ.rex
**** Top of file ****01 Address Rxpipe0203 ‘pipe in | split at str /;/ | specs ws /=/ w-1 1 | cons’0405 Exit 0**** End of file **** C:\>path | environ.rex Output:C:\WINDOWS\system32C:\WINDOWSC:\WINDOWS\System32\WbemC:\Program files\TenFiftyTwo\Pipelines
|
See also |
Reference the following links for additional information: CALLPIPE, CONSOLE, OUT