diff --git a/include/boost/url/url.hpp b/include/boost/url/url.hpp index f4d38e54e..975fb735c 100644 --- a/include/boost/url/url.hpp +++ b/include/boost/url/url.hpp @@ -322,99 +322,6 @@ class BOOST_SYMBOL_VISIBLE url //---------------------------------------------------------- -/** Resolve a URL reference against a base URL - - This function attempts to resolve a URL - reference `ref` against the base URL `base` - in a manner similar to that of a web browser - resolving an anchor tag. The base URL - must satisfy the absolute-URI - grammar. - - Relative references are only usable when - in the context of a base absolute URI. - This process of resolving a relative - reference within the context of - a base URI is defined in detail - in rfc3986 (see below). - - The resolution process works as if the - relative reference is appended to the base - URI and the result is normalized. - - Given the input base URL, this function - resolves the relative reference - as if performing the following steps: - - @li Ensure the base URI has at least a scheme - @li Normalizing the reference path - @li Merge base and reference paths - @li Normalize the merged path - - This function places the result of the - resolution into `dest`, which can be - any of the url containers that inherit - from @ref url_base. - - If an error occurs, the contents of - `dest` is unspecified and `ec` is set. - - @par Example - @code - url dest; - error_code ec; - - resolve("/one/two/three", "four", dest, ec); - assert( dest.str() == "/one/two/four" ); - - resolve("http://example.com/", "/one", dest, ec); - assert( dest.str() == "http://example.com/one" ); - - resolve("http://example.com/one", "/two", dest, ec); - assert( dest.str() == "http://example.com/two" ); - - resolve("http://a/b/c/d;p?q", "g#s", dest, ec); - assert( dest.str() == "http://a/b/c/g#s" ); - @endcode - - @par BNF - @code - absolute-URI = scheme ":" hier-part [ "?" query ] - @endcode - - @par Exception Safety - Basic guarantee. - Calls to allocate may throw. - - @return Error if any occurred - - @param base The base URL to resolve against. - - @param ref The URL reference to resolve. - - @param dest The container where the result - is written, upon success. - - @par Specification - 5. Reference Resolution (rfc3986) - - @see - @ref url, - @ref url_view. -*/ -inline -result -resolve( - url_view_base const& base, - url_view_base const& ref, - url_base& dest) -{ - BOOST_ASSERT(&dest != &base); - BOOST_ASSERT(&dest != &ref); - return dest.resolve_impl(base, ref); -} - /** Compares two absolute paths and make one relative to the other This function compares the absolute paths in