$world->getline
$world->getline function: GETs a LINE from the scrollback buffer
$text = $world->getline( |
line
) ; |
($text, $time) = $world->getline( |
line
) ; |
This function allows you to retrieve a line from the scrollback buffer, and optionally the time in which it was received.
line
can be a positive number,
representing the number of the line to fetch, or a negative number. If
negative, that means that number of lines counting from the bottom.
(That is, -1 is the last received line, -2 the one before the last,
and so on.)
If the line cannot be retrieved (because it is not stored
anymore), returns undef
.
The time returned is represented as the number of seconds since
the epoch, the same kind of value the time
function would return.