Stderr Checking In Pipes (trypipeerr)

Checks state of each function in a pipeline and exits block on error

Description

trypipeerr checks the state of each function and exits the block if any of them fail. Where trypipeerr differs from regular tryerr blocks is trypipeerr will check every process along the pipeline as well as the terminating function (which tryerr only validates against). The downside to this is that piped functions can no longer run in parallel.

Usage

trypipeerr { code-block } -> <stdout>

<stdin> -> trypipeerr { -> code-block } -> <stdout>

Examples

trypipeerr {
    out "Hello, World!" -> grep: "non-existent string" -> cat
    out "This command will be ignored"
}

Formated pager (less) where the pager isn’t called if the formatter (pretty) fails (eg input isn’t valid JSON):

func pless {
    -> trypipeerr { -> pretty -> less }
}

Detail

A failure is determined by:

You can see which run mode your functions are executing under via the fid-list command.

See Also


This document was generated from builtins/core/structs/tryerr_doc.yaml.

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Tue Dec 10 22:56:57 UTC 2024 against commit 60f05a260f05a227caf73dd5b3478e3cb3f4bb24e46745b.

Current version is 6.4.1005 (develop) which has been verified against tests cases.