Read With Type: tread

This feature has been deprecated and thus the following documentation is provided for historical reference rather than recommendations for new code.

While we do make every effort to maintain backwards compatibility, sometimes deprecations need to be made in order to keep Murex focused and maintainable. Please read our compatibility commitment for more information on Murex's compatibility commitment, and visit the deprecated section if you need to research other deprecated features.

read a line of input from the user and store as a user defined typed variable (removed 7.0)

Description

A readline function to allow a line of data inputted from the terminal and then store that as a typed variable.

This builtin is now deprecated. Please use read --datatype ... instead

Usage

tread data-type "prompt" var_name

<stdin> -> tread data-type var_name

Examples

tread qs "Please paste a URL: " url
out "The query string values included were:"
$url -> format json

out Please paste a URL: -> tread qs url
out "The query string values included were:"
$url -> format json

Detail

If tread is called as a method then the prompt string is taken from stdin. Otherwise the prompt string will be the first parameter. However if no prompt string is given then tread will not write a prompt.

The last parameter will be the variable name to store the string read by tread. This variable cannot be prefixed by dollar, $, otherwise the shell will write the output of that variable as the last parameter rather than the name of the variable.

See Also

• Define Type: cast: Alters the data-type of the previous function without altering its output
• Error String, strerr: err: Print a line to the stderr
• Output String, stdout: 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 Objects: pretty: Prettifies data documents to make it human readable
• Read User Input: read: read a line of input from the user and store as a variable
• Reformat Data Type: format: Reformat one data-type into another data-type
• %(Brace Quote): Initiates or terminates a string (variables expanded)

---

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