Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
connection::async_query (2 of 2 overloads)

Executes a SQL text query.

Synopsis
template<
    class CompletionToken>
auto
async_query(
    string_view query_string,
    results& result,
    diagnostics& diag,
    CompletionToken&& token);
Description

Sends query_string to the server for execution and reads the response into result. query_string should be encoded using the connection's character set.

After this operation completes successfully, result.has_value() == true.

Metadata in result will be populated according to this->meta_mode().

Security

If you compose query_string by concatenating strings manually, your code is vulnerable to SQL injection attacks. If your query contains patameters unknown at compile time, use prepared statements instead of this function.

Object lifetimes

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.

Handler signature

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


PrevUpHomeNext