Linux in a Nutshell, 6th Edition

Name

read

Synopsis

read [options] [variable1] [variable2 ...]

Read one line of standard input and assign each word to the corresponding variable, with all leftover words assigned to the last variable. If only one variable is specified, the entire line is assigned to that variable. See the examples here and under case. The return status is 0 unless EOF is reached. If no variables are given, input is stored in the REPLY variable.

Options

-a array

Read into indexed array array.

-d delim

Read up to first occurrence of delim, instead of newline.

-e

Use the readline library if reading from a terminal.

-i text

If readline is being used, put text into the editing buffer.

-n count

Read at most count bytes.

-p prompt

Print prompt before reading input.

-r

Raw mode; ignore \ as a line-continuation character.

-s

Read silently; do not echo characters.

-t timeout

When reading from a terminal or pipe, if no data is entered after timeout seconds, return 1. This prevents an application from hanging forever, waiting for user input.

-u [n]

Read input from file descriptor n (default is 0).

Example

Read three variables:

$ read first last address
Sarah Caldwell 123 Main Street

$ echo "$last, $first\n$address"
Caldwell, Sarah
123 Main Street