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.