// // impl/read.hpp // ~~~~~~~~~~~~~ // // Copyright (c) 2003-2024 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_IMPL_READ_HPP #define ASIO_IMPL_READ_HPP #if defined(_MSC_VER) && (_MSC_VER >= 1200) # pragma once #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) #include #include "asio/associator.hpp" #include "asio/buffer.hpp" #include "asio/detail/array_fwd.hpp" #include "asio/detail/base_from_cancellation_state.hpp" #include "asio/detail/base_from_completion_cond.hpp" #include "asio/detail/bind_handler.hpp" #include "asio/detail/consuming_buffers.hpp" #include "asio/detail/dependent_type.hpp" #include "asio/detail/handler_cont_helpers.hpp" #include "asio/detail/handler_tracking.hpp" #include "asio/detail/handler_type_requirements.hpp" #include "asio/detail/non_const_lvalue.hpp" #include "asio/detail/throw_error.hpp" #include "asio/error.hpp" #include "asio/detail/push_options.hpp" namespace asio { namespace detail { template std::size_t read_buffer_seq(SyncReadStream& s, const MutableBufferSequence& buffers, const MutableBufferIterator&, CompletionCondition completion_condition, asio::error_code& ec) { ec = asio::error_code(); asio::detail::consuming_buffers tmp(buffers); while (!tmp.empty()) { if (std::size_t max_size = detail::adapt_completion_condition_result( completion_condition(ec, tmp.total_consumed()))) tmp.consume(s.read_some(tmp.prepare(max_size), ec)); else break; } return tmp.total_consumed(); } } // namespace detail template std::size_t read(SyncReadStream& s, const MutableBufferSequence& buffers, CompletionCondition completion_condition, asio::error_code& ec, constraint_t< is_mutable_buffer_sequence::value >) { return detail::read_buffer_seq(s, buffers, asio::buffer_sequence_begin(buffers), static_cast(completion_condition), ec); } template inline std::size_t read(SyncReadStream& s, const MutableBufferSequence& buffers, constraint_t< is_mutable_buffer_sequence::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, buffers, transfer_all(), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } template inline std::size_t read(SyncReadStream& s, const MutableBufferSequence& buffers, asio::error_code& ec, constraint_t< is_mutable_buffer_sequence::value >) { return read(s, buffers, transfer_all(), ec); } template inline std::size_t read(SyncReadStream& s, const MutableBufferSequence& buffers, CompletionCondition completion_condition, constraint_t< is_mutable_buffer_sequence::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, buffers, static_cast(completion_condition), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } #if !defined(ASIO_NO_DYNAMIC_BUFFER_V1) template std::size_t read(SyncReadStream& s, DynamicBuffer_v1&& buffers, CompletionCondition completion_condition, asio::error_code& ec, constraint_t< is_dynamic_buffer_v1>::value >, constraint_t< !is_dynamic_buffer_v2>::value >) { decay_t b( static_cast(buffers)); ec = asio::error_code(); std::size_t total_transferred = 0; std::size_t max_size = detail::adapt_completion_condition_result( completion_condition(ec, total_transferred)); std::size_t bytes_available = std::min( std::max(512, b.capacity() - b.size()), std::min(max_size, b.max_size() - b.size())); while (bytes_available > 0) { std::size_t bytes_transferred = s.read_some(b.prepare(bytes_available), ec); b.commit(bytes_transferred); total_transferred += bytes_transferred; max_size = detail::adapt_completion_condition_result( completion_condition(ec, total_transferred)); bytes_available = std::min( std::max(512, b.capacity() - b.size()), std::min(max_size, b.max_size() - b.size())); } return total_transferred; } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v1&& buffers, constraint_t< is_dynamic_buffer_v1>::value >, constraint_t< !is_dynamic_buffer_v2>::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, static_cast(buffers), transfer_all(), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v1&& buffers, asio::error_code& ec, constraint_t< is_dynamic_buffer_v1>::value >, constraint_t< !is_dynamic_buffer_v2>::value >) { return read(s, static_cast(buffers), transfer_all(), ec); } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v1&& buffers, CompletionCondition completion_condition, constraint_t< is_dynamic_buffer_v1>::value >, constraint_t< !is_dynamic_buffer_v2>::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, static_cast(buffers), static_cast(completion_condition), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } #if !defined(ASIO_NO_EXTENSIONS) #if !defined(ASIO_NO_IOSTREAM) template inline std::size_t read(SyncReadStream& s, asio::basic_streambuf& b, CompletionCondition completion_condition, asio::error_code& ec) { return read(s, basic_streambuf_ref(b), static_cast(completion_condition), ec); } template inline std::size_t read(SyncReadStream& s, asio::basic_streambuf& b) { return read(s, basic_streambuf_ref(b)); } template inline std::size_t read(SyncReadStream& s, asio::basic_streambuf& b, asio::error_code& ec) { return read(s, basic_streambuf_ref(b), ec); } template inline std::size_t read(SyncReadStream& s, asio::basic_streambuf& b, CompletionCondition completion_condition) { return read(s, basic_streambuf_ref(b), static_cast(completion_condition)); } #endif // !defined(ASIO_NO_IOSTREAM) #endif // !defined(ASIO_NO_EXTENSIONS) #endif // !defined(ASIO_NO_DYNAMIC_BUFFER_V1) template std::size_t read(SyncReadStream& s, DynamicBuffer_v2 buffers, CompletionCondition completion_condition, asio::error_code& ec, constraint_t< is_dynamic_buffer_v2::value >) { DynamicBuffer_v2& b = buffers; ec = asio::error_code(); std::size_t total_transferred = 0; std::size_t max_size = detail::adapt_completion_condition_result( completion_condition(ec, total_transferred)); std::size_t bytes_available = std::min( std::max(512, b.capacity() - b.size()), std::min(max_size, b.max_size() - b.size())); while (bytes_available > 0) { std::size_t pos = b.size(); b.grow(bytes_available); std::size_t bytes_transferred = s.read_some( b.data(pos, bytes_available), ec); b.shrink(bytes_available - bytes_transferred); total_transferred += bytes_transferred; max_size = detail::adapt_completion_condition_result( completion_condition(ec, total_transferred)); bytes_available = std::min( std::max(512, b.capacity() - b.size()), std::min(max_size, b.max_size() - b.size())); } return total_transferred; } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v2 buffers, constraint_t< is_dynamic_buffer_v2::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, static_cast(buffers), transfer_all(), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v2 buffers, asio::error_code& ec, constraint_t< is_dynamic_buffer_v2::value >) { return read(s, static_cast(buffers), transfer_all(), ec); } template inline std::size_t read(SyncReadStream& s, DynamicBuffer_v2 buffers, CompletionCondition completion_condition, constraint_t< is_dynamic_buffer_v2::value >) { asio::error_code ec; std::size_t bytes_transferred = read(s, static_cast(buffers), static_cast(completion_condition), ec); asio::detail::throw_error(ec, "read"); return bytes_transferred; } namespace detail { template class read_op : public base_from_cancellation_state, base_from_completion_cond { public: read_op(AsyncReadStream& stream, const MutableBufferSequence& buffers, CompletionCondition& completion_condition, ReadHandler& handler) : base_from_cancellation_state( handler, enable_partial_cancellation()), base_from_completion_cond(completion_condition), stream_(stream), buffers_(buffers), start_(0), handler_(static_cast(handler)) { } read_op(const read_op& other) : base_from_cancellation_state(other), base_from_completion_cond(other), stream_(other.stream_), buffers_(other.buffers_), start_(other.start_), handler_(other.handler_) { } read_op(read_op&& other) : base_from_cancellation_state( static_cast&&>(other)), base_from_completion_cond( static_cast&&>(other)), stream_(other.stream_), buffers_(static_cast(other.buffers_)), start_(other.start_), handler_(static_cast(other.handler_)) { } void operator()(asio::error_code ec, std::size_t bytes_transferred, int start = 0) { std::size_t max_size; switch (start_ = start) { case 1: max_size = this->check_for_completion(ec, buffers_.total_consumed()); for (;;) { { ASIO_HANDLER_LOCATION((__FILE__, __LINE__, "async_read")); stream_.async_read_some(buffers_.prepare(max_size), static_cast(*this)); } return; default: buffers_.consume(bytes_transferred); if ((!ec && bytes_transferred == 0) || buffers_.empty()) break; max_size = this->check_for_completion(ec, buffers_.total_consumed()); if (max_size == 0) break; if (this->cancelled() != cancellation_type::none) { ec = error::operation_aborted; break; } } static_cast(handler_)( static_cast(ec), static_cast(buffers_.total_consumed())); } } //private: typedef asio::detail::consuming_buffers buffers_type; AsyncReadStream& stream_; buffers_type buffers_; int start_; ReadHandler handler_; }; template inline bool asio_handler_is_continuation( read_op* this_handler) { return this_handler->start_ == 0 ? true : asio_handler_cont_helpers::is_continuation( this_handler->handler_); } template inline void start_read_op(AsyncReadStream& stream, const MutableBufferSequence& buffers, const MutableBufferIterator&, CompletionCondition& completion_condition, ReadHandler& handler) { read_op( stream, buffers, completion_condition, handler)( asio::error_code(), 0, 1); } template class initiate_async_read { public: typedef typename AsyncReadStream::executor_type executor_type; explicit initiate_async_read(AsyncReadStream& stream) : stream_(stream) { } executor_type get_executor() const noexcept { return stream_.get_executor(); } template void operator()(ReadHandler&& handler, const MutableBufferSequence& buffers, CompletionCondition&& completion_cond) const { // If you get an error on the following line it means that your handler // does not meet the documented type requirements for a ReadHandler. ASIO_READ_HANDLER_CHECK(ReadHandler, handler) type_check; non_const_lvalue handler2(handler); non_const_lvalue completion_cond2(completion_cond); start_read_op(stream_, buffers, asio::buffer_sequence_begin(buffers), completion_cond2.value, handler2.value); } private: AsyncReadStream& stream_; }; } // namespace detail #if !defined(GENERATING_DOCUMENTATION) template