Read Me - Common Public License V1.0 - Copyright Notice(©)

state


>>-state-------------------------------------------------------><

Returns a string indicating the current stream state.

The returned strings are as follows:

ERROR

The stream has been subject to an erroneous operation (possibly during input, output, or through the STREAM function). See . You might be able to obtain additional information about the error with the [description] method or by calling the STREAM function with a request for the description.

NOTREADY

The stream is known to be in such a state that the usual input or output operations attempted upon would raise the NOTREADY condition. (See .) For example, a simple input stream can have a defined length. An attempt to read that stream (with CHARIN or LINEIN, perhaps) beyond that limit can make the stream unavailable until the stream has been closed (for example, with LINEOUT( [name] )) and then reopened.

READY

The stream is known to be in such a state that the usual input or output operations might be attempted. This is the usual state for a stream, although it does not guarantee that any particular operation will succeed.

UNKNOWN

The state of the stream is unknown. This generally means that the stream is closed or has not yet been opened.

Read Me - Common Public License V1.0 - Copyright Notice(©)