Provides endpoint resolution functionality. More...
#include <basic_resolver.hpp>
Public Types | |
typedef InternetProtocol | protocol_type |
The protocol type. More... | |
typedef InternetProtocol::endpoint | endpoint_type |
The endpoint type. More... | |
typedef basic_resolver_query < InternetProtocol > | query |
The query type. More... | |
typedef basic_resolver_iterator < InternetProtocol > | iterator |
The iterator type. More... | |
typedef ResolverService | service_type |
The type of the service that will be used to provide I/O operations. More... | |
typedef service_type::implementation_type | implementation_type |
The underlying implementation type of I/O object. More... | |
Public Member Functions | |
basic_resolver (boost::asio::io_service &io_service) | |
Constructor. More... | |
void | cancel () |
Cancel any asynchronous operations that are waiting on the resolver. More... | |
iterator | resolve (const query &q) |
Perform forward resolution of a query to a list of entries. More... | |
iterator | resolve (const query &q, boost::system::error_code &ec) |
Perform forward resolution of a query to a list of entries. More... | |
template<typename ResolveHandler > | |
BOOST_ASIO_INITFN_RESULT_TYPE (ResolveHandler, void(boost::system::error_code, iterator)) async_resolve(const query &q | |
Asynchronously perform forward resolution of a query to a list of entries. More... | |
BOOST_ASIO_MOVE_ARG (ResolveHandler) handler) | |
iterator | resolve (const endpoint_type &e) |
Perform reverse resolution of an endpoint to a list of entries. More... | |
iterator | resolve (const endpoint_type &e, boost::system::error_code &ec) |
Perform reverse resolution of an endpoint to a list of entries. More... | |
template<typename ResolveHandler > | |
BOOST_ASIO_INITFN_RESULT_TYPE (ResolveHandler, void(boost::system::error_code, iterator)) async_resolve(const endpoint_type &e | |
Asynchronously perform reverse resolution of an endpoint to a list of entries. More... | |
BOOST_ASIO_MOVE_ARG (ResolveHandler) handler) | |
boost::asio::io_service & | get_io_service () |
Get the io_service associated with the object. More... | |
Protected Member Functions | |
service_type & | get_service () |
Get the service associated with the I/O object. More... | |
const service_type & | get_service () const |
Get the service associated with the I/O object. More... | |
implementation_type & | get_implementation () |
Get the underlying implementation of the I/O object. More... | |
const implementation_type & | get_implementation () const |
Get the underlying implementation of the I/O object. More... | |
Protected Attributes | |
service_type & | service |
(Deprecated: Use get_service().) The service associated with the I/O object. More... | |
implementation_type | implementation |
(Deprecated: Use get_implementation().) The underlying implementation of the I/O object. More... | |
Provides endpoint resolution functionality.
The basic_resolver class template provides the ability to resolve a query to a list of endpoints.
typedef InternetProtocol::endpoint boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::endpoint_type |
The endpoint type.
|
inherited |
The underlying implementation type of I/O object.
typedef basic_resolver_iterator<InternetProtocol> boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::iterator |
The iterator type.
typedef InternetProtocol boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::protocol_type |
The protocol type.
typedef basic_resolver_query<InternetProtocol> boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::query |
The query type.
|
inherited |
The type of the service that will be used to provide I/O operations.
|
inlineexplicit |
Constructor.
This constructor creates a basic_resolver.
io_service | The io_service object that the resolver will use to dispatch handlers for any asynchronous operations performed on the timer. |
boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::BOOST_ASIO_INITFN_RESULT_TYPE | ( | ResolveHandler | , |
void(boost::system::error_code, iterator) | |||
) | const |
Asynchronously perform forward resolution of a query to a list of entries.
This function is used to asynchronously resolve a query into a list of endpoint entries.
q | A query object that determines what endpoints will be returned. |
handler | The handler to be called when the resolve operation completes. Copies will be made of the handler as required. The function signature of the handler must be: void handler(
resolver::iterator iterator // Forward-only iterator that can
// be used to traverse the list
// of endpoint entries.
);
|
A successful resolve operation is guaranteed to pass at least one entry to the handler.
boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::BOOST_ASIO_INITFN_RESULT_TYPE | ( | ResolveHandler | , |
void(boost::system::error_code, iterator) | |||
) | const |
Asynchronously perform reverse resolution of an endpoint to a list of entries.
This function is used to asynchronously resolve an endpoint into a list of endpoint entries.
e | An endpoint object that determines what endpoints will be returned. |
handler | The handler to be called when the resolve operation completes. Copies will be made of the handler as required. The function signature of the handler must be: void handler(
resolver::iterator iterator // Forward-only iterator that can
// be used to traverse the list
// of endpoint entries.
);
|
A successful resolve operation is guaranteed to pass at least one entry to the handler.
|
inline |
|
inline |
|
inline |
Cancel any asynchronous operations that are waiting on the resolver.
This function forces the completion of any pending asynchronous operations on the host resolver. The handler for each cancelled operation will be invoked with the boost::asio::error::operation_aborted error code.
References boost::asio::basic_io_object< ResolverService >::implementation, and boost::asio::basic_io_object< ResolverService >::service.
|
inlineprotectedinherited |
Get the underlying implementation of the I/O object.
|
inlineprotectedinherited |
Get the underlying implementation of the I/O object.
|
inlineinherited |
Get the io_service associated with the object.
This function may be used to obtain the io_service object that the I/O object uses to dispatch handlers for asynchronous operations.
|
inlineprotectedinherited |
Get the service associated with the I/O object.
|
inlineprotectedinherited |
Get the service associated with the I/O object.
|
inline |
Perform forward resolution of a query to a list of entries.
This function is used to resolve a query into a list of endpoint entries.
q | A query object that determines what endpoints will be returned. |
boost::system::system_error | Thrown on failure. |
A successful call to this function is guaranteed to return at least one entry.
References boost::multiprecision::backends::i, boost::asio::basic_io_object< ResolverService >::implementation, and boost::asio::basic_io_object< ResolverService >::service.
|
inline |
Perform forward resolution of a query to a list of entries.
This function is used to resolve a query into a list of endpoint entries.
q | A query object that determines what endpoints will be returned. |
ec | Set to indicate what error occurred, if any. |
A successful call to this function is guaranteed to return at least one entry.
References boost::asio::basic_io_object< ResolverService >::implementation, and boost::asio::basic_io_object< ResolverService >::service.
|
inline |
Perform reverse resolution of an endpoint to a list of entries.
This function is used to resolve an endpoint into a list of endpoint entries.
e | An endpoint object that determines what endpoints will be returned. |
boost::system::system_error | Thrown on failure. |
A successful call to this function is guaranteed to return at least one entry.
References boost::multiprecision::backends::i, boost::asio::basic_io_object< ResolverService >::implementation, and boost::asio::basic_io_object< ResolverService >::service.
|
inline |
Perform reverse resolution of an endpoint to a list of entries.
This function is used to resolve an endpoint into a list of endpoint entries.
e | An endpoint object that determines what endpoints will be returned. |
ec | Set to indicate what error occurred, if any. |
A successful call to this function is guaranteed to return at least one entry.
References boost::asio::basic_io_object< ResolverService >::implementation, and boost::asio::basic_io_object< ResolverService >::service.
|
protectedinherited |
(Deprecated: Use get_implementation().) The underlying implementation of the I/O object.
Referenced by boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::BOOST_ASIO_MOVE_ARG(), boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::cancel(), and boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::resolve().
|
protectedinherited |
(Deprecated: Use get_service().) The service associated with the I/O object.
Referenced by boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::BOOST_ASIO_MOVE_ARG(), boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::cancel(), and boost::asio::ip::basic_resolver< InternetProtocol, ResolverService >::resolve().