2007-07-04 08:24:30 +00:00
|
|
|
//
|
|
|
|
// error_code.hpp
|
|
|
|
// ~~~~~~~~~~~~~~
|
|
|
|
//
|
|
|
|
// Copyright (c) 2003-2007 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
|
|
|
//
|
|
|
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
|
|
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
//
|
|
|
|
|
|
|
|
#ifndef ASIO_ERROR_CODE_HPP
|
|
|
|
#define ASIO_ERROR_CODE_HPP
|
|
|
|
|
|
|
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
|
|
|
# pragma once
|
|
|
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
|
|
|
|
|
|
|
#include "asio/detail/push_options.hpp"
|
|
|
|
|
|
|
|
#include "asio/detail/push_options.hpp"
|
|
|
|
#include <boost/config.hpp>
|
|
|
|
#include <string>
|
|
|
|
#include "asio/detail/pop_options.hpp"
|
|
|
|
|
|
|
|
#if defined(GENERATING_DOCUMENTATION)
|
|
|
|
# define ASIO_WIN_OR_POSIX(e_win, e_posix) implementation_defined
|
|
|
|
#elif defined(BOOST_WINDOWS) || defined(__CYGWIN__)
|
|
|
|
# define ASIO_WIN_OR_POSIX(e_win, e_posix) e_win
|
|
|
|
#else
|
|
|
|
# define ASIO_WIN_OR_POSIX(e_win, e_posix) e_posix
|
|
|
|
#endif
|
|
|
|
|
|
|
|
namespace asio {
|
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
namespace error
|
2007-07-04 08:24:30 +00:00
|
|
|
{
|
2007-09-21 00:55:58 +00:00
|
|
|
/// Available error code categories.
|
|
|
|
enum error_category
|
|
|
|
{
|
|
|
|
/// System error codes.
|
|
|
|
system_category = ASIO_WIN_OR_POSIX(0, 0),
|
2007-07-04 08:24:30 +00:00
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
/// Error codes from NetDB functions.
|
2007-11-23 23:36:34 +00:00
|
|
|
netdb_category = ASIO_WIN_OR_POSIX(_system_category, 1),
|
2007-07-04 08:24:30 +00:00
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
/// Error codes from getaddrinfo.
|
2007-11-23 23:36:34 +00:00
|
|
|
addrinfo_category = ASIO_WIN_OR_POSIX(_system_category, 2),
|
2007-07-04 08:24:30 +00:00
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
/// Miscellaneous error codes.
|
|
|
|
misc_category = ASIO_WIN_OR_POSIX(3, 3),
|
2007-07-04 08:24:30 +00:00
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
/// SSL error codes.
|
|
|
|
ssl_category = ASIO_WIN_OR_POSIX(4, 4)
|
|
|
|
};
|
2007-11-23 23:36:34 +00:00
|
|
|
|
|
|
|
// Category getters.
|
|
|
|
inline error_category get_system_category() { return system_category; }
|
|
|
|
inline error_category get_netdb_category() { return netdb_category; }
|
|
|
|
inline error_category get_addrinfo_category() { return addrinfo_category; }
|
|
|
|
inline error_category get_misc_category() { return misc_category; }
|
|
|
|
inline error_category get_ssl_category() { return ssl_category; }
|
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
} // namespace error
|
2007-07-04 08:24:30 +00:00
|
|
|
|
2007-11-23 23:36:34 +00:00
|
|
|
/// Bring error category type into the asio namespace.
|
|
|
|
typedef asio::error::error_category error_category;
|
|
|
|
|
2007-07-04 08:24:30 +00:00
|
|
|
/// Class to represent an error code value.
|
|
|
|
class error_code
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/// The underlying representation of an error code.
|
|
|
|
typedef int value_type;
|
|
|
|
|
|
|
|
/// Default constructor.
|
|
|
|
error_code()
|
|
|
|
: value_(0),
|
2007-09-21 00:55:58 +00:00
|
|
|
category_(error::system_category)
|
2007-07-04 08:24:30 +00:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Construct with specific error code and category.
|
2007-11-23 23:36:34 +00:00
|
|
|
error_code(value_type v, error_category c)
|
2007-07-04 08:24:30 +00:00
|
|
|
: value_(v),
|
|
|
|
category_(c)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2007-09-21 00:55:58 +00:00
|
|
|
/// Construct from an error code enum.
|
|
|
|
template <typename ErrorEnum>
|
|
|
|
error_code(ErrorEnum e)
|
|
|
|
{
|
|
|
|
*this = make_error_code(e);
|
|
|
|
}
|
|
|
|
|
2007-07-04 08:24:30 +00:00
|
|
|
/// Get the error value.
|
|
|
|
value_type value() const
|
|
|
|
{
|
|
|
|
return value_;
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Get the error category.
|
2007-11-23 23:36:34 +00:00
|
|
|
error_category category() const
|
2007-07-04 08:24:30 +00:00
|
|
|
{
|
|
|
|
return category_;
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Get the message associated with the error.
|
|
|
|
std::string message() const;
|
|
|
|
|
|
|
|
struct unspecified_bool_type_t
|
|
|
|
{
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef unspecified_bool_type_t* unspecified_bool_type;
|
|
|
|
|
|
|
|
/// Operator returns non-null if there is a non-success error code.
|
|
|
|
operator unspecified_bool_type() const
|
|
|
|
{
|
|
|
|
if (value_ == 0)
|
|
|
|
return 0;
|
|
|
|
else
|
|
|
|
return reinterpret_cast<unspecified_bool_type>(1);
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Operator to test if the error represents success.
|
|
|
|
bool operator!() const
|
|
|
|
{
|
|
|
|
return value_ == 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Equality operator to compare two error objects.
|
|
|
|
friend bool operator==(const error_code& e1, const error_code& e2)
|
|
|
|
{
|
|
|
|
return e1.value_ == e2.value_ && e1.category_ == e2.category_;
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Inequality operator to compare two error objects.
|
|
|
|
friend bool operator!=(const error_code& e1, const error_code& e2)
|
|
|
|
{
|
|
|
|
return e1.value_ != e2.value_ || e1.category_ != e2.category_;
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
// The value associated with the error code.
|
|
|
|
value_type value_;
|
|
|
|
|
|
|
|
// The category associated with the error code.
|
2007-11-23 23:36:34 +00:00
|
|
|
error_category category_;
|
2007-07-04 08:24:30 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace asio
|
|
|
|
|
|
|
|
#undef ASIO_WIN_OR_POSIX
|
|
|
|
|
|
|
|
#include "asio/error.hpp"
|
|
|
|
|
|
|
|
#include "asio/detail/pop_options.hpp"
|
|
|
|
|
|
|
|
#endif // ASIO_ERROR_CODE_HPP
|