You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
89 lines
2.1 KiB
C++
89 lines
2.1 KiB
C++
// SPDX-License-Identifier: GPL-2.0-or-later
|
|
// Copyright The Music Player Daemon Project
|
|
|
|
#pragma once
|
|
|
|
#include "protocol/Ack.hxx"
|
|
|
|
#include <fmt/core.h>
|
|
|
|
#include <cstddef>
|
|
#include <span>
|
|
|
|
class Client;
|
|
class TagMask;
|
|
|
|
class Response {
|
|
Client &client;
|
|
|
|
/**
|
|
* This command's index in the command list. Used to generate
|
|
* error messages.
|
|
*/
|
|
const unsigned list_index;
|
|
|
|
/**
|
|
* This command's name. Used to generate error messages.
|
|
*/
|
|
const char *command = "";
|
|
|
|
public:
|
|
Response(Client &_client, unsigned _list_index) noexcept
|
|
:client(_client), list_index(_list_index) {}
|
|
|
|
Response(const Response &) = delete;
|
|
Response &operator=(const Response &) = delete;
|
|
|
|
/**
|
|
* Returns a const reference to the associated #Client object.
|
|
* This should only be used to access a client's settings, to
|
|
* determine how to format the response. For this reason, the
|
|
* returned reference is "const".
|
|
*/
|
|
const Client &GetClient() const noexcept {
|
|
return client;
|
|
}
|
|
|
|
/**
|
|
* Accessor for Client::tag_mask. Can be used if caller wants
|
|
* to avoid including Client.hxx.
|
|
*/
|
|
[[gnu::pure]]
|
|
TagMask GetTagMask() const noexcept;
|
|
|
|
void SetCommand(const char *_command) noexcept {
|
|
command = _command;
|
|
}
|
|
|
|
bool Write(const void *data, size_t length) noexcept;
|
|
bool Write(const char *data) noexcept;
|
|
|
|
bool VFmt(fmt::string_view format_str, fmt::format_args args) noexcept;
|
|
|
|
template<typename S, typename... Args>
|
|
bool Fmt(const S &format_str, Args&&... args) noexcept {
|
|
return VFmt(format_str,
|
|
fmt::make_format_args(args...));
|
|
}
|
|
|
|
/**
|
|
* Write a binary chunk; this writes the "binary" line, the
|
|
* given chunk and the trailing newline.
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool WriteBinary(std::span<const std::byte> payload) noexcept;
|
|
|
|
void Error(enum ack code, const char *msg) noexcept;
|
|
|
|
void VFmtError(enum ack code,
|
|
fmt::string_view format_str, fmt::format_args args) noexcept;
|
|
|
|
template<typename S, typename... Args>
|
|
void FmtError(enum ack code,
|
|
const S &format_str, Args&&... args) noexcept {
|
|
return VFmtError(code, format_str,
|
|
fmt::make_format_args(args...));
|
|
}
|
|
};
|