Boost C++ Libraries

Closes a statement, deallocating it from the server.

Synopsis

template<
    class CompletionToken>
auto
async_close_statement(
    const statement& stmt,
    CompletionToken&& token);

Description

After this operation succeeds, stmt must not be used again for execution.

Performance warning

This function is currently affected by a peformance issue described in https://github.com/boostorg/mysql/issues/181. Consider using reset_connection or async_reset_connection instead.

Preconditions

stmt.valid() == true

Object lifetimes

It is not required to keep stmt alive, as copies are made by the implementation as required.

Handler signature

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