exception.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/engine/io/exception.hpp
/// @brief I/O exceptions
 
#include <stdexcept>
#include <string_view>
#include <system_error>
 
#include <userver/utils/traceful_exception.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace engine::io {
 
/// Generic I/O error.
class IoException : public utils::TracefulException {
public:
    IoException();
 
    explicit IoException(std::string_view message);
};
 
/// I/O interruption.
class IoInterrupted : public IoException {
public:
    explicit IoInterrupted(std::string_view reason, size_t bytes_transferred);
 
    /// Number of bytes transferred before interruption.
    size_t BytesTransferred() const { return bytes_transferred_; }
 
private:
    size_t bytes_transferred_;
};
 
/// I/O timeout.
class IoTimeout : public IoInterrupted {
public:
    IoTimeout();
    explicit IoTimeout(size_t bytes_transferred);
};
 
/// Task cancellation during I/O.
/// Context description is expected to be provided by user.
class IoCancelled : public IoInterrupted {
public:
    IoCancelled();
    explicit IoCancelled(size_t bytes_transferred);
};
 
/// Operating system I/O error.
class IoSystemError : public IoException {
public:
    IoSystemError(int err_value, std::string_view reason);
    IoSystemError(std::error_code code, std::string_view reason);
 
    /// Operating system error code.
    const std::error_code& Code() const { return code_; }
 
private:
    std::error_code code_;
};
 
/// TLS I/O error.
class TlsException : public IoException {
public:
    using IoException::IoException;
    ~TlsException() override;
};
 
}  // namespace engine::io
 
USERVER_NAMESPACE_END