roar_connectionref3
Change reference counter for roaraudio connections
Usage
#include <roaraudio.h>
int roar_connectionref(struct roar_connection * con);
int roar_connectionunref(struct roar_connection * con);
#define roar_disconnect(x) roar_connectionunref((x))
Overview
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
Releases
Unchanged in 5 releases since Debian 7 (Wheezy).