File: list.h

package info (click to toggle)
libmpdclient 2.22-1.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 896 kB
  • sloc: ansic: 9,923; makefile: 9
file content (55 lines) | stat: -rw-r--r-- 1,245 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
// SPDX-License-Identifier: BSD-3-Clause
// Copyright The Music Player Daemon Project

/*! \file
 * \brief MPD client library
 *
 * Functions for sending command lists.
 *
 * Do not include this header directly.  Use mpd/client.h instead.
 */

#ifndef MPD_LIST_H
#define MPD_LIST_H

#include <stdbool.h>

struct mpd_connection;

#ifdef __cplusplus
extern "C" {
#endif

/**
 * Starts a command list, i.e. a group of pipelined commands which are
 * transferred in one block.  If one command fails, the rest of the
 * command list is canceled.
 *
 * Note that there is no guarantee on atomicity.
 *
 * @param connection the connection to MPD
 * @param discrete_ok tells MPD whether to acknowledge every list
 * command with an "list_OK" response
 * @return true on success
 */
bool
mpd_command_list_begin(struct mpd_connection *connection, bool discrete_ok);

/**
 * Commits the command list, i.e. makes MPD execute all commands which
 * were queued.
 *
 * Note: there is no way to cancel a command list once it is started.
 * You may however close the socket connection.
 *
 * @param connection the connection to MPD
 * @return true on success
 */
bool
mpd_command_list_end(struct mpd_connection *connection);

#ifdef __cplusplus
}
#endif

#endif