| // |
| // basic_socket_iostream.hpp |
| // ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| // |
| // Copyright (c) 2003-2015 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_BASIC_SOCKET_IOSTREAM_HPP |
| #define ASIO_BASIC_SOCKET_IOSTREAM_HPP |
| |
| #if defined(_MSC_VER) && (_MSC_VER >= 1200) |
| # pragma once |
| #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) |
| |
| #include "asio/detail/config.hpp" |
| |
| #if !defined(ASIO_NO_IOSTREAM) |
| |
| #include <istream> |
| #include <ostream> |
| #include "asio/basic_socket_streambuf.hpp" |
| #include "asio/stream_socket_service.hpp" |
| |
| #if !defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| |
| # include "asio/detail/variadic_templates.hpp" |
| |
| // A macro that should expand to: |
| // template <typename T1, ..., typename Tn> |
| // explicit basic_socket_iostream(T1 x1, ..., Tn xn) |
| // : std::basic_iostream<char>( |
| // &this->detail::socket_iostream_base< |
| // Protocol ASIO_SVC_TARG, Time, |
| // TimeTraits ASIO_SVC_TARG1>::streambuf_) |
| // { |
| // if (rdbuf()->connect(x1, ..., xn) == 0) |
| // this->setstate(std::ios_base::failbit); |
| // } |
| // This macro should only persist within this file. |
| |
| # define ASIO_PRIVATE_CTR_DEF(n) \ |
| template <ASIO_VARIADIC_TPARAMS(n)> \ |
| explicit basic_socket_iostream(ASIO_VARIADIC_BYVAL_PARAMS(n)) \ |
| : std::basic_iostream<char>( \ |
| &this->detail::socket_iostream_base< \ |
| Protocol ASIO_SVC_TARG, Time, \ |
| TimeTraits ASIO_SVC_TARG1>::streambuf_) \ |
| { \ |
| this->setf(std::ios_base::unitbuf); \ |
| if (rdbuf()->connect(ASIO_VARIADIC_BYVAL_ARGS(n)) == 0) \ |
| this->setstate(std::ios_base::failbit); \ |
| } \ |
| /**/ |
| |
| // A macro that should expand to: |
| // template <typename T1, ..., typename Tn> |
| // void connect(T1 x1, ..., Tn xn) |
| // { |
| // if (rdbuf()->connect(x1, ..., xn) == 0) |
| // this->setstate(std::ios_base::failbit); |
| // } |
| // This macro should only persist within this file. |
| |
| # define ASIO_PRIVATE_CONNECT_DEF(n) \ |
| template <ASIO_VARIADIC_TPARAMS(n)> \ |
| void connect(ASIO_VARIADIC_BYVAL_PARAMS(n)) \ |
| { \ |
| if (rdbuf()->connect(ASIO_VARIADIC_BYVAL_ARGS(n)) == 0) \ |
| this->setstate(std::ios_base::failbit); \ |
| } \ |
| /**/ |
| |
| #endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| |
| #include "asio/detail/push_options.hpp" |
| |
| namespace asio { |
| namespace detail { |
| |
| // A separate base class is used to ensure that the streambuf is initialised |
| // prior to the basic_socket_iostream's basic_iostream base class. |
| template <typename Protocol ASIO_SVC_TPARAM, |
| typename Time, typename TimeTraits ASIO_SVC_TPARAM1> |
| class socket_iostream_base |
| { |
| protected: |
| basic_socket_streambuf<Protocol ASIO_SVC_TARG, |
| Time, TimeTraits ASIO_SVC_TARG1> streambuf_; |
| }; |
| |
| } // namespace detail |
| |
| #if !defined(ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL) |
| #define ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL |
| |
| // Forward declaration with defaulted arguments. |
| template <typename Protocol |
| ASIO_SVC_TPARAM_DEF1(= stream_socket_service<Protocol>), |
| #if defined(ASIO_HAS_BOOST_DATE_TIME) |
| typename Time = boost::posix_time::ptime, |
| typename TimeTraits = time_traits<Time> |
| ASIO_SVC_TPARAM1_DEF2(= deadline_timer_service<Time, TimeTraits>)> |
| #else |
| typename Time = chrono::steady_clock, |
| typename TimeTraits = wait_traits<Time> |
| ASIO_SVC_TPARAM1_DEF1(= steady_timer::service_type)> |
| #endif |
| class basic_socket_iostream; |
| |
| #endif // !defined(ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL) |
| |
| /// Iostream interface for a socket. |
| #if defined(GENERATING_DOCUMENTATION) |
| template <typename Protocol, |
| typename Time = chrono::steady_clock, |
| typename TimeTraits = wait_traits<Time> > |
| #else // defined(GENERATING_DOCUMENTATION) |
| template <typename Protocol ASIO_SVC_TPARAM, |
| typename Time, typename TimeTraits ASIO_SVC_TPARAM1> |
| #endif // defined(GENERATING_DOCUMENTATION) |
| class basic_socket_iostream |
| : private detail::socket_iostream_base<Protocol |
| ASIO_SVC_TARG, Time, TimeTraits ASIO_SVC_TARG1>, |
| public std::basic_iostream<char> |
| { |
| private: |
| // These typedefs are intended keep this class's implementation independent |
| // of whether it's using Boost.DateTime, Boost.Chrono or std::chrono. |
| #if defined(ASIO_HAS_BOOST_DATE_TIME) |
| typedef TimeTraits traits_helper; |
| #else |
| typedef detail::chrono_time_traits<Time, TimeTraits> traits_helper; |
| #endif |
| |
| public: |
| /// The endpoint type. |
| typedef typename Protocol::endpoint endpoint_type; |
| |
| #if defined(GENERATING_DOCUMENTATION) |
| /// (Deprecated: Use time_point.) The time type. |
| typedef typename TimeTraits::time_type time_type; |
| |
| /// The time type. |
| typedef typename TimeTraits::time_point time_point; |
| |
| /// (Deprecated: Use duration.) The duration type. |
| typedef typename TimeTraits::duration_type duration_type; |
| |
| /// The duration type. |
| typedef typename TimeTraits::duration duration; |
| #else |
| # if !defined(ASIO_NO_DEPRECATED) |
| typedef typename traits_helper::time_type time_type; |
| typedef typename traits_helper::duration_type duration_type; |
| # endif // !defined(ASIO_NO_DEPRECATED) |
| typedef typename traits_helper::time_type time_point; |
| typedef typename traits_helper::duration_type duration; |
| #endif |
| |
| /// Construct a basic_socket_iostream without establishing a connection. |
| basic_socket_iostream() |
| : std::basic_iostream<char>( |
| &this->detail::socket_iostream_base< |
| Protocol ASIO_SVC_TARG, Time, |
| TimeTraits ASIO_SVC_TARG1>::streambuf_) |
| { |
| this->setf(std::ios_base::unitbuf); |
| } |
| |
| #if defined(GENERATING_DOCUMENTATION) |
| /// Establish a connection to an endpoint corresponding to a resolver query. |
| /** |
| * This constructor automatically establishes a connection based on the |
| * supplied resolver query parameters. The arguments are used to construct |
| * a resolver query object. |
| */ |
| template <typename T1, ..., typename TN> |
| explicit basic_socket_iostream(T1 t1, ..., TN tn); |
| #elif defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| template <typename... T> |
| explicit basic_socket_iostream(T... x) |
| : std::basic_iostream<char>( |
| &this->detail::socket_iostream_base< |
| Protocol ASIO_SVC_TARG, Time, |
| TimeTraits ASIO_SVC_TARG1>::streambuf_) |
| { |
| this->setf(std::ios_base::unitbuf); |
| if (rdbuf()->connect(x...) == 0) |
| this->setstate(std::ios_base::failbit); |
| } |
| #else |
| ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_CTR_DEF) |
| #endif |
| |
| #if defined(GENERATING_DOCUMENTATION) |
| /// Establish a connection to an endpoint corresponding to a resolver query. |
| /** |
| * This function automatically establishes a connection based on the supplied |
| * resolver query parameters. The arguments are used to construct a resolver |
| * query object. |
| */ |
| template <typename T1, ..., typename TN> |
| void connect(T1 t1, ..., TN tn); |
| #elif defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| template <typename... T> |
| void connect(T... x) |
| { |
| if (rdbuf()->connect(x...) == 0) |
| this->setstate(std::ios_base::failbit); |
| } |
| #else |
| ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_CONNECT_DEF) |
| #endif |
| |
| /// Close the connection. |
| void close() |
| { |
| if (rdbuf()->close() == 0) |
| this->setstate(std::ios_base::failbit); |
| } |
| |
| /// Return a pointer to the underlying streambuf. |
| basic_socket_streambuf<Protocol ASIO_SVC_TARG, |
| Time, TimeTraits ASIO_SVC_TARG1>* rdbuf() const |
| { |
| return const_cast<basic_socket_streambuf<Protocol ASIO_SVC_TARG, |
| Time, TimeTraits ASIO_SVC_TARG1>*>( |
| &this->detail::socket_iostream_base< |
| Protocol ASIO_SVC_TARG, Time, |
| TimeTraits ASIO_SVC_TARG1>::streambuf_); |
| } |
| |
| /// Get a reference to the underlying socket. |
| basic_socket<Protocol ASIO_SVC_TARG>& socket() |
| { |
| return rdbuf()->socket(); |
| } |
| |
| /// Get the last error associated with the stream. |
| /** |
| * @return An \c error_code corresponding to the last error from the stream. |
| * |
| * @par Example |
| * To print the error associated with a failure to establish a connection: |
| * @code tcp::iostream s("www.boost.org", "http"); |
| * if (!s) |
| * { |
| * std::cout << "Error: " << s.error().message() << std::endl; |
| * } @endcode |
| */ |
| const asio::error_code& error() const |
| { |
| return rdbuf()->error(); |
| } |
| |
| #if !defined(ASIO_NO_DEPRECATED) |
| /// (Deprecated: Use expiry().) Get the stream's expiry time as an absolute |
| /// time. |
| /** |
| * @return An absolute time value representing the stream's expiry time. |
| */ |
| time_point expires_at() const |
| { |
| return rdbuf()->expires_at(); |
| } |
| #endif // !defined(ASIO_NO_DEPRECATED) |
| |
| /// Get the stream's expiry time as an absolute time. |
| /** |
| * @return An absolute time value representing the stream's expiry time. |
| */ |
| time_point expiry() const |
| { |
| return rdbuf()->expiry(); |
| } |
| |
| /// Set the stream's expiry time as an absolute time. |
| /** |
| * This function sets the expiry time associated with the stream. Stream |
| * operations performed after this time (where the operations cannot be |
| * completed using the internal buffers) will fail with the error |
| * asio::error::operation_aborted. |
| * |
| * @param expiry_time The expiry time to be used for the stream. |
| */ |
| void expires_at(const time_point& expiry_time) |
| { |
| rdbuf()->expires_at(expiry_time); |
| } |
| |
| /// Set the stream's expiry time relative to now. |
| /** |
| * This function sets the expiry time associated with the stream. Stream |
| * operations performed after this time (where the operations cannot be |
| * completed using the internal buffers) will fail with the error |
| * asio::error::operation_aborted. |
| * |
| * @param expiry_time The expiry time to be used for the timer. |
| */ |
| void expires_after(const duration& expiry_time) |
| { |
| rdbuf()->expires_after(expiry_time); |
| } |
| |
| #if !defined(ASIO_NO_DEPRECATED) |
| /// (Deprecated: Use expiry().) Get the stream's expiry time relative to now. |
| /** |
| * @return A relative time value representing the stream's expiry time. |
| */ |
| duration expires_from_now() const |
| { |
| return rdbuf()->expires_from_now(); |
| } |
| |
| /// (Deprecated: Use expires_after().) Set the stream's expiry time relative |
| /// to now. |
| /** |
| * This function sets the expiry time associated with the stream. Stream |
| * operations performed after this time (where the operations cannot be |
| * completed using the internal buffers) will fail with the error |
| * asio::error::operation_aborted. |
| * |
| * @param expiry_time The expiry time to be used for the timer. |
| */ |
| void expires_from_now(const duration& expiry_time) |
| { |
| rdbuf()->expires_from_now(expiry_time); |
| } |
| #endif // !defined(ASIO_NO_DEPRECATED) |
| }; |
| |
| } // namespace asio |
| |
| #include "asio/detail/pop_options.hpp" |
| |
| #if !defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| # undef ASIO_PRIVATE_CTR_DEF |
| # undef ASIO_PRIVATE_CONNECT_DEF |
| #endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES) |
| |
| #endif // !defined(ASIO_NO_IOSTREAM) |
| |
| #endif // ASIO_BASIC_SOCKET_IOSTREAM_HPP |