| POSIX Pipe

Pipes stdout from the left hand command to stdin of the right hand command

Description

This token behaves much like pipe would in Bash or similar shells. It passes stdout along the pipeline while merging stderr stream with the parents stderr stream.

It can be used interchangeably with the arrow pipe, ->, in shell scripts.

Examples

Piping stdout

» out Hello, world! | regexp s/world/Earth/
Hello, Earth!

» out Hello, world!|regexp s/world/Earth/
Hello, Earth!

Piping stderr

In following example the first command is writing to stderr rather than stdout so Hello, world! doesn't get pipelined and thus isn't affected by regexp:

» err Hello, world! | regexp s/world/Earth/
Hello, world!

To pipe stderr you'd need to use the <!> syntax. For example <!out> to write stderr to stdout:

» err <!out> Hello, world! | regexp s/world/Earth/
Hello, Earth!

See Also

• Error String (err): Print a line to the stderr
• Output String (out): Print a string to the stdout with a trailing new line character
• Pipeline: Overview of what a "pipeline" is
• Read / Write To A Named Pipe (<pipe>): Reads from a Murex named pipe
• Regex Operations (regexp): Regexp tools for arrays / lists of strings
• -> Arrow Pipe: Pipes stdout from the left hand command to stdin of the right hand command
• => Generic Pipe: Pipes a reformatted stdout stream from the left hand command to stdin of the right hand command
• ? stderr Pipe: Pipes stderr from the left hand command to stdin of the right hand command (DEPRECATED)

---

This document was generated from gen/parser/pipes_doc.yaml.