1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2025-10-23 04:30:24 +02:00

12073: read -t to test for available input before reading

This commit is contained in:
Peter Stephenson 2000-06-26 15:00:27 +00:00
parent 326e04c360
commit acda8dc256
4 changed files with 164 additions and 17 deletions

View file

@ -751,7 +751,7 @@ contain symbolic links.
alias(r)(fc -e -)
findex(read)
vindex(IFS, use of)
item(tt(read) [ tt(-rzpqAclneE) ] [ tt(-k) [ var(num) ] ] \
item(tt(read) [ tt(-rzpqAclneEt) ] [ tt(-k) [ var(num) ] ] \
[ tt(-u)var(n) ] [ var(name)[tt(?)var(prompt)] ] [ var(name) ... ])(
Read one line and break it into fields using the characters
in tt($IFS) as separators, except as noted below.
@ -822,6 +822,22 @@ digit and must em(not) be separated from tt(-u) by any whitespace.
item(tt(-p))(
Input is read from the coprocess.
)
item(tt(-t))(
Test if input is available before attempting to read; if none is, return
status 1 and do not set any variables. This is not available when reading
from the editor buffer with tt(-z), when called from within completion
with tt(-c) or tt(-l), with tt(-q) which clears the input queue before
reading, or within zle where other mechanisms should be used to test for
input.
Note that read does not attempt to alter the input processing mode. The
default mode is canonical input, in which an entire line is read at a time,
so usually `tt(read -t)' will not read anything until an entire line has
been typed. However, when reading from the terminal with tt(-k)
this is automatically handled; note that only availablity of the first
character is tested, so that e.g. `tt(read -t -k 2)' can still block on the
second character.
)
enditem()
If the first argument contains a `tt(?)', the remainder of this