Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
connection::async_read_some_rows (1 of 2 overloads)

Reads a batch of rows.

Synopsis
template<
    class CompletionToken>
auto
async_read_some_rows(
    execution_state& st,
    CompletionToken&& token);
Description

The number of rows that will be read is unspecified. If the resultset being read has still rows to read, at least one will be read. If there are no more rows to be read, returns an empty rows_view.

The number of rows that will be read depends on the input buffer size. The bigger the buffer, the greater the batch size (up to a maximum). You can set the initial buffer size in connection's constructor, using buffer_params::initial_read_size. 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.

Handler signature

The handler signature for this operation is void(boost::mysql::error_code, boost::mysql::rows_view).


PrevUpHomeNext