Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

any_connection::async_close (2 of 2 overloads)

Cleanly closes the connection to the server.

Synopsis

template<
    class CompletionToken>
auto
async_close(
    diagnostics& diag,
    CompletionToken&& token);

Description

This function does the following:

Sends a quit request. This is required by the MySQL protocol, to inform the server that we're closing the connection gracefully.
If the connection is using TLS (this->uses_ssl() == true), performs the TLS shutdown.
Closes the transport-level connection (the TCP or UNIX socket).

Since this function involves writing a message to the server, it can fail. Only use this function if you know that the connection is healthy and you want to cleanly close it.

If you don't call this function, the destructor or successive connects will perform a transport-layer close. This doesn't cause any resource leaks, but may cause warnings to be written to the server logs.

Handler signature

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