home
wiki
classes/clusters list
class information
+
Point of view
WEAK_ARRAY
ANY
FILTER
STREAM_HANDLER
WEAK_ARRAY
INTERNALS_HANDLER
All features
deferred class STREAM
Summary
top
A stream of characters.
There are two kinds of streams: + input streams (see
INPUT_STREAM
) + output_streams (see
OUTPUT_STREAM
)
Streams can: + be connected (e.g. to some system object) + be used ot read or write characters, only if they are connected + be filtered (see
FILTER
)
Direct parents
insert list:
RECYCLABLE
Known children
inherit list:
INPUT_STREAM
,
OUTPUT_STREAM
Overview
top
exported features
is_connected
:
BOOLEAN
True if the stream is connected.
disconnect
Try to disconnect the stream.
descriptor
:
INTEGER_32
Some OS-dependent descriptor.
has_descriptor
:
BOOLEAN
True if that stream can be associated to some OS-meaningful descriptor.
can_disconnect
:
BOOLEAN
True if the stream can be safely disconnected (without data loss, etc.)
recycle
Do whatever needs to be done to free resources or recycle other objects when recycling this one
is_connected
:
BOOLEAN
deferred function
top
True if the stream is connected.
Only in that case can data be transfered via this stream.
disconnect
deferred procedure
top
Try to disconnect the stream.
Note that it *does not* ensure that the stream will effectively be disconnected (some terminal streams, for instance, are always connected) but the feature can be used to
"shake off"
filters.
require
is_connected
can_disconnect
descriptor
:
INTEGER_32
effective function
top
Some OS-dependent descriptor.
Mainly used by the sequencer library (see READY_CONDITION).
require
is_connected
has_descriptor
has_descriptor
:
BOOLEAN
effective function
top
True if that stream can be associated to some OS-meaningful descriptor.
require
is_connected
can_disconnect
:
BOOLEAN
deferred function
top
True if the stream can be safely disconnected (without data loss, etc.)
require
is_connected
recycle
effective procedure
top
Do whatever needs to be done to free resources or recycle other objects when recycling this one
require
disconnect_file_after_use:
not
is_connected
ensure
not
is_connected