debian man page for muroar_write

muroar_write(3) 				     muRoar Programmer's Manual: IO Extension					   muroar_write(3)

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

muRoar								    April 2012							   muroar_write(3)