Boost C++ Libraries

Establishes a connection by trying each endpoint in a sequence.

template<
    class Iterator>
Iterator
connect(
    Iterator begin,
    Iterator end);

This function attempts to connect the stream to one of a sequence of endpoints by trying each endpoint until a connection is successfully established. The underlying socket is automatically opened if needed. An automatically opened socket is not returned to the closed state upon failure. The algorithm, known as a composed operation, is implemented in terms of calls to the underlying socket's connect function.

An iterator denoting the successfully connected endpoint.