github.com/lmorg/murex@v0.0.0-20240217211045-e081c89cd4ef/docs/parser/pipe-posix.md (about)

     1  # `|` POSIX Pipe
     2  
     3  > Pipes STDOUT from the left hand command to STDIN of the right hand command
     4  
     5  ## Description
     6  
     7  This token behaves much like pipe would in Bash or similar shells. It passes
     8  STDOUT along the pipeline while merging STDERR stream with the parents STDERR
     9  stream.
    10  
    11  It can be used interchangeably with the arrow pipe, `->`, in shell scripts.
    12  
    13  
    14  
    15  ## Examples
    16  
    17  ```
    18  » out Hello, world! | regexp s/world/Earth/
    19  Hello, Earth!
    20  
    21  » out Hello, world!|regexp s/world/Earth/
    22  Hello, Earth!
    23  ```
    24  
    25  In this example the first command is writing to STDERR rather than STDOUT so
    26  `Hello, world!` doesn't get pipelined and thus isn't affected by `regexp`:
    27  
    28  ```
    29  » err Hello, world! | regexp s/world/Earth/
    30  Hello, world!
    31  ```
    32  
    33  ## See Also
    34  
    35  * [Pipeline](../user-guide/pipeline.md):
    36    Overview of what a "pipeline" is
    37  * [`->` Arrow Pipe](../parser/pipe-arrow.md):
    38    Pipes STDOUT from the left hand command to STDIN of the right hand command
    39  * [`<read-named-pipe>`](../parser/namedpipe.md):
    40    Reads from a Murex named pipe
    41  * [`=>` Generic Pipe](../parser/pipe-generic.md):
    42    Pipes a reformatted STDOUT stream from the left hand command to STDIN of the right hand command
    43  * [`?` STDERR Pipe](../parser/pipe-err.md):
    44    Pipes STDERR from the left hand command to STDIN of the right hand command (DEPRECATED)
    45  * [`err`](../commands/err.md):
    46    Print a line to the STDERR
    47  * [`out`](../commands/out.md):
    48    Print a string to the STDOUT with a trailing new line character
    49  * [`regexp`](../commands/regexp.md):
    50    Regexp tools for arrays / lists of strings
    51  
    52  <hr/>
    53  
    54  This document was generated from [gen/parser/pipes_doc.yaml](https://github.com/lmorg/murex/blob/master/gen/parser/pipes_doc.yaml).