Syntax

  flush stream-name

When working with buffered output streams, you may need to force OmniMark to send the output to its destination before you are ready to close the stream. To do this, use flush.

Any output stream can be flushed, including the built-in output streams #error, #process-output, or #main-output.

If you find that you are having to continually flush a stream, you can declare that stream to be unbuffered using unbuffered.

Note that flushing a stream that has referents-allowed does not immediately resolve the referents and output the stream contents. When a stream containing referents is flushed, the contents of that stream are sent immediately to the referent resolution area until the referents are resolved in the normal fashion. flush does not provide a method for forcing early referent resolution.

Flushing a stream is not an error if the stream is unbuffered or even closed; it just doesn't have any effect. It is an error, however, to flush a stream that is not attached.

Related Syntax    buffered, unbuffered

Related Concepts    Buffering I/O

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]