20 Socket algorithms [socket.algo]

20.1 Synchronous connect operations [socket.algo.connect]

template<class Protocol, class EndpointSequence> typename Protocol::endpoint connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints); template<class Protocol, class EndpointSequence> typename Protocol::endpoint connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints, error_code& ec);

1

Returns: connect(s, endpoints, [](auto, auto){ return true; }, ec).

template<class Protocol, class EndpointSequence, class ConnectCondition> typename Protocol::endpoint connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints, ConnectCondition c); template<class Protocol, class EndpointSequence, class ConnectCondition> typename Protocol::endpoint connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints, ConnectCondition c, error_code& ec);

2

Effects: Performs ec.clear(), then finds the first element ep in the sequence endpoints for which:

  • (2.1)

    c(ec, ep) yields true;

  • (2.2)

    s.close(ec) succeeds;

  • (2.3)

    s.open(ep.protocol(), ec) succeeds; and

  • (2.4)

    s.connect(ep, ec) succeeds.

3

Returns: typename Protocol::endpoint() if no such element is found, otherwise ep.

4

Error conditions:

  • (4.1)

    socket_errc::not_found — if endpoints.empty() or if the function object c returned false for all elements in the sequence.

template<class Protocol, class InputIterator> InputIterator connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last); template<class Protocol, class InputIterator> InputIterator connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last, error_code& ec);

5

Returns: connect(s, first, last, [](auto, auto){ return true; }, ec).

template<class Protocol, class InputIterator, class ConnectCondition> InputIterator connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last, ConnectCondition c); template<class Protocol, class InputIterator, class ConnectCondition> InputIterator connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last, ConnectCondition c, error_code& ec);

6

Effects: Performs ec.clear(), then finds the first iterator i in the range [first, last) for which:

  • (6.1)

    c(ec, *i) yields true;

  • (6.2)

    s.close(ec) succeeds;

  • (6.3)

    s.open(typename Protocol::endpoint(*i).protocol(), ec) succeeds; and

  • (6.4)

    s.connect(*i, ec) succeeds.

7

Returns: last if no such iterator is found, otherwise i.

8

Error conditions:

  • (8.1)

    socket_errc::not_found — if first == last or if the function object c returned false for all iterators in the range.

20.2 Asynchronous connect operations [socket.algo.async.connect]

template<class Protocol, class EndpointSequence, class CompletionToken> DEDUCED async_connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints, CompletionToken&& token);

1

Returns: 

async_connect(s, endpoints, [](auto, auto){ return true; }, forward<CompletionToken>(token))

template<class Protocol, class EndpointSequence, class ConnectCondition, class CompletionToken> DEDUCED async_connect(basic_socket<Protocol>& s, const EndpointSequence& endpoints, ConnectCondition c, CompletionToken&& token);

2

A composed asynchronous operation ([async.reqmts.async.composed]).

3

Completion signature: void(error_code ec, typename Protocol::endpoint ep).

4

Effects: Performs ec.clear(), then finds the first element ep in the sequence endpoints for which:

  • (4.1)

    c(ec, ep) yields true;

  • (4.2)

    s.close(ec) succeeds;

  • (4.3)

    s.open(ep.protocol(), ec) succeeds; and

  • (4.4)

    the asynchronous operation s.async_connect(ep, unspecified) succeeds.

5

ec is updated with the result of the s.async_connect(ep, unspecified) operation, if any. If no such element is found, or if the operation fails with one of the error conditions listed below, ep is set to typename Protocol::endpoint(). [ Note: The underlying close, open, and async_connect operations are performed sequentially.  — end note ]

6

Error conditions:

  • (6.1)

    socket_errc::not_found — if endpoints.empty() or if the function object c returned false for all elements in the sequence.

  • (6.2)

    errc::operation_canceled — if s.is_open() == false immediately following an async_connect operation on the underlying socket.

template<class Protocol, class InputIterator, class CompletionToken> DEDUCED async_connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last, CompletionToken&& token);

7

Returns: 

async_connect(s, first, last, [](auto, auto){ return true; },
              forward<CompletionToken>(token))

template<class Protocol, class InputIterator, class ConnectCondition, class CompletionToken> DEDUCED async_connect(basic_socket<Protocol>& s, InputIterator first, InputIterator last, ConnectCondition c, CompletionToken&& token);

8

A composed asynchronous operation ([async.reqmts.async.composed]).

9

Completion signature: void(error_code ec, InputIterator i).

10

Effects: Performs ec.clear(), then finds the first iterator i in the range [first, last) for which:

  • (10.1)

    c(ec, *i) yields true;

  • (10.2)

    s.close(ec) succeeds;

  • (10.3)

    s.open(typename Protocol::endpoint(*i).protocol(), ec) succeeds; and

  • (10.4)

    the asynchronous operation s.async_connect(*i, unspecified) succeeds.

11

ec is updated with the result of the s.async_connect(*i, unspecified) operation, if any. If no such iterator is found, or if the operation fails with one of the error conditions listed below, i is set to last. [ Note: The underlying close, open, and async_connect operations are performed sequentially.  — end note ]

12

Error conditions:

  • (12.1)

    socket_errc::not_found — if first == last or if the function object c returned false for all iterators in the range.

  • (12.2)

    errc::operation_canceled — if s.is_open() == false immediately following an async_connect operation on the underlying socket.