Устанавливает соединение сокетов, пробуя каждую конечную точку в последовательности.
template<
typename Protocol,
typename SocketService,
typename Iterator,
typename ConnectCondition>
Iterator connect(
basic_socket< Protocol, SocketService > & s,
Iterator begin,
Iterator end,
ConnectCondition connect_condition,
boost::system::error_code & ec);
Эта функция пытается подключить сокет к одной из последовательности конечных точек. Он делает это путем повторных вызовов функции элемента сокета<connect
>, один раз для каждой конечной точки в последовательности, пока соединение не будет успешно установлено.
- s
Сокет должен быть подключен. Если розетка уже открыта, она будет закрыта.
- begin
Итератор, указывающий на начало последовательности конечных точек.
- end
Итератор, указывающий на конец последовательности конечных точек.
- connect_condition
-
Объект функции, который называется перед каждой попыткой соединения. Подпись объекта функции должна быть:
Iterator connect_condition(
const boost::system::error_code& ec,
Iterator next);
Параметр<ec
>содержит результат самой последней операции соединения. Перед первой попыткой соединения<ec
>всегда указывает на успех. Параметр<next
>— это итератор, указывающий на следующую конечную точку, которую нужно опробовать. Объект функции должен вернуть следующий итератор, но ему разрешено вернуть другой итератор, чтобы конечные точки могли быть пропущены. Реализация гарантирует, что объект функции никогда не будет называться конечным итератором.
- ec
Установить, какая ошибка произошла, если таковая имеется. Если последовательность пуста, установите<boost::asio::error::not_found
>. В противном случае, содержит ошибку с последней попытки соединения.
В случае успеха итератор обозначает успешно подключенную конечную точку. В противном случае - конечный итератор.
Для вывода информации об отдельных попытках соединения может использоваться следующий объект функции состояния соединения:
struct my_connect_condition
{
template <typename Iterator>
Iterator operator()(
const boost::system::error_code& ec,
Iterator next)
{
if (ec) std::cout << "Error: " << ec.message() << std::endl;
std::cout << "Trying: " << next->endpoint() << std::endl;
return next;
}
};
Используется функция<boost::asio::connect
>:
tcp::resolver r(io_service);
tcp::resolver::query q("host", "service");
tcp::resolver::iterator i = r.resolve(q), end;
tcp::socket s(io_service);
boost::system::error_code ec;
i = boost::asio::connect(s, i, end, my_connect_condition(), ec);
if (ec)
{
}
else
{
std::cout << "Connected to: " << i->endpoint() << std::endl;
}