...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Reads a batch of rows.
template< class CompletionToken> auto async_read_some_rows( execution_state& st, CompletionToken&& token);
The number of rows that will be read is unspecified. If the operation
represented by st
has
still rows to read, at least one will be read. If there are no more rows,
or st.should_read_rows()
== false
,
returns an empty rows_view
.
The number of rows that will be read depends on the connection's buffer size. The bigger the buffer, the greater the batch size (up to a maximum). You can set the initial buffer size in the constructor. The buffer may be grown bigger by other read operations, if required.
The returned view points into memory owned by *this
. It will be valid until *this
performs the next network operation or is destroyed.
The handler signature for this operation is void(boost::mysql::error_code, boost::mysql::rows_view)
.