OSDN Git Service

2011-03-14 Benjamin Kosnik <bkoz@redhat.com>
[pf3gnuchains/gcc-fork.git] / libstdc++-v3 / include / std / system_error
index 3f13622..da09a75 100644 (file)
@@ -1,11 +1,11 @@
 // <system_error> -*- C++ -*-
 
-// Copyright (C) 2007 Free Software Foundation, Inc.
+// Copyright (C) 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
 //
 // This file is part of the GNU ISO C++ Library.  This library 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 2, or (at your option)
+// Free Software Foundation; either version 3, or (at your option)
 // any later version.
 
 // This library is distributed in the hope that it will be useful,
 // 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 library; see the file COPYING.  If not, write to
-// the Free Software Foundation, 51 Franklin Street, Fifth Floor,
-// Boston, MA 02110-1301, USA.
+// Under Section 7 of GPL version 3, you are granted additional
+// permissions described in the GCC Runtime Library Exception, version
+// 3.1, as published by the Free Software Foundation.
 
-// As a special exception, you may use this file as part of a free software
-// library without restriction.  Specifically, if other files instantiate
-// templates or use macros or inline functions from this file, or you compile
-// this file and link it with other files to produce an executable, this
-// file does not by itself cause the resulting executable to be covered by
-// the GNU General Public License.  This exception does not however
-// invalidate any other reasons why the executable file might be covered by
-// the GNU General Public License.
+// You should have received a copy of the GNU General Public License and
+// a copy of the GCC Runtime Library Exception along with this program;
+// see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
+// <http://www.gnu.org/licenses/>.
 
 /** @file include/system_error
  *  This is a Standard C++ Library header.
 #pragma GCC system_header
 
 #ifndef __GXX_EXPERIMENTAL_CXX0X__
-# include <c++0x_warning.h>
-#endif
+# include <bits/c++0x_warning.h>
+#else
 
 #include <bits/c++config.h>
-#include <cerrno>
+#include <bits/error_constants.h>
 #include <iosfwd>
 #include <stdexcept>
 
-_GLIBCXX_BEGIN_NAMESPACE(std)
+namespace std _GLIBCXX_VISIBILITY(default)
+{
+_GLIBCXX_BEGIN_NAMESPACE_VERSION
 
-  class system_error;
   class error_code;
+  class error_condition;
   class error_category;
+  class system_error;
 
-  extern const error_category& system_category;
+  /// is_error_code_enum
+  template<typename _Tp>
+    struct is_error_code_enum : public false_type { };
 
-  enum posix_errno
-    {
-      address_family_not_supported =           EAFNOSUPPORT,
-      address_in_use =                                 EADDRINUSE,
-      address_not_available =                  EADDRNOTAVAIL,
-      already_connected =                      EISCONN,
-      argument_list_too_long =                         E2BIG,
-      argument_out_of_domain =                         EDOM,
-      bad_address =                            EFAULT,
-      bad_file_descriptor =                    EBADF,
-      bad_message =                            EBADMSG,
-      broken_pipe =                            EPIPE,
-      connection_aborted =                     ECONNABORTED,
-      connection_already_in_progress =                 EALREADY,
-      connection_refused =                     ECONNREFUSED,
-      connection_reset =                       ECONNRESET,
-      cross_device_link =                      EXDEV,
-      destination_address_required =           EDESTADDRREQ,
-      device_or_resource_busy =                EBUSY,
-      directory_not_empty =                    ENOTEMPTY,
-      executable_format_error =                ENOEXEC,
-      file_exists =                            EEXIST,
-      file_too_large =                                 EFBIG,
-      filename_too_long =                      ENAMETOOLONG,
-      function_not_supported =                         ENOSYS,
-      host_unreachable =                       EHOSTUNREACH,
-      identifier_removed =                     EIDRM,
-      illegal_byte_sequence =                  EILSEQ,
-      inappropriate_io_control_operation =     ENOTTY,
-      interrupted =                            EINTR,
-      invalid_argument =                       EINVAL,
-      invalid_seek =                           ESPIPE,
-      io_error =                               EIO,
-      is_a_directory =                                 EISDIR,
-      message_size =                           EMSGSIZE,
-      network_down =                           ENETDOWN,
-      network_reset =                          ENETRESET,
-      network_unreachable =                    ENETUNREACH,
-      no_buffer_space =                        ENOBUFS,
-      no_child_process =                       ECHILD,
-      no_link =                                ENOLINK,
-      no_lock_available =                      ENOLCK,
-      no_message_available =                   ENODATA, 
-      no_message =                             ENOMSG, 
-      no_protocol_option =                     ENOPROTOOPT,
-      no_space_on_device =                     ENOSPC,
-      no_stream_resources =                    ENOSR,
-      no_such_device_or_address =              ENXIO,
-      no_such_device =                                 ENODEV,
-      no_such_file_or_directory =              ENOENT,
-      no_such_process =                        ESRCH,
-      not_a_directory =                        ENOTDIR,
-      not_a_socket =                           ENOTSOCK,
-      not_a_stream =                           ENOSTR,
-      not_connected =                          ENOTCONN,
-      not_enough_memory =                      ENOMEM,
-      not_supported =                          ENOTSUP,
-      operation_canceled =                     ECANCELED,
-      operation_in_progress =                  EINPROGRESS,
-      operation_not_permitted =                EPERM,
-      operation_not_supported =                EOPNOTSUPP,
-      operation_would_block =                  EWOULDBLOCK,
-#ifdef _GLIBCXX_HAVE_EOWNERDEAD
-      owner_dead =                             EOWNERDEAD,
-#endif
-      permission_denied =                      EACCES,
-      protocol_error =                                 EPROTO,
-      protocol_not_supported =                         EPROTONOSUPPORT,
-      read_only_file_system =                  EROFS,
-      resource_deadlock_would_occur =          EDEADLK,
-      resource_unavailable_try_again =                 EAGAIN,
-      result_out_of_range =                    ERANGE,
-#ifdef _GLIBCXX_HAVE_ENOTRECOVERABLE
-      state_not_recoverable =                  ENOTRECOVERABLE,
-#endif
-      stream_timeout =                                 ETIME,
-      text_file_busy =                                 ETXTBSY,
-      timed_out =                              ETIMEDOUT,
-      too_many_files_open_in_system =          ENFILE,
-      too_many_files_open =                    EMFILE,
-      too_many_links =                                 EMLINK,
-      too_many_synbolic_link_levels =          ELOOP,
-      value_too_large =                        EOVERFLOW,
-      wrong_protocol_type =                    EPROTOTYPE,
-      no_posix_equivalent = 1L << 16
-    };
+  /// is_error_condition_enum
+  template<typename _Tp>
+    struct is_error_condition_enum : public false_type { };
+
+  template<> 
+    struct is_error_condition_enum<errc>
+    : public true_type { };
 
-  struct error_category
+
+  /// error_category
+  class error_category
   {
-    error_category() { }
+  protected:
+    error_category();
+
+  public:
+    virtual ~error_category();
+
+    error_category(const error_category&) = delete;
+    error_category& operator=(const error_category&) = delete;
+
+    virtual const char* 
+    name() const = 0;
+
+    virtual string 
+    message(int) const = 0;
+
+    virtual error_condition
+    default_error_condition(int __i) const;
+
+    virtual bool 
+    equivalent(int __i, const error_condition& __cond) const;
+
+    virtual bool 
+    equivalent(const error_code& __code, int __i) const;
+
+    bool 
+    operator<(const error_category& __other) const
+    { return less<const error_category*>()(this, &__other); }
 
     bool 
     operator==(const error_category& __other) const
@@ -151,86 +100,240 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     bool 
     operator!=(const error_category& __other) const
     { return this != &__other; }
+  };
 
-    virtual posix_errno 
-    posix(int __v) const = 0;
-
-    virtual const string& 
-    name() const = 0;
+  // DR 890.
+  _GLIBCXX_CONST const error_category& system_category() throw();
+  _GLIBCXX_CONST const error_category& generic_category() throw();
 
-  private:
-    error_category(const error_category&);
+  error_code make_error_code(errc);
 
-    error_category& 
-    operator=(const error_category&);
-  };
+  template<typename _Tp>
+    struct hash;
 
+  /// error_code
+  // Implementation-specific error identification
   struct error_code
   {
-    error_code() throw()
-    : _M_value(0), _M_cat(&system_category) { }
+    error_code()
+    : _M_value(0), _M_cat(&system_category()) { }
 
-    error_code(int __v, const error_category& __cat) throw()
+    error_code(int __v, const error_category& __cat)
     : _M_value(__v), _M_cat(&__cat) { }
 
-    error_code(posix_errno __v)
-    : _M_value(__v), _M_cat(&system_category) { }
+    template<typename _ErrorCodeEnum>
+      error_code(_ErrorCodeEnum __e,
+      typename enable_if<is_error_code_enum<_ErrorCodeEnum>::value>::type* = 0)
+      { *this = make_error_code(__e); }
 
     void 
-    assign(int __v, const error_category& __cat) throw()
+    assign(int __v, const error_category& __cat)
     {
       _M_value = __v;
       _M_cat = &__cat; 
     }
 
     void 
-    clear() throw()
-    { 
-      _M_value = 0;
-      _M_cat = &system_category;
-   } 
+    clear()
+    { assign(0, system_category()); }
+
+    // DR 804.
+    template<typename _ErrorCodeEnum>
+      typename enable_if<is_error_code_enum<_ErrorCodeEnum>::value,
+                        error_code&>::type
+      operator=(_ErrorCodeEnum __e)
+      { return *this = make_error_code(__e); }
 
     int
-    value() const throw() { return _M_value; }
+    value() const { return _M_value; }
       
     const error_category&  
     category() const { return *_M_cat; }
 
-    posix_errno            
-    posix() const throw() { return this->category().posix(_M_value); }
+    error_condition 
+    default_error_condition() const;
+
+    string 
+    message() const
+    { return category().message(value()); }
+
+    explicit operator bool() const
+    { return _M_value != 0 ? true : false; }
+
+    // DR 804.
+  private:
+    friend class hash<error_code>;
+
+    int                        _M_value;
+    const error_category*      _M_cat;
+  };
+
+  // 19.4.2.6 non-member functions
+  inline error_code
+  make_error_code(errc __e)
+  { return error_code(static_cast<int>(__e), generic_category()); }
+
+  inline bool
+  operator<(const error_code& __lhs, const error_code& __rhs)
+  { 
+    return (__lhs.category() < __rhs.category()
+           || (__lhs.category() == __rhs.category()
+               && __lhs.value() < __rhs.value()));
+  }
+
+  template<typename _CharT, typename _Traits>
+    basic_ostream<_CharT, _Traits>&
+    operator<<(basic_ostream<_CharT, _Traits>& __os, const error_code& __e)
+    { return (__os << __e.category().name() << ':' << __e.value()); }
+
+  error_condition make_error_condition(errc);
+
+  /// error_condition
+  // Portable error identification
+  struct error_condition 
+  {
+    error_condition()
+    : _M_value(0), _M_cat(&generic_category()) { }
+
+    error_condition(int __v, const error_category& __cat)     
+    : _M_value(__v), _M_cat(&__cat) { }
 
-    // Safe bool idiom.
-    // explicit operator bool() const throw()
-    // { return _M_value != 0; }
-    typedef void (*__bool_type)();
+    template<typename _ErrorConditionEnum>
+      error_condition(_ErrorConditionEnum __e,
+                     typename enable_if<is_error_condition_enum
+                                     <_ErrorConditionEnum>::value>::type* = 0)
+      { *this = make_error_condition(__e); }
 
-    static void __not_bool_type() { }
+    void
+    assign(int __v, const error_category& __cat)
+    {
+      _M_value = __v;
+      _M_cat = &__cat;
+    }
 
-    operator __bool_type() const throw()
-    { return _M_value != 0 ? &__not_bool_type : false; }
+    // DR 804.
+    template<typename _ErrorConditionEnum>
+      typename enable_if<is_error_condition_enum
+                        <_ErrorConditionEnum>::value, error_condition&>::type
+      operator=(_ErrorConditionEnum __e)
+      { return *this = make_error_condition(__e); }
 
-    bool operator==(const error_code& __other) const
-    { return value() == __other.value() && category() == __other.category(); }
+    void 
+    clear()
+    { assign(0, generic_category()); }
+
+    // 19.4.3.4 observers
+    int 
+    value() const { return _M_value; }
+
+    const error_category&
+    category() const { return *_M_cat; }
 
-    bool operator!=(const error_code& __other) const
-    { return !(this == &__other); }
+    string 
+    message() const
+    { return category().message(value()); }
 
+    explicit operator bool() const
+    { return _M_value != 0 ? true : false; }
+
+    // DR 804.
   private:
-    int                        _M_value;
+    int                        _M_value;
     const error_category*      _M_cat;
   };
 
+  // 19.4.3.6 non-member functions
+  inline error_condition
+  make_error_condition(errc __e)
+  { return error_condition(static_cast<int>(__e), generic_category()); }
+
+  inline bool 
+  operator<(const error_condition& __lhs, const error_condition& __rhs)
+  {
+    return (__lhs.category() < __rhs.category()
+           || (__lhs.category() == __rhs.category()
+               && __lhs.value() < __rhs.value()));
+  }
+
+  // 19.4.4 Comparison operators
+  inline bool
+  operator==(const error_code& __lhs, const error_code& __rhs)
+  { return (__lhs.category() == __rhs.category()
+           && __lhs.value() == __rhs.value()); }
+
+  inline bool
+  operator==(const error_code& __lhs, const error_condition& __rhs)
+  {
+    return (__lhs.category().equivalent(__lhs.value(), __rhs)
+           || __rhs.category().equivalent(__lhs, __rhs.value()));
+  }
+
+  inline bool
+  operator==(const error_condition& __lhs, const error_code& __rhs)
+  {
+    return (__rhs.category().equivalent(__rhs.value(), __lhs)
+           || __lhs.category().equivalent(__rhs, __lhs.value()));
+  }
+
+  inline bool
+  operator==(const error_condition& __lhs, const error_condition& __rhs)
+  {
+    return (__lhs.category() == __rhs.category()
+           && __lhs.value() == __rhs.value());
+  }
+
+  inline bool
+  operator!=(const error_code& __lhs, const error_code& __rhs)
+  { return !(__lhs == __rhs); }
+
+  inline bool
+  operator!=(const error_code& __lhs, const error_condition& __rhs)
+  { return !(__lhs == __rhs); }
+
+  inline bool
+  operator!=(const error_condition& __lhs, const error_code& __rhs)
+  { return !(__lhs == __rhs); }
+
+  inline bool
+  operator!=(const error_condition& __lhs, const error_condition& __rhs)
+  { return !(__lhs == __rhs); }
+
+
+  /** 
+   *  @brief Thrown to indicate error code of underlying system.
+   *
+   *  @ingroup exceptions
+   */
   class system_error : public std::runtime_error
   {
   private:
     error_code         _M_code;
 
   public:
-    system_error(const string& __what, error_code __ec = error_code())
-    : runtime_error(__what), _M_code(__ec) { }
-
-    system_error(const string& __what, int __v, const error_category& __ecat)
-    : runtime_error(__what), _M_code(error_code(__v, __ecat)) { }
+    system_error(error_code __ec = error_code())
+    : runtime_error(__ec.message()), _M_code(__ec) { }
+
+    system_error(error_code __ec, const string& __what)
+    : runtime_error(__what + ": " + __ec.message()), _M_code(__ec) { }
+
+    /*
+     * TODO: Add const char* ctors to all exceptions.
+     *
+     * system_error(error_code __ec, const char* __what)
+     * : runtime_error(__what + (": " + __ec.message())), _M_code(__ec) { }
+     *
+     * system_error(int __v, const error_category& __ecat, const char* __what)
+     * : runtime_error(__what + (": " + __ec.message())),
+     *   _M_code(error_code(__v, __ecat)) { }
+     */
+
+    system_error(int __v, const error_category& __ecat)
+    : runtime_error(error_code(__v, __ecat).message()),
+      _M_code(__v, __ecat) { }
+
+    system_error(int __v, const error_category& __ecat, const string& __what)
+    : runtime_error(__what + ": " + error_code(__v, __ecat).message()),
+      _M_code(__v, __ecat) { }
 
     virtual ~system_error() throw();
 
@@ -238,7 +341,36 @@ _GLIBCXX_BEGIN_NAMESPACE(std)
     code() const throw() { return _M_code; }
   };
 
-_GLIBCXX_END_NAMESPACE
+_GLIBCXX_END_NAMESPACE_VERSION
+} // namespace
+
+#ifndef _GLIBCXX_COMPATIBILITY_CXX0X
+
+#include <bits/functional_hash.h>
+
+namespace std _GLIBCXX_VISIBILITY(default)
+{
+_GLIBCXX_BEGIN_NAMESPACE_VERSION
+
+  // DR 1182.
+  /// std::hash specialization for error_code.
+  template<>
+    struct hash<error_code>
+    : public __hash_base<size_t, error_code>
+    {
+      size_t
+      operator()(const error_code& __e) const
+      {
+       const size_t __tmp = std::_Hash_impl::hash(__e._M_value);
+       return std::_Hash_impl::__hash_combine(__e._M_cat, __tmp);
+      }
+    };
+
+_GLIBCXX_END_NAMESPACE_VERSION
+} // namespace
+
+#endif // _GLIBCXX_COMPATIBILITY_CXX0X
 
-#endif 
+#endif // __GXX_EXPERIMENTAL_CXX0X__
 
+#endif // _GLIBCXX_SYSTEM_ERROR