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

     1  # `->` Arrow 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  `->` differs from `|` in the interactive terminal where it produces different
    12  autocompletion suggestion. It returns a list of "methods". That is, commands
    13  that are known to support the output type of the previous command. `->` helps
    14  with the discovery of commandline tools.
    15  
    16  In shell scripts, `->` and `|` can be used interchangeably.
    17  
    18  
    19  
    20  ## Examples
    21  
    22  ```
    23  » out Hello, world! -> regexp s/world/Earth/
    24  Hello, Earth!
    25  
    26  » out Hello, world!->regexp s/world/Earth/
    27  Hello, Earth!
    28  ```
    29  
    30  In following example the first command is writing to STDERR rather than STDOUT
    31  so `Hello, world!` doesn't get pipelined and thus isn't affected by `regexp`:
    32  
    33  ```
    34  » err Hello, world! -> regexp s/world/Earth/
    35  Hello, world!
    36  ```
    37  
    38  ## See Also
    39  
    40  * [Pipeline](../user-guide/pipeline.md):
    41    Overview of what a "pipeline" is
    42  * [`<read-named-pipe>`](../parser/namedpipe.md):
    43    Reads from a Murex named pipe
    44  * [`=>` Generic Pipe](../parser/pipe-generic.md):
    45    Pipes a reformatted STDOUT stream from the left hand command to STDIN of the right hand command
    46  * [`?` STDERR Pipe](../parser/pipe-err.md):
    47    Pipes STDERR from the left hand command to STDIN of the right hand command (DEPRECATED)
    48  * [`err`](../commands/err.md):
    49    Print a line to the STDERR
    50  * [`out`](../commands/out.md):
    51    Print a string to the STDOUT with a trailing new line character
    52  * [`regexp`](../commands/regexp.md):
    53    Regexp tools for arrays / lists of strings
    54  * [`|` POSIX Pipe](../parser/pipe-posix.md):
    55    Pipes STDOUT from the left hand command to STDIN of the right hand command
    56  
    57  <hr/>
    58  
    59  This document was generated from [gen/parser/pipes_doc.yaml](https://github.com/lmorg/murex/blob/master/gen/parser/pipes_doc.yaml).