MPD client library. More...
#include "compiler.h"#include <stdbool.h>#include <stddef.h>
Go to the source code of 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
