/***
This file is part of snapcast
Copyright (C) 2014-2024 Johannes Pohl
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .
***/
#pragma once
// standard headers
#include
#include
#include
#include
namespace snapcast
{
/// Error codes with detail information
struct ErrorCode : public std::error_code
{
/// c'tor
ErrorCode() : std::error_code(), detail_(std::nullopt)
{
}
/// c'tor
/// @param code the std error code
ErrorCode(const std::error_code& code) : std::error_code(code), detail_(std::nullopt)
{
}
/// c'tor
/// @param code the std error code
/// @param detail additional details
ErrorCode(const std::error_code& code, std::string detail) : std::error_code(code), detail_(std::move(detail))
{
}
/// Move c'tor
ErrorCode(ErrorCode&& other) = default;
/// Move assignment
ErrorCode& operator=(ErrorCode&& rhs) = default;
/// @return detaiƶed error message
std::string detailed_message() const
{
if (detail_.has_value())
return message() + ": " + *detail_;
return message();
}
private:
/// Optional error detais
std::optional detail_;
};
/// Storage for an ErrorCode or a type T
/// Mostly used as return type
template
struct ErrorOr
{
/// Move construct with @p t
ErrorOr(T&& t) : var(std::move(t))
{
}
/// Construct with @p t
ErrorOr(const T& t) : var(t)
{
}
/// Move construct with an error
ErrorOr(ErrorCode&& error) : var(std::move(error))
{
}
/// Construct with an error
ErrorOr(const ErrorCode& error) : var(error)
{
}
/// @return true if contains a value (i.e. no error)
bool hasValue()
{
return std::holds_alternative(var);
}
/// @return true if contains an error (i.e. no value)
bool hasError()
{
return std::holds_alternative(var);
}
/// @return the value
const T& getValue()
{
return std::get(var);
}
/// @return the moved value
T takeValue()
{
return std::move(std::get(var));
}
/// @return the error
const ErrorCode& getError()
{
return std::get(var);
}
/// @return the moved error
ErrorCode takeError()
{
return std::move(std::get(var));
}
private:
/// The stored ErrorCode or value
std::variant var;
};
} // namespace snapcast