Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext
basic_stream::read_some (1 of 2 overloads)

Read some data.

Synopsis
template<
    class MutableBufferSequence>
std::size_t
read_some(
    MutableBufferSequence const& buffers);
Description

This function is used to read some data from the stream. The call blocks until one of the following is true:

Parameters

Name

Description

buffers

The buffers into which the data will be read. If the size of the buffers is zero bytes, the call always returns immediately with no error.

Return Value

The number of bytes read.

Exceptions

Type

Thrown On

system_error

Thrown on failure.

Remarks

The read_some operation may not receive all of the requested number of bytes. Consider using the function net::read if you need to ensure that the requested amount of data is read before the blocking operation completes.


PrevUpHomeNext