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.