waitfor(options) public

Read data from the host until a certain sequence is matched.

If a block is given, the received data will be yielded as it is read in (not necessarily all in one go), or nil if EOF occurs before any data is received. Whether a block is given or not, all data read will be returned in a single string, or again nil if EOF occurs before any data is received. Note that received data includes the matched sequence we were looking for.

options can be either a regular expression or a hash of options. If a regular expression, this specifies the data to wait for. If a hash, this can specify the following options:

Match

a regular expression, specifying the data to wait for.

Prompt

as for Match; used only if Match is not specified.

String

as for Match, except a string that will be converted

into a regular expression.  Used only if Match and
Prompt are not specified.

Timeout

the number of seconds to wait for data from the host

before raising a TimeoutError.  If set to false,
no timeout will occur.  If not specified, the
Timeout option value specified when this instance
was created will be used, or, failing that, the
default value of 10 seconds.

Waittime

the number of seconds to wait after matching against

the input data to see if more data arrives.  If more
data arrives within this time, we will judge ourselves
not to have matched successfully, and will continue
trying to match.  If not specified, the Waittime option
value specified when this instance was created will be
used, or, failing that, the default value of 0 seconds,
which means not to wait for more input.

FailEOF

if true, when the remote end closes the connection then an

EOFError will be raised. Otherwise, defaults to the old
behaviour that the function will return whatever data
has been received already, or nil if nothing was received.
Show source
Register or log in to add new notes.