libmpdclient 2.22
Functions
queue.h File Reference

MPD client library. More...

#include "compiler.h"
#include "position.h"
#include "tag.h"
#include <stdbool.h>
Include dependency graph for queue.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

bool mpd_send_list_queue_meta (struct mpd_connection *connection)
 
bool mpd_send_list_queue_range_meta (struct mpd_connection *connection, unsigned start, unsigned end)
 
bool mpd_send_get_queue_song_pos (struct mpd_connection *connection, unsigned pos)
 
struct mpd_songmpd_run_get_queue_song_pos (struct mpd_connection *connection, unsigned pos)
 
bool mpd_send_get_queue_song_id (struct mpd_connection *connection, unsigned id)
 
struct mpd_songmpd_run_get_queue_song_id (struct mpd_connection *connection, unsigned id)
 
bool mpd_send_queue_changes_meta (struct mpd_connection *connection, unsigned version)
 
bool mpd_send_queue_changes_meta_range (struct mpd_connection *connection, unsigned version, unsigned start, unsigned end)
 
bool mpd_send_queue_changes_brief (struct mpd_connection *connection, unsigned version)
 
bool mpd_send_queue_changes_brief_range (struct mpd_connection *connection, unsigned version, unsigned start, unsigned end)
 
bool mpd_recv_queue_change_brief (struct mpd_connection *connection, unsigned *position_r, unsigned *id_r)
 
bool mpd_send_add (struct mpd_connection *connection, const char *uri)
 
bool mpd_run_add (struct mpd_connection *connection, const char *uri)
 
bool mpd_send_add_whence (struct mpd_connection *connection, const char *uri, unsigned to, enum mpd_position_whence whence)
 
bool mpd_run_add_whence (struct mpd_connection *connection, const char *uri, unsigned to, enum mpd_position_whence whence)
 
bool mpd_send_add_id (struct mpd_connection *connection, const char *uri)
 
bool mpd_send_add_id_to (struct mpd_connection *connection, const char *uri, unsigned to)
 
bool mpd_send_add_id_whence (struct mpd_connection *connection, const char *uri, unsigned to, enum mpd_position_whence whence)
 
int mpd_recv_song_id (struct mpd_connection *connection)
 
int mpd_run_add_id (struct mpd_connection *connection, const char *uri)
 
int mpd_run_add_id_to (struct mpd_connection *connection, const char *uri, unsigned to)
 
int mpd_run_add_id_whence (struct mpd_connection *connection, const char *uri, unsigned to, enum mpd_position_whence whence)
 
bool mpd_send_delete (struct mpd_connection *connection, unsigned pos)
 
bool mpd_run_delete (struct mpd_connection *connection, unsigned pos)
 
bool mpd_send_delete_range (struct mpd_connection *connection, unsigned start, unsigned end)
 
bool mpd_run_delete_range (struct mpd_connection *connection, unsigned start, unsigned end)
 
bool mpd_send_delete_id (struct mpd_connection *connection, unsigned id)
 
bool mpd_run_delete_id (struct mpd_connection *connection, unsigned id)
 
bool mpd_send_shuffle (struct mpd_connection *connection)
 
bool mpd_run_shuffle (struct mpd_connection *connection)
 
bool mpd_send_shuffle_range (struct mpd_connection *connection, unsigned start, unsigned end)
 
bool mpd_run_shuffle_range (struct mpd_connection *connection, unsigned start, unsigned end)
 
bool mpd_send_clear (struct mpd_connection *connection)
 
bool mpd_run_clear (struct mpd_connection *connection)
 
bool mpd_send_move (struct mpd_connection *connection, unsigned from, unsigned to)
 
bool mpd_run_move (struct mpd_connection *connection, unsigned from, unsigned to)
 
bool mpd_send_move_whence (struct mpd_connection *connection, unsigned from, unsigned to, enum mpd_position_whence whence)
 
bool mpd_run_move_whence (struct mpd_connection *connection, unsigned from, unsigned to, enum mpd_position_whence whence)
 
bool mpd_send_move_id (struct mpd_connection *connection, unsigned from, unsigned to)
 
bool mpd_run_move_id (struct mpd_connection *connection, unsigned from, unsigned to)
 
bool mpd_send_move_id_whence (struct mpd_connection *connection, unsigned from, unsigned to, enum mpd_position_whence whence)
 
bool mpd_run_move_id_whence (struct mpd_connection *connection, unsigned from, unsigned to, enum mpd_position_whence whence)
 
bool mpd_send_move_range (struct mpd_connection *connection, unsigned start, unsigned end, unsigned to)
 
bool mpd_run_move_range (struct mpd_connection *connection, unsigned start, unsigned end, unsigned to)
 
bool mpd_send_move_range_whence (struct mpd_connection *connection, unsigned start, unsigned end, unsigned to, enum mpd_position_whence whence)
 
bool mpd_run_move_range_whence (struct mpd_connection *connection, unsigned start, unsigned end, unsigned to, enum mpd_position_whence whence)
 
bool mpd_send_swap (struct mpd_connection *connection, unsigned pos1, unsigned pos2)
 
bool mpd_run_swap (struct mpd_connection *connection, unsigned pos1, unsigned pos2)
 
bool mpd_send_swap_id (struct mpd_connection *connection, unsigned id1, unsigned id2)
 
bool mpd_run_swap_id (struct mpd_connection *connection, unsigned id1, unsigned id2)
 
bool mpd_send_add_tag_id (struct mpd_connection *connection, unsigned id, enum mpd_tag_type tag, const char *value)
 
bool mpd_run_add_tag_id (struct mpd_connection *connection, unsigned id, enum mpd_tag_type tag, const char *value)
 
bool mpd_send_clear_tag_id (struct mpd_connection *connection, unsigned id, enum mpd_tag_type tag)
 
bool mpd_run_clear_tag_id (struct mpd_connection *connection, unsigned id, enum mpd_tag_type tag)
 
bool mpd_send_clear_all_tags_id (struct mpd_connection *connection, unsigned id)
 
bool mpd_run_clear_all_tags_id (struct mpd_connection *connection, unsigned id)
 
bool mpd_send_prio (struct mpd_connection *connection, unsigned priority, unsigned position)
 
bool mpd_run_prio (struct mpd_connection *connection, unsigned priority, unsigned position)
 
bool mpd_send_prio_range (struct mpd_connection *connection, unsigned priority, unsigned start, unsigned end)
 
bool mpd_run_prio_range (struct mpd_connection *connection, unsigned priority, unsigned start, unsigned end)
 
bool mpd_send_prio_id (struct mpd_connection *connection, unsigned priority, unsigned id)
 
bool mpd_run_prio_id (struct mpd_connection *connection, unsigned priority, unsigned id)
 
bool mpd_send_range_id (struct mpd_connection *connection, unsigned id, float start, float end)
 
bool mpd_run_range_id (struct mpd_connection *connection, unsigned id, float start, float end)
 

Detailed Description

MPD client library.

Manipulate the queue (current playlist).

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

Definition in file queue.h.

Function Documentation

◆ mpd_send_list_queue_meta()

bool mpd_send_list_queue_meta ( struct mpd_connection connection)

Consult mpd/playlist.h for the rationale on the preference of manipulating song ids over positions in the queue. Sends the "playlistinfo" command: list all songs in the queue including meta information. Use mpd_recv_entity() to receive the songs (MPD_ENTITY_TYPE_SONG).

Parameters
connectionthe connection to MPD
Returns
true on success, false on error

◆ mpd_send_list_queue_range_meta()

bool mpd_send_list_queue_range_meta ( struct mpd_connection connection,
unsigned  start,
unsigned  end 
)

Like mpd_send_list_queue_meta(), but specifies a (position) range. Use mpd_recv_entity() to receive the songs (MPD_ENTITY_TYPE_SONG).

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_send_get_queue_song_pos()

bool mpd_send_get_queue_song_pos ( struct mpd_connection connection,
unsigned  pos 
)

Requests information (including tags) about one song in the playlist (command "playlistid"). Use mpd_recv_song() to obtain the song information.

Parameters
connectionthe connection to MPD
posthe position of the requested song

◆ mpd_run_get_queue_song_pos()

struct mpd_song * mpd_run_get_queue_song_pos ( struct mpd_connection connection,
unsigned  pos 
)

Shortcut for mpd_send_get_queue_song_pos() and mpd_recv_song().

Parameters
connectionthe connection to MPD
posthe position of the requested song
Returns
the song at the specified position, or NULL on error

◆ mpd_send_get_queue_song_id()

bool mpd_send_get_queue_song_id ( struct mpd_connection connection,
unsigned  id 
)

Requests information (including tags) about one song in the playlist (command "playlistid"). Use mpd_recv_song() to obtain the song information.

Parameters
connectionthe connection to MPD
idthe id of the requested song

◆ mpd_run_get_queue_song_id()

struct mpd_song * mpd_run_get_queue_song_id ( struct mpd_connection connection,
unsigned  id 
)

Shortcut for mpd_send_get_queue_song_id() and mpd_recv_song().

Parameters
connectionthe connection to MPD
idthe id of the requested song
Returns
the song at the specified id, or NULL on error

◆ mpd_send_queue_changes_meta()

bool mpd_send_queue_changes_meta ( struct mpd_connection connection,
unsigned  version 
)

Request the queue changes from MPD since the specified version, including tags. The MPD command is called "plchanges".

The current version can be fetched with mpd_status_get_queue_version(). Use mpd_recv_song() to receive the songs of the new version.

Parameters
connectionthe connection to MPD
versionThe playlist version you want the diff with.
Returns
true on success, false on error

◆ mpd_send_queue_changes_meta_range()

bool mpd_send_queue_changes_meta_range ( struct mpd_connection connection,
unsigned  version,
unsigned  start,
unsigned  end 
)

Same as mpd_send_queue_changes_meta(), but limit the result to a range.

The current version can be fetched with mpd_status_get_queue_version(). Use mpd_recv_song() to receive the songs of the new queue.

Parameters
connectionthe connection to MPD
versionThe playlist version you want the diff with.
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.12

◆ mpd_send_queue_changes_brief()

bool mpd_send_queue_changes_brief ( struct mpd_connection connection,
unsigned  version 
)

A more bandwidth efficient version of the mpd_send_queue_changes_meta(). It only returns the position and id of changed songs. The MPD command is called "plchangesposid".

Use mpd_recv_queue_change_brief() for the response.

Parameters
connectionA valid and connected mpd_connection.
versionThe playlist version you want the diff with.
Returns
true on success, false on error

◆ mpd_send_queue_changes_brief_range()

bool mpd_send_queue_changes_brief_range ( struct mpd_connection connection,
unsigned  version,
unsigned  start,
unsigned  end 
)

Same as mpd_send_queue_changes_brief(), but limit the result to a range.

Use mpd_recv_queue_change_brief() for the response.

Parameters
connectionthe connection to MPD
versionThe playlist version you want the diff with.
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.12

◆ mpd_recv_queue_change_brief()

bool mpd_recv_queue_change_brief ( struct mpd_connection connection,
unsigned *  position_r,
unsigned *  id_r 
)

Receives a response element of mpd_send_queue_changes_brief() or mpd_send_queue_changes_brief_range().

Parameters
connectionA valid and connected mpd_connection.
position_rreference to the position of the changed song
id_rreference to the id of the changed song
Returns
true on success, false on error or if there are no more changes in this response

◆ mpd_send_add()

bool mpd_send_add ( struct mpd_connection connection,
const char *  uri 
)

Appends a song to the playlist: either a single file or a directory.

Parameters
connectionA valid and connected mpd_connection.
uriURI of a song or directory (added recursively)
Returns
true on success, false on error

◆ mpd_run_add()

bool mpd_run_add ( struct mpd_connection connection,
const char *  uri 
)

Shortcut for mpd_send_add() and mpd_response_finish().

Parameters
connectionthe connection to MPD
uriURI of a song or directory (added recursively)
Returns
true on success, false on error

◆ mpd_send_add_whence()

bool mpd_send_add_whence ( struct mpd_connection connection,
const char *  uri,
unsigned  to,
enum mpd_position_whence  whence 
)

Inserts a song into the playlist for a given position: either a single file or a directory.

Parameters
connectionA valid and connected mpd_connection.
uriURI of a song or directory (added recursively)
tothe desired position of the song
whencehow to interpret the position parameter
Returns
true on success, false on error
Since
libmpdclient 2.20

◆ mpd_run_add_whence()

bool mpd_run_add_whence ( struct mpd_connection connection,
const char *  uri,
unsigned  to,
enum mpd_position_whence  whence 
)

Shortcut for mpd_send_add_whence() and mpd_response_finish().

Parameters
connectionthe connection to MPD
uriURI of a song or directory (added recursively)
tothe desired position of the song
whencehow to interpret the position parameter
Returns
true on success, false on error
Since
libmpdclient 2.20

◆ mpd_send_add_id()

bool mpd_send_add_id ( struct mpd_connection connection,
const char *  uri 
)

Appends a song to the playlist. Call mpd_recv_song_id() for its id. file is always a single file or URL.

Parameters
connectionthe connection to MPD
uriURI of the song to be added
Returns
true on success, false on error

◆ mpd_send_add_id_to()

bool mpd_send_add_id_to ( struct mpd_connection connection,
const char *  uri,
unsigned  to 
)

Inserts a song into the playlist for a given position, and returns its id. file is always a single file or URL.

Parameters
connectionthe connection to MPD
urithe URI of the song to be added
tothe desired position of the song
Returns
true on success, false on error

◆ mpd_send_add_id_whence()

bool mpd_send_add_id_whence ( struct mpd_connection connection,
const char *  uri,
unsigned  to,
enum mpd_position_whence  whence 
)

Inserts a song into the playlist for a given position, and returns its id. file is always a single file or URL.

Parameters
connectionthe connection to MPD
urithe URI of the song to be added
tothe desired position of the song
whencehow to interpret the position parameter
Returns
true on success, false on error
Since
libmpdclient 2.20

◆ mpd_recv_song_id()

int mpd_recv_song_id ( struct mpd_connection connection)

Returns the id of the new song in the playlist. To be called after mpd_send_add_id() or mpd_send_add_id_to().

Parameters
connectionthe connection to MPD
Returns
the new song id, -1 on error or if MPD did not send an id

◆ mpd_run_add_id()

int mpd_run_add_id ( struct mpd_connection connection,
const char *  uri 
)

Executes the "addid" command and reads the response. file is always a single file or URL.

Parameters
connectionthe connection to MPD
uriURI of a song to be added
Returns
the new song id, -1 on error or if MPD did not send an id

◆ mpd_run_add_id_to()

int mpd_run_add_id_to ( struct mpd_connection connection,
const char *  uri,
unsigned  to 
)

Executes the "addid" command and reads the response. file is always a single file or URL.

Parameters
connectionthe connection to MPD
urithe URI of the song to be added
tothe desired position of the song
Returns
the new song id, -1 on error or if MPD did not send an id

◆ mpd_run_add_id_whence()

int mpd_run_add_id_whence ( struct mpd_connection connection,
const char *  uri,
unsigned  to,
enum mpd_position_whence  whence 
)

Executes the "addid" command and reads the response. file is always a single file or URL.

Parameters
connectionthe connection to MPD
urithe URI of the song to be added
tothe desired position of the song
whencehow to interpret the position parameter
Returns
the new song id, -1 on error or if MPD did not send an id
Since
libmpdclient 2.20

◆ mpd_send_delete()

bool mpd_send_delete ( struct mpd_connection connection,
unsigned  pos 
)

Deletes a song from the queue.

Parameters
connectionthe connection to MPD
posthe position of the song to be deleted
Returns
true on success, false on error

◆ mpd_run_delete()

bool mpd_run_delete ( struct mpd_connection connection,
unsigned  pos 
)

Shortcut for mpd_send_delete() and mpd_response_finish().

Parameters
connectionthe connection to MPD
posthe position of the song to be deleted
Returns
true on success, false on error

◆ mpd_send_delete_range()

bool mpd_send_delete_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end 
)

Deletes songs from the queue.

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_run_delete_range()

bool mpd_run_delete_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end 
)

Shortcut for mpd_send_delete_range() and mpd_response_finish().

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_send_delete_id()

bool mpd_send_delete_id ( struct mpd_connection connection,
unsigned  id 
)

Deletes a song from the queue.

Parameters
connectionthe connection to MPD
idthe id of the song to be deleted
Returns
true on success, false on error

◆ mpd_run_delete_id()

bool mpd_run_delete_id ( struct mpd_connection connection,
unsigned  id 
)

Shortcut for mpd_send_delete_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
idthe id of the song to be deleted
Returns
true on success, false on error

◆ mpd_send_shuffle()

bool mpd_send_shuffle ( struct mpd_connection connection)

Shuffles the queue.

Parameters
connectionthe connection to MPD
Returns
true on success, false on error

◆ mpd_run_shuffle()

bool mpd_run_shuffle ( struct mpd_connection connection)

Shortcut for mpd_send_shuffle() and mpd_response_finish().

Parameters
connectionthe connection to MPD
Returns
true on success, false on error

◆ mpd_send_shuffle_range()

bool mpd_send_shuffle_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end 
)

Shuffles a range within the queue.

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_run_shuffle_range()

bool mpd_run_shuffle_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end 
)

Shortcut for mpd_send_shuffle_range() and mpd_response_finish().

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_send_clear()

bool mpd_send_clear ( struct mpd_connection connection)

Clear the queue.

Parameters
connectionthe connection to MPD
Returns
true on success, false on error

◆ mpd_run_clear()

bool mpd_run_clear ( struct mpd_connection connection)

Shortcut for mpd_send_clear() and mpd_response_finish().

Parameters
connectionthe connection to MPD
Returns
true on success, false on error

◆ mpd_send_move()

bool mpd_send_move ( struct mpd_connection connection,
unsigned  from,
unsigned  to 
)

Moves a song within the queue.

Parameters
connectionthe connection to MPD
fromthe source song position
tothe new position of the song
Returns
true on success, false on error

◆ mpd_run_move()

bool mpd_run_move ( struct mpd_connection connection,
unsigned  from,
unsigned  to 
)

Shortcut for mpd_send_move() and mpd_response_finish().

Parameters
connectionthe connection to MPD
fromthe source song position
tothe new position of the song
Returns
true on success, false on error

◆ mpd_send_move_whence()

bool mpd_send_move_whence ( struct mpd_connection connection,
unsigned  from,
unsigned  to,
enum mpd_position_whence  whence 
)

Moves a song within the queue.

Parameters
connectionthe connection to MPD
fromthe source song position
tothe new position of the song
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_run_move_whence()

bool mpd_run_move_whence ( struct mpd_connection connection,
unsigned  from,
unsigned  to,
enum mpd_position_whence  whence 
)

Shortcut for mpd_send_move_whence() and mpd_response_finish().

Parameters
connectionthe connection to MPD
fromthe source song position
tothe new position of the song
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_send_move_id()

bool mpd_send_move_id ( struct mpd_connection connection,
unsigned  from,
unsigned  to 
)

Moves a song within the queue.

Parameters
connectionthe connection to MPD
fromthe source song id
tothe new position of the song (not an id!)
Returns
true on success, false on error

◆ mpd_run_move_id()

bool mpd_run_move_id ( struct mpd_connection connection,
unsigned  from,
unsigned  to 
)

Shortcut for mpd_send_move_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
fromthe source song id
tothe new position of the song (not an id!)
Returns
true on success, false on error

◆ mpd_send_move_id_whence()

bool mpd_send_move_id_whence ( struct mpd_connection connection,
unsigned  from,
unsigned  to,
enum mpd_position_whence  whence 
)

Moves a song within the queue.

Parameters
connectionthe connection to MPD
fromthe source song id
tothe new position of the song (not an id!)
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_run_move_id_whence()

bool mpd_run_move_id_whence ( struct mpd_connection connection,
unsigned  from,
unsigned  to,
enum mpd_position_whence  whence 
)

Shortcut for mpd_send_move_id_whence() and mpd_response_finish().

Parameters
connectionthe connection to MPD
fromthe source song id
tothe new position of the song (not an id!)
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_send_move_range()

bool mpd_send_move_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end,
unsigned  to 
)

Moves a range of songs within the queue.

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
tothe new position of the song range
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_run_move_range()

bool mpd_run_move_range ( struct mpd_connection connection,
unsigned  start,
unsigned  end,
unsigned  to 
)

Shortcut for mpd_send_move_range() and mpd_response_finish().

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
tothe new position of the song range
Returns
true on success, false on error
Since
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_send_move_range_whence()

bool mpd_send_move_range_whence ( struct mpd_connection connection,
unsigned  start,
unsigned  end,
unsigned  to,
enum mpd_position_whence  whence 
)

Moves a range of songs within the queue.

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
tothe new position of the song range
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_run_move_range_whence()

bool mpd_run_move_range_whence ( struct mpd_connection connection,
unsigned  start,
unsigned  end,
unsigned  to,
enum mpd_position_whence  whence 
)

Shortcut for mpd_send_move_range_whence() and mpd_response_finish().

Parameters
connectionthe connection to MPD
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
tothe new position of the song range
whencehow to interpret the to parameter
Returns
true on success, false on error
Since
libmpdclient 2.21, MPD 0.23

◆ mpd_send_swap()

bool mpd_send_swap ( struct mpd_connection connection,
unsigned  pos1,
unsigned  pos2 
)

Swap the position of two songs in the queue.

Parameters
connectionthe connection to MPD
pos1the position of one song
pos2the position of the other song
Returns
true on success, false on error

◆ mpd_run_swap()

bool mpd_run_swap ( struct mpd_connection connection,
unsigned  pos1,
unsigned  pos2 
)

Shortcut for mpd_send_swap() and mpd_response_finish().

Parameters
connectionthe connection to MPD
pos1the position of one song
pos2the position of the other song
Returns
true on success, false on error

◆ mpd_send_swap_id()

bool mpd_send_swap_id ( struct mpd_connection connection,
unsigned  id1,
unsigned  id2 
)

Swap the position of two songs in the queue.

Parameters
connectionthe connection to MPD
id1the id of one song
id2the id of the other song
Returns
true on success, false on error

◆ mpd_run_swap_id()

bool mpd_run_swap_id ( struct mpd_connection connection,
unsigned  id1,
unsigned  id2 
)

Shortcut for mpd_send_swap_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
id1the id of one song
id2the id of the other song
Returns
true on success, false on error

◆ mpd_send_add_tag_id()

bool mpd_send_add_tag_id ( struct mpd_connection connection,
unsigned  id,
enum mpd_tag_type  tag,
const char *  value 
)

Adds a tag to the specified song (command "addtagid").

Parameters
connectionthe connection to MPD
idthe id of the song
tagthe tag to be added
valuethe tag value
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_run_add_tag_id()

bool mpd_run_add_tag_id ( struct mpd_connection connection,
unsigned  id,
enum mpd_tag_type  tag,
const char *  value 
)

Shortcut for mpd_send_add_tag_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
idthe id of the song
tagthe tag to be added
valuethe tag value
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_send_clear_tag_id()

bool mpd_send_clear_tag_id ( struct mpd_connection connection,
unsigned  id,
enum mpd_tag_type  tag 
)

Remove a tag from the specified song (command "cleartagid").

Parameters
connectionthe connection to MPD
idthe id of the song
tagthe tag to be cleared
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_run_clear_tag_id()

bool mpd_run_clear_tag_id ( struct mpd_connection connection,
unsigned  id,
enum mpd_tag_type  tag 
)

Shortcut for mpd_send_clear_tag_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
idthe id of the song
tagthe tag to be cleared
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_send_clear_all_tags_id()

bool mpd_send_clear_all_tags_id ( struct mpd_connection connection,
unsigned  id 
)

Remove all tags from the specified song (command "cleartagid").

Parameters
connectionthe connection to MPD
idthe id of the song
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_run_clear_all_tags_id()

bool mpd_run_clear_all_tags_id ( struct mpd_connection connection,
unsigned  id 
)

Shortcut for mpd_send_clear_all_tags_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
idthe id of the song
Returns
true on success, false on error
Since
libmpdclient 2.12, MPD 0.19

◆ mpd_send_prio()

bool mpd_send_prio ( struct mpd_connection connection,
unsigned  priority,
unsigned  position 
)

Change the priority of the specified song.

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
positionthe position of the song
Returns
true on success, false on error
Since
libmpdclient 2.6

◆ mpd_run_prio()

bool mpd_run_prio ( struct mpd_connection connection,
unsigned  priority,
unsigned  position 
)

Shortcut for mpd_send_prio() and mpd_response_finish().

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
positionthe position of the song
Returns
true on success, false on error
Since
libmpdclient 2.6

◆ mpd_send_prio_range()

bool mpd_send_prio_range ( struct mpd_connection connection,
unsigned  priority,
unsigned  start,
unsigned  end 
)

Change the priority of a song range.

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.6
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_run_prio_range()

bool mpd_run_prio_range ( struct mpd_connection connection,
unsigned  priority,
unsigned  start,
unsigned  end 
)

Shortcut for mpd_send_prio_range() and mpd_response_finish().

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
startthe start position of the range (including)
endthe end position of the range (excluding); the special value "UINT_MAX" makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.6
libmpdclient 2.8 added support for "UINT_MAX"

◆ mpd_send_prio_id()

bool mpd_send_prio_id ( struct mpd_connection connection,
unsigned  priority,
unsigned  id 
)

Change the priority of the specified song.

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
idthe id of the song
Returns
true on success, false on error
Since
libmpdclient 2.6

◆ mpd_run_prio_id()

bool mpd_run_prio_id ( struct mpd_connection connection,
unsigned  priority,
unsigned  id 
)

Shortcut for mpd_send_prio_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
prioritya number between 0 and 255
idthe id of the song
Returns
true on success, false on error
Since
libmpdclient 2.6

◆ mpd_send_range_id()

bool mpd_send_range_id ( struct mpd_connection connection,
unsigned  id,
float  start,
float  end 
)

Specify the portion of a song that shall be played. The song is identified by its id and cannot be the currently playing song.

The start/end values are offsets in seconds (fractional seconds allowed); both are optional.

Parameters
connectionthe connection to MPD
idthe id of the song (cannot be the currently playing song)
startthe offset in seconds for starting the song
endthe offset in seconds for ending the song; a negative value makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.19, MPD 0.20

◆ mpd_run_range_id()

bool mpd_run_range_id ( struct mpd_connection connection,
unsigned  id,
float  start,
float  end 
)

Shortcut for mpd_send_range_id() and mpd_response_finish().

Parameters
connectionthe connection to MPD
idthe id of the song (cannot be the currently playing song)
startthe offset in seconds for starting the song
endthe offset in seconds for ending the song; a negative value makes the end of the range open
Returns
true on success, false on error
Since
libmpdclient 2.19, MPD 0.20