Bash read: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
Line 9: Line 9:
Read a line from the stdin or from the file descriptor specified with -u, and assign the first word to the variable associated with the first name, the second to the variable associated with the second name, and so on, with the leftover words and their intervening separators assigned to the variable associated with the last name. If there are fewer words than variable names, the variables associated with the remaining names are assigned empty values. If no names are supplied, the line read is assigned to the variable REPLY.   
Read a line from the stdin or from the file descriptor specified with -u, and assign the first word to the variable associated with the first name, the second to the variable associated with the second name, and so on, with the leftover words and their intervening separators assigned to the variable associated with the last name. If there are fewer words than variable names, the variables associated with the remaining names are assigned empty values. If no names are supplied, the line read is assigned to the variable REPLY.   


The words are split using the [[Bash_Environment_Variables#IFS_and_read|IFS characters]]. The backslash character (\) may be used to remove any special meaning for the next character read and  for line continuation.
The words are split using the [[Bash_Built-In_Variables#IFS_and_read|IFS characters]]. The backslash character (\) may be used to remove any special meaning for the next character read and  for line continuation.


The return code  is  zero, unless  end-of-file is encountered, read times out, or an invalid file descriptor is supplied as the argument to -u.
The return code  is  zero, unless  end-of-file is encountered, read times out, or an invalid file descriptor is supplied as the argument to -u.

Revision as of 01:39, 24 September 2017

Internal

Overview

read [-p prompt] name name2 ...

Read a line from the stdin or from the file descriptor specified with -u, and assign the first word to the variable associated with the first name, the second to the variable associated with the second name, and so on, with the leftover words and their intervening separators assigned to the variable associated with the last name. If there are fewer words than variable names, the variables associated with the remaining names are assigned empty values. If no names are supplied, the line read is assigned to the variable REPLY.

The words are split using the IFS characters. The backslash character (\) may be used to remove any special meaning for the next character read and for line continuation.

The return code is zero, unless end-of-file is encountered, read times out, or an invalid file descriptor is supplied as the argument to -u.

If -p prompt option is used, read displays the specified prompt on standard error, without a trailing new-line, before attempting to read any input. The prompt is displayed only if input is coming from a terminal.

Timeout

-t timeout

causes read to timeout and return failure if a complete line of input is not read within timeout seconds. This option only works if read is reading input from stdin or a pipe.

Fixed Number of Characters

-n nchars

If -n option is used read returns after reading nchars characters rather than waiting for a complete line of input.

Array Assignment

-a aname

If -a option is used, he words are assigned to sequential indices of the array variable aname, starting at 0. aname is unset before any new values are assigned. Other name arguments are ignored.

Silent Mode

-s

If input is coming from a terminal, characters are not echoed.

Examples

Confirmation to Proceed

function shall-we-proceed() {

    echo ""
    echo "This operation is dangerous, shall we proceed?"
    echo ""

    local answer

    read -p "y/n: " -n 1 answer || answer="n"

    echo ""

    [ "${answer}" = "y" ] && return 0 || return 1
}

#
# usage
#

if ! shall-we-procced; then
   echo "not proceeding ..."
   exit 0
fi