12.3.19 SP_flush_output()

Synopsis

     #include <sicstus/sicstus.h>
     
     spio_t_error_code
     SP_flush_output(
       SP_stream *stream,
       spio_t_bits flush_options);

Ensure that all buffered data reaches its destination.

Arguments

stream
The stream to flush. This stream should be open for writing.
flush_options
The following bits can be set:
SP_FLUSH_OUTPUT_OPTION_NONBLOCKING
If this is set, the function should return quickly or with a SPIO_E_WOULD_BLOCK code.

Can return SPIO_E_NOT_SUPPORTED if the stream cannot support non-blocking flush.

SP_FLUSH_OUTPUT_OPTION_AUTOFLUSH
Only flush stream if it has AUTOFLUSH enabled.

Return Value

On success, all buffered data should have been written and SPIO_S_NOERR or some other success code returned.

On failure, returns a SPIO error code. Error codes with special meaning for SP_flush_output():

SPIO_E_END_OF_FILE
Returned if it is not possible to write more data onto the stream, e.g. some underlying device has been closed.
SPIO_E_WOULD_BLOCK
SP_FLUSH_OUTPUT_OPTION_NONBLOCKING was set but the operation would block.
SPIO_E_NOT_SUPPORTED
Some unsupported option, e.g. SP_FLUSH_OUTPUT_OPTION_NONBLOCKING, was passed.

Other error codes may also be returned.

See Also

Prolog Streams.


Send feedback on this subject.