SYNOPSIS
#include <muroar.h>
ssize_t muroar_read (muroar_t 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.