...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Peek at the incoming data on the stream.
template< typename MutableBufferSequence> std::size_t peek( const MutableBufferSequence & buffers);
This function is used to peek at the incoming data on the stream, without removing it from the input queue. The function call will block until data has been read successfully or an error occurs.
The buffers into which the data will be read.
The number of bytes read.
Thrown on failure.