xmmsv_service.c File Reference

#include <xmmsc/xmmsv.h>
#include <xmmsc/xmmsc_util.h>
#include <xmmsc/xmmsv_service.h>
#include <xmmsclientpriv/xmmsclient_util.h>

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

Functions
xmmsv_t *	xmmsv_sc_argument_new (const char *name, const char *docstring, xmmsv_type_t type, xmmsv_t *default_value)
	Create a new argument for a method. More...
const char *	xmmsv_sc_argument_get_name (xmmsv_t *arg)
	Extract the name of an argument. More...
const char *	xmmsv_sc_argument_get_docstring (xmmsv_t *arg)
	Extract the docstring of an argument. More...
int64_t	xmmsv_sc_argument_get_type (xmmsv_t *arg)
	Extract the type of an argument. More...
xmmsv_t *	xmmsv_sc_argument_get_default_value (xmmsv_t *arg)
	Extract the default value of an argument. More...

Macro Definition Documentation

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

Value:

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

Function Documentation

xmmsv_t* xmmsv_sc_argument_get_default_value

(

xmmsv_t *

arg

)

Extract the default value of an argument.

Parameters

arg	The argument.

Returns

The default value or NULL upon error.

const char* xmmsv_sc_argument_get_docstring

(

xmmsv_t *

arg

)

Extract the docstring of an argument.

Parameters

arg	The argument.

Returns

The docstring upon success, NULL upon failure.

const char* xmmsv_sc_argument_get_name

(

xmmsv_t *

arg

)

Extract the name of an argument.

Parameters

arg	The argument.

Returns

The name upon success, NULL upon failure.

int64_t xmmsv_sc_argument_get_type

(

xmmsv_t *

arg

)

Extract the type of an argument.

Parameters

arg	The argument.

Returns

The type, or XMMSV_TYPE_ERROR upon error.

xmmsv_t* xmmsv_sc_argument_new	(	const char *	name,
		const char *	docstring,
		xmmsv_type_t	type,
		xmmsv_t *	default_value
	)

Create a new argument for a method.

Parameters

name	The name of the argument. Must not be NULL.
docstring	The docstring of the argument.
type	The expected type of the argument. Use XMMSV_TYPE_NONE to accept any type. XMMSV_TYPE_ERROR is reserved and should not be used.
default_value	Value to set this argument to if it's missing in the method call. Implies that the argument is optional. If NULL, the argument is not optional.