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
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
Establishes a connection by trying each endpoint in a sequence.
template< class Iterator> Iterator connect( Iterator begin, Iterator end, error_code& ec);
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.
|
Name |
Description |
|---|---|
|
|
An iterator pointing to the start of a sequence of endpoints. |
|
|
An iterator pointing to the end of a sequence of endpoints. |
|
|
Set to indicate what error occurred, if any. If the sequence is empty, set to boost::asio::error::not_found. Otherwise, contains the error from the last connection attempt. |
On success, an iterator denoting the successfully connected endpoint. Otherwise, the end iterator.