muroar_read(3)
NAME
muroar_read - Read data from a stream in a portable way
SYNOPSIS
#include <muroar.h> ssize_t muroar_read (int fh, void * buf, size_t len);
DESCRIPTION
This function reads data from a stream connected to a sound server. It
exists to have a portable way to read data from 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 read.
- len The total length in byte of the data that should be read.
RETURN VALUE
On success this call return the number of bytes successful read. On
error, -1 is returned.
NOTES
This function calls the underlying read 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.