NAME

       muroar_write - Write data to a stream in a portable way

SYNOPSIS

       #include <muroar.h>

       ssize_t muroar_write  (muroar_t fh, const void * buf, size_t len);

DESCRIPTION

       This  function writes a block of data to a connected stream.  It exists to have a portable
       way to send the data to the sound server that does not depend on the underlying  operating
       system.

PARAMETERS

       fh     The  stream  file  handle  connected  to  the  server.   This  must  be opend using
              muroar_stream(3).

       buf    A pointer to the block of data that should be written.

       len    The total length in byte of the data that should be written.

RETURN VALUE

       On success this call return the number of successful  written  bytes.   On  error,  -1  is
       returned.

NOTES

       This  function  calls  the underlying write function in a loop.  If this returns less than
       the given length you should not re-try directly but wait at least some milisecunds.

HISTORY

       This function first appeared in muRoar version 0.1beta0.

SEE ALSO

       write(2), muroar_read(3), muroar_stream(3), muroar_close(3), RoarAudio(7).