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