1 // 2 // basic_io_object.hpp 3 // ~~~~~~~~~~~~~~~~~~~ 4 // 5 // Copyright (c) 2003-2015 Christopher M. Kohlhoff (chris at kohlhoff dot com) 6 // 7 // Distributed under the Boost Software License, Version 1.0. (See accompanying 8 // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) 9 // 10 11 #ifndef ASIO_BASIC_IO_OBJECT_HPP 12 #define ASIO_BASIC_IO_OBJECT_HPP 13 14 15 #include "asio/detail/config.hpp" 16 #include "asio/io_service.hpp" 17 18 #include "asio/detail/push_options.hpp" 19 20 namespace asio { 21 22 namespace detail 23 { 24 // Type trait used to determine whether a service supports move. 25 template <typename IoObjectService> 26 class service_has_move 27 { 28 private: 29 typedef IoObjectService service_type; 30 typedef typename service_type::implementation_type implementation_type; 31 32 template <typename T, typename U> 33 static auto eval(T* t, U* u) -> decltype(t->move_construct(*u, *u), char()); 34 static char (&eval(...))[2]; 35 36 public: 37 static const bool value = 38 sizeof(service_has_move::eval( 39 static_cast<service_type*>(0), 40 static_cast<implementation_type*>(0))) == 1; 41 }; 42 } 43 44 /// Base class for all I/O objects. 45 /** 46 * @note All I/O objects are non-copyable. However, when using C++0x, certain 47 * I/O objects do support move construction and move assignment. 48 */ 49 template <typename IoObjectService, 50 bool Movable = detail::service_has_move<IoObjectService>::value> 51 class basic_io_object 52 { 53 public: 54 /// The type of the service that will be used to provide I/O operations. 55 typedef IoObjectService service_type; 56 57 /// The underlying implementation type of I/O object. 58 typedef typename service_type::implementation_type implementation_type; 59 60 /// Get the io_service associated with the object. 61 /** 62 * This function may be used to obtain the io_service object that the I/O 63 * object uses to dispatch handlers for asynchronous operations. 64 * 65 * @return A reference to the io_service object that the I/O object will use 66 * to dispatch handlers. Ownership is not transferred to the caller. 67 */ get_io_service()68 asio::io_service& get_io_service() 69 { 70 return service.get_io_service(); 71 } 72 73 protected: 74 /// Construct a basic_io_object. 75 /** 76 * Performs: 77 * @code get_service().construct(get_implementation()); @endcode 78 */ basic_io_object(asio::io_service & io_service)79 explicit basic_io_object(asio::io_service& io_service) 80 : service(asio::use_service<IoObjectService>(io_service)) 81 { 82 service.construct(implementation); 83 } 84 85 86 /// Protected destructor to prevent deletion through this type. 87 /** 88 * Performs: 89 * @code get_service().destroy(get_implementation()); @endcode 90 */ ~basic_io_object()91 ~basic_io_object() 92 { 93 service.destroy(implementation); 94 } 95 96 /// Get the service associated with the I/O object. get_service()97 service_type& get_service() 98 { 99 return service; 100 } 101 102 /// Get the service associated with the I/O object. get_service() const103 const service_type& get_service() const 104 { 105 return service; 106 } 107 108 /// (Deprecated: Use get_service().) The service associated with the I/O 109 /// object. 110 /** 111 * @note Available only for services that do not support movability. 112 */ 113 service_type& service; 114 115 /// Get the underlying implementation of the I/O object. get_implementation()116 implementation_type& get_implementation() 117 { 118 return implementation; 119 } 120 121 /// Get the underlying implementation of the I/O object. get_implementation() const122 const implementation_type& get_implementation() const 123 { 124 return implementation; 125 } 126 127 /// (Deprecated: Use get_implementation().) The underlying implementation of 128 /// the I/O object. 129 implementation_type implementation; 130 131 private: 132 basic_io_object(const basic_io_object&); 133 basic_io_object& operator=(const basic_io_object&); 134 }; 135 136 // Specialisation for movable objects. 137 template <typename IoObjectService> 138 class basic_io_object<IoObjectService, true> 139 { 140 public: 141 typedef IoObjectService service_type; 142 typedef typename service_type::implementation_type implementation_type; 143 get_io_service()144 asio::io_service& get_io_service() 145 { 146 return service_->get_io_service(); 147 } 148 149 protected: basic_io_object(asio::io_service & io_service)150 explicit basic_io_object(asio::io_service& io_service) 151 : service_(&asio::use_service<IoObjectService>(io_service)) 152 { 153 service_->construct(implementation); 154 } 155 basic_io_object(basic_io_object && other)156 basic_io_object(basic_io_object&& other) 157 : service_(&other.get_service()) 158 { 159 service_->move_construct(implementation, other.implementation); 160 } 161 ~basic_io_object()162 ~basic_io_object() 163 { 164 service_->destroy(implementation); 165 } 166 operator =(basic_io_object && other)167 basic_io_object& operator=(basic_io_object&& other) 168 { 169 service_->move_assign(implementation, 170 *other.service_, other.implementation); 171 service_ = other.service_; 172 return *this; 173 } 174 get_service()175 service_type& get_service() 176 { 177 return *service_; 178 } 179 get_service() const180 const service_type& get_service() const 181 { 182 return *service_; 183 } 184 get_implementation()185 implementation_type& get_implementation() 186 { 187 return implementation; 188 } 189 get_implementation() const190 const implementation_type& get_implementation() const 191 { 192 return implementation; 193 } 194 195 implementation_type implementation; 196 197 private: 198 basic_io_object(const basic_io_object&); 199 void operator=(const basic_io_object&); 200 201 IoObjectService* service_; 202 }; 203 204 } // namespace asio 205 206 #include "asio/detail/pop_options.hpp" 207 208 #endif // ASIO_BASIC_IO_OBJECT_HPP 209