| Home | Libraries | People | FAQ | More

###### basic_stream::read_some (1 of 2 overloads)

Read some data.

<h7> Synopsis </h7>

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

<h7> Description </h7>

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

- One or more bytes are read from the stream.
- An error occurs.

<h7> Parameters </h7>

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.

<h7> Return Value </h7>

The number of bytes read.

<h7> Exceptions </h7>

Type | Thrown On
--- | ---
`system_error` | Thrown on failure.

<h7> Remarks </h7>

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.