Error String (err)

Print a line to the stderr

Description

Write parameters to stderr with a trailing new line character.

Usage

err string to write -> <stderr>

Examples

» err Hello, World!
Hello, World!

Detail

err outputs as string data-type. This can be changed by casting

err { "Code": 404, "Message": "Page not found" } ? cast json

However passing structured data-types along the stderr stream is not recommended as any other function within your code might also pass error messages along the same stream and thus taint your structured data. This is why Murex does not supply a tout function for stderr. The recommended solution for passing messages like these which you want separate from your stdout stream is to create a new Murex named pipe.

» pipe --create messages
» bg { <messages> -> pretty }
» tout <messages> json { "Code": 404, "Message": "Page not found" }
» pipe --close messages
{
    "Code": 404,
    "Message": "Page not found"
}

ANSI Constants

err supports ANSI constants.

Synonyms

• err

See Also

• ANSI Constants: Infixed constants that return ANSI escape sequences
• Background Process (bg): Run processes in the background
• Create Named Pipe (pipe): Manage Murex named pipes
• Define Type (cast): Alters the data-type of the previous function without altering its output
• Get Pipe Status (pt): Pipe telemetry. Writes data-types and bytes written
• Output String (out): Print a string to the stdout with a trailing new line character
• Output With Type Annotation (tout): Print a string to the stdout and set it's data-type
• Prettify JSON: Prettifies JSON to make it human readable
• Read / Write To A Named Pipe (<pipe>): Reads from a Murex named pipe
• Truncate File (>): Writes stdin to disk - overwriting contents if file already exists
• (brace quote): Write a string to the stdout without new line (deprecated)
• >> Append File: Writes stdin to disk - appending contents if file already exists

---

This document was generated from builtins/core/io/echo_doc.yaml.