swirl Guide to OmniMark 5   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
  Related Syntax   Related Concepts  
action   flush    

Syntax

  flush stream-name


Purpose

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
 
----

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ OMX ] [ ERRORS ]

Generated: August 11, 2000 at 3:07:15 pm
If you have any comments about this section of the documentation, send email to docerrors@omnimark.com

Copyright © OmniMark Technologies Corporation, 1988-2000.