![]() |
Home | Libraries | People | FAQ | More |
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, if any. After this operation
completes, st will have
execution_state::meta populated, and may become
execution_state::complete if the operation did
not generate any rows (e.g. it was an UPDATE).
Metadata will be populated according to this->meta_mode().
If the operation generated any rows, these must
be read (by using read_some_rows) before engaging
in any further network operation. Otherwise, the results are undefined.
query_stringshould be
encoded using the connection's character set.
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).