Element: channel.rewind ( )

Type

numeric func

Description

A function to rewind input on channel with the result that the next read on channel will read the first line. This element is applicable only to text file channels open for read.

A value of 0 is returned when successful; 1 is returned on error.

The code of the function cannot be redefined.

Parameters

channel.rewind (<channel>)

The function may be called in one of two ways:

# Assume mychan is the channel identifier.
channel.rewind(mychan)

or

mychan.rewind()