![]() |
Home | Libraries | People | FAQ | More |
(Deprecated) Starts a text query as a multi-function operation.
template< class CompletionToken> auto async_start_query( string_view query_string, execution_state& st, diagnostics& diag, CompletionToken&& token);
Writes the query request and reads the initial server response and the
column metadata, but not the generated rows or subsequent resultsets,
if any. After this operation completes, st
will have execution_state::meta
populated. Metadata will
be populated according to this->meta_mode()
.
If the operation generated any rows or more than one resultset, these
must be read (by using read_some_rows
and read_resultset_head
) before
engaging in any further network operation. Otherwise, the results are
undefined.
query_string
should be
encoded using the connection's character set.
This function is only provided for backwards-compatibility. For new code,
please use start_execution
or async_start_execution
instead.
If CompletionToken
is
a deferred completion token (e.g. use_awaitable
),
the string pointed to by query_string
must be kept alive by the caller until the operation is initiated.
The handler signature for this operation is void(boost::mysql::error_code)
.