MPD client library. More...

#include "compiler.h"
#include <stdbool.h>
#include <stddef.h>

Include dependency graph for sticker.h:

This graph shows which files directly or indirectly include this file:

Functions
bool	mpd_send_sticker_set (struct mpd_connection connection, const char type, const char uri, const char name, const char *value)

bool	mpd_run_sticker_set (struct mpd_connection connection, const char type, const char uri, const char name, const char *value)

bool	mpd_send_sticker_delete (struct mpd_connection connection, const char type, const char uri, const char name)

bool	mpd_run_sticker_delete (struct mpd_connection connection, const char type, const char uri, const char name)

bool	mpd_send_sticker_get (struct mpd_connection connection, const char type, const char uri, const char name)

bool	mpd_send_sticker_list (struct mpd_connection connection, const char type, const char *uri)

bool	mpd_send_sticker_find (struct mpd_connection connection, const char type, const char base_uri, const char name)

const char *	mpd_parse_sticker (const char input, size_t name_length_r)

struct mpd_pair *	mpd_recv_sticker (struct mpd_connection *connection)

void	mpd_return_sticker (struct mpd_connection connection, struct mpd_pair pair)

bool	mpd_send_stickernames (struct mpd_connection *connection)

Detailed Description

MPD client library.

Manipulate stickers.

Do not include this header directly. Use mpd/client.h instead.

Definition in file sticker.h.

Function Documentation

◆ mpd_send_sticker_set()

bool mpd_send_sticker_set	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri,
		const char *	name,
		const char *	value
	)

Stickers are pieces of information attached to existing MPD objects (e.g. song files, directories, albums; but currently, they are only implemented for song). Clients can create arbitrary name/value pairs. MPD itself does not assume any special meaning in them.

The goal is to allow clients to share additional (possibly dynamic) information about songs, which is neither stored on the client (not available to other clients), nor stored in the song files (MPD has no write access).

Client developers should create a standard for common sticker names, to ensure interoperability.

Objects which may have stickers are addressed by their object type ("song" for song objects) and their URI (the path within the database for songs). Adds or replaces a sticker value.

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object
name	the name of the sticker
value	the value of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_run_sticker_set()

bool mpd_run_sticker_set	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri,
		const char *	name,
		const char *	value
	)

Shortcut for mpd_send_sticker_set() and mpd_response_finish().

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object
name	the name of the sticker
value	the value of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_send_sticker_delete()

bool mpd_send_sticker_delete	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri,
		const char *	name
	)

Deletes a sticker value.

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object
name	the name of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_run_sticker_delete()

bool mpd_run_sticker_delete	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri,
		const char *	name
	)

Shortcut for mpd_send_sticker_delete() and mpd_response_finish().

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object
name	the name of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_send_sticker_get()

bool mpd_send_sticker_get	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri,
		const char *	name
	)

Queries a sticker value. Call mpd_recv_sticker() to receive the response.

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object
name	the name of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_send_sticker_list()

bool mpd_send_sticker_list	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	uri
	)

Obtains a list of all stickers of the specified object. Call mpd_recv_sticker() to receive each response item.

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
uri	the URI of the object

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_send_sticker_find()

bool mpd_send_sticker_find	(	struct mpd_connection *	connection,
		const char *	type,
		const char *	base_uri,
		const char *	name
	)

Searches for stickers with the specified name. Call mpd_recv_sticker() to receive each response item.

Parameters

connection	the connection to MPD
type	the object type, e.g. "song"
base_uri	the base URI to start the search, e.g. a directory; NULL to search for all objects of the specified type
name	the name of the sticker

Returns: true on success, false on error

Since: libmpdclient 2.1

◆ mpd_parse_sticker()

const char * mpd_parse_sticker	(	const char *	input,
		size_t *	name_length_r
	)

Parse a sticker input line in the form "name=value".

Parameters

input	the input value, the value from a received pair named "sticker"
name_length_r	the length of the name (starting at the beginning of the input string) is returned here

Returns: a pointer to the sticker value, or NULL on error

Since: libmpdclient 2.1

◆ mpd_recv_sticker()

struct mpd_pair * mpd_recv_sticker ( struct mpd_connection * connection )

Receives the next sticker. You have to free the return value with mpd_return_sticker().

Parameters

connection the connection to MPD

Returns: a mpd_pair object on success, NULL on end of response or error

Since: libmpdclient 2.1

◆ mpd_return_sticker()

void mpd_return_sticker	(	struct mpd_connection *	connection,
		struct mpd_pair *	pair
	)

Free the pair returned by mpd_recv_sticker().

Since: libmpdclient 2.1

◆ mpd_send_stickernames()

bool mpd_send_stickernames ( struct mpd_connection * connection )

Obtains an uniq and sortes list of all sticker names. Call mpd_recv_pair() to receive each response item.

Parameters

connection the connection to MPD

Returns: true on success, false on error

Since: libmpdclient 2.21, MPD 0.24

Functions

Detailed Description

Function Documentation

◆ mpd_send_sticker_set()

◆ mpd_run_sticker_set()

◆ mpd_send_sticker_delete()

◆ mpd_run_sticker_delete()

◆ mpd_send_sticker_get()

◆ mpd_send_sticker_list()

◆ mpd_send_sticker_find()

◆ mpd_parse_sticker()

◆ mpd_recv_sticker()

◆ mpd_return_sticker()

◆ mpd_send_stickernames()