reada line of input from the user and store as a variable
A readline function to allow a line of data inputed from the terminal.
read: "prompt" var_name <stdin> -> read: var_name
read: [ --prompt "prompt" ] [ --variable var_name ] [ --default "default value" ] [ --datatype data-type ] [ --mask character ]
read: "What is your name? " name out: "Hello $name" out: What is your name? -> read: name out: "Hello $name"
read: --prompt "Are you sure? [Y/n]" \ --variable yn \ --default Y
read: --prompt "Password: " --variable pw --mask *
--datatypemurex data-type for the read data (default: str)
--defaultIf a zero length string is returned but neither ctrl+c nor ctrl+d were pressed, then the default value defined here will be returned
--maskOptional password mask, for reading secrets
--promptUser notification to display
--variableVariable name to store the read data (default: read)
read 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
read will not write a prompt.
The last parameter will be the variable name to store the string read by
read. 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.
The data type the
read line will be stored as is
str (string). If you require this to be different then please use
tread (typed read) or call
read with the
--datatype flag as per the script usage.
((brace quote): Write a string to the STDOUT without new line
>>(append file): Writes STDIN to disk - appending contents if file already exists
>(truncate file): Writes STDIN to disk - overwriting contents if file already exists
cast: Alters the data type of the previous function without altering it’s output
err: Print a line to the STDERR
out: Print a string to the STDOUT with a trailing new line character
tout: Print a string to the STDOUT and set it’s data-type
reada line of input from the user and store as a user defined typed variable
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 Thu Oct 13 08:08:18 UTC 2022 against commit ed6b6fced6b6fc609f4be93c5d3348695a762facfecf48f.
Current version is 2.11.2200 which has been verified against 16798 tests cases.