NAME¶
roar_connectionref, roar_connectionunref - change reference counter for
RoarAudio connections
SYNOPSIS¶
#include <roaraudio.h>
int roar_connectionref(struct roar_connection * con);
int roar_connectionunref(struct roar_connection * con);
#define roar_disconnect(x) roar_connectionunref((x))
DESCRIPTION¶
Those functions change the reference counter for connection objects previously
opend via
roar_connect(3),
roar_connect_fh(3) or
roar_simple_connect(3). If the reference counter hints zero the
connection is closed and the object is destroyed.
The
roar_disconnect(3) macro is provided to be source compatible
(recompile needed) with RoarAudio 0.4 or older.
PARAMETERS¶
- con
- The connection to be altered.
RETURN VALUE¶
On success these calls return 0. On error, -1 is returned.
EXAMPLES¶
FIXME
SEE ALSO¶
roar_simple_connect(3),
libroar(7),
RoarAudio(7).