xmmsv_c2c.c File Reference

#include <stddef.h>
#include "xmmsc/xmmsv.h"
#include "xmmsc/xmmsc_util.h"
#include "xmmscpriv/xmmsv_c2c.h"

Macros
#define	GEN_C2C_FIELD_GET_FUNC(field, getter, ctype, failval)

Functions
xmmsv_t *	xmmsv_c2c_message_format (int sender, int dest, int id, xmmsv_t *payload)
	Extract the id from a c2c message. More...

Macro Definition Documentation

#define GEN_C2C_FIELD_GET_FUNC	(		field,
			getter,
			ctype,
			failval
	)

Value:

ctype \
xmmsv_c2c_message_get_##field (xmmsv_t *msg) \
{ \
    ctype ret; \
    if (!getter (msg, #field, &ret)) \
        return failval; \
    return ret; \
}

Function Documentation

xmmsv_t* xmmsv_c2c_message_format	(	int	sender,
		int	dest,
		int	id,
		xmmsv_t *	payload
	)

Extract the id from a c2c message.

Parameters

msg	The client-to-client message.

Returns

The id upon success, -1 upon failure. Extract the sender id from a c2c message.

Parameters

msg	The client-to-client message.

Returns

The sender id upon success, -1 upon failure. Extract the destination id from a c2c message.

Parameters

msg	The client-to-client-message.

Returns

The destination id upon success, -1 upon failure. Extract the payload from a c2c message.

Parameters

msg	The client-to-client message.

Returns

The payload upon success, NULL upon failure. Format a client-to-client message.

Messages are dictionaries of the form:
"sender" : id of the sender client
"destination" : id of the destination client
"id" : 0 if the message doesn't expect reply, else a message id
"payload" : the contents of the message

Parameters

sender	the id of the sender client
dest	the id of the destination client
id	the id of the message
payload	the contents of the message

Returns

the formatted message

Note

Increases the refcount of payload.