12.3.67 SP_put_bytes()

Synopsis

     #include <sicstus/sicstus.h>
     
     spio_t_error_code
     SP_put_bytes(
       SP_stream *stream,
       spio_t_uint8 const *bytes,
       size_t byte_count,
       spio_t_bits options);

Write several bytes to a binary stream.

Arguments

stream

The stream. Must be a binary stream open for output.

bytes

A pointer to the data to write.

byte_count

The number of bytes to write.

options

The following bits can be set:

SP_PUT_BYTES_OPTION_NONBLOCKING

Write the bytes without blocking.

Return Value

On success, all data has been written and SPIO_S_NOERR or some other success code returned.

On failure, returns an error code without transferring any data. Error codes with special meaning for SP_put_bytes():

SPIO_E_WOULD_BLOCK

SP_PUT_BYTES_OPTION_NONBLOCKING was set but the operation would block.

Other error codes may also be returned.

See Also

cpg-ref-SP_put_byte. Prolog Streams.