Add an overload for resolve that takes host and service separately

[libs/net.git] / source / resolve.h

diff --git a/source/resolve.h b/source/resolve.h
index 0afc9adb78257c5a67c640e4665d5cae29f38995..256455fcb18febb08384fd7e6f50e17d35064310 100644 (file)
--- a/source/resolve.h
+++ b/source/resolve.h
@@ -9,6 +9,15 @@ namespace Net {
 
 class SockAddr;
 
+/** Resolves host and service names into a socket address.  If host is empty,
+the loopback address will be used.  If host is "*", the wildcard address will
+be used.  If service is empty, a socket address with a null service will be
+returned.  With the IP families, these are not very useful. */
+SockAddr *resolve(const std::string &, const std::string &, Family = UNSPEC);
+
+/** And overload of resolve() that takes host and service as a single string,
+separated by a colon.  If the host part contains colons, such as is the case
+with a numeric IPv6 address, it must be enclosed in brackets. */
 SockAddr *resolve(const std::string &, Family = UNSPEC);
 
 } // namespace Net