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

     1  # `?` STDERR Pipe
     2  
     3  > Pipes STDERR from the left hand command to STDIN of the right hand command (DEPRECATED)
     4  
     5  ## Description
     6  
     7  This token swaps the STDOUT and STDERR streams of the left hand command.
     8  
     9  Please note that this token is only effective when it is prefixed by white
    10  space.
    11  
    12  > This feature has been deprecated. Please use `<err> <!out>` instead. For example:
    13  > ```
    14  > command <err> <!out> parameter-1 parameter-2 -> next-command parameter-1
    15  > ```
    16  
    17  
    18  
    19  ## Examples
    20  
    21  ```
    22  » err Hello, world! ? regexp s/world/Earth/
    23  Hello, Earth!
    24  ```
    25  
    26  In following example the first command is writing to STDOUT rather than STDERR
    27  so `Hello, world!` doesn't get pipelined and thus isn't affected by `regexp`:
    28  
    29  ```
    30  » out Hello, world! ? regexp s/world/Earth/
    31  Hello, world!
    32  ```
    33  
    34  In following example the STDERR token isn't whitespace padded so is treated
    35  like any ordinary printable character:
    36  
    37  ```
    38  » err Hello, world!? regexp s/world/Earth/
    39  Hello, world!? regexp s/world/Earth/
    40  ```
    41  
    42  ## See Also
    43  
    44  * [Pipeline](../user-guide/pipeline.md):
    45    Overview of what a "pipeline" is
    46  * [`->` Arrow Pipe](../parser/pipe-arrow.md):
    47    Pipes STDOUT from the left hand command to STDIN of the right hand command
    48  * [`<read-named-pipe>`](../parser/namedpipe.md):
    49    Reads from a Murex named pipe
    50  * [`=>` Generic Pipe](../parser/pipe-generic.md):
    51    Pipes a reformatted STDOUT stream from the left hand command to STDIN of the right hand command
    52  * [`err`](../commands/err.md):
    53    Print a line to the STDERR
    54  * [`out`](../commands/out.md):
    55    Print a string to the STDOUT with a trailing new line character
    56  * [`regexp`](../commands/regexp.md):
    57    Regexp tools for arrays / lists of strings
    58  * [`|` POSIX Pipe](../parser/pipe-posix.md):
    59    Pipes STDOUT from the left hand command to STDIN of the right hand command
    60  
    61  <hr/>
    62  
    63  This document was generated from [gen/parser/pipes_doc.yaml](https://github.com/lmorg/murex/blob/master/gen/parser/pipes_doc.yaml).