asio C++ library

PrevUpHomeNext

Range connect token requirements

A range connect token is a completion token for completion signature void(error_code, typename Protocol::endpoint), where the type Protocol is used in the corresponding async_connect() function.

Examples

A free function as a range connect token:

void connect_handler(
    const asio::error_code& ec,
    const asio::ip::tcp::endpoint& endpoint)
{
  ...
}

A range connect token function object:

struct connect_handler
{
  ...
  template <typename Range>
  void operator()(
      const asio::error_code& ec,
      const asio::ip::tcp::endpoint& endpoint)
  {
    ...
  }
  ...
};

A lambda as a range connect token:

asio::async_connect(...,
    [](const asio::error_code& ec,
      const asio::ip::tcp::endpoint& endpoint)
    {
      ...
    });

A non-static class member function adapted to a range connect token using std::bind():

void my_class::connect_handler(
    const asio::error_code& ec,
    const asio::ip::tcp::endpoint& endpoint)
{
  ...
}
...
asio::async_connect(...,
    std::bind(&my_class::connect_handler,
      this, std::placeholders::_1,
      std::placeholders::_2));

A non-static class member function adapted to a range connect token using boost::bind():

void my_class::connect_handler(
    const asio::error_code& ec,
    const asio::ip::tcp::endpoint& endpoint)
{
  ...
}
...
asio::async_connect(...,
    boost::bind(&my_class::connect_handler,
      this, asio::placeholders::error,
      asio::placeholders::endpoint));

Using use_future as a range connect token:

std::future<asio::ip::tcp::endpoint> f =
  asio::async_connect(..., asio::use_future);
...
try
{
  asio::ip::tcp::endpoint e = f.get();
  ...
}
catch (const system_error& e)
{
  ...
}

Using use_awaitable as a range connect token:

asio::awaitable<void> my_coroutine()
{
  try
  {
    ...
    asio::ip::tcp::endpoint e =
      co_await asio::async_connect(
          ..., asio::use_awaitable);
    ...
  }
  catch (const system_error& e)
  {
    ...
  }
}

PrevUpHomeNext