| Home | Libraries | People | FAQ | More

##### basic_socket_acceptor::accept (12 of 16 overloads)

Accept a new connection.

    Protocol::socket::template rebind_executor< executor_type >::other accept(
        endpoint_type & peer_endpoint,
        boost::system::error_code & ec);

This function is used to accept a new connection from a peer. The function call will block until a new connection has been accepted successfully or an error occurs.

This overload requires that the Protocol template parameter satisfy the AcceptableProtocol type requirements.

###### Parameters

peer_endpoint

  An endpoint object into which the endpoint of the remote peer will be written.

ec

  Set to indicate what error occurred, if any.

###### Return Value

On success, a socket object representing the newly accepted connection. On error, a socket object where `is_open()` is false.

###### Example

    boost::asio::ip::tcp::acceptor acceptor(my_context);
    ...
    boost::asio::ip::tcp::endpoint endpoint;
    boost::asio::ip::tcp::socket socket(acceptor.accept(endpoint, ec));
    if (ec)
    {
      // An error occurred.
    }