Boost C++ Libraries

Executes a prepared statement.

Synopsis

template<
    class FieldLikeTuple,
    class CompletionToken,
    class EnableIf = detail::enable_if_field_like_tuple<FieldLikeTuple>>
auto
async_execute_statement(
    const statement& stmt,
    FieldLikeTuple&& params,
    results& result,
    diagnostics& diag,
    CompletionToken&& token);

Description

Executes a statement with the given parameters and reads the response into result.

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

The statement actual parameters (params) are passed as a std::tuple of elements. See the FieldLikeTuple concept defition for more info. You should pass exactly as many parameters as this->num_params(), or the operation will fail with an error. String parameters should be encoded using the connection's character set.

Metadata in result will be populated according to conn.meta_mode(), where conn is the connection that prepared this statement.

Preconditions

stmt.valid() == true

Object lifetimes

If CompletionToken is deferred (like use_awaitable), and params contains any reference type (like string_view), the caller must keep the values pointed by these references alive until the operation is initiated. Value types will be copied/moved as required, so don't need to be kept alive. It's not required to keep stmt alive, either.

Handler signature

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