[#boost-urls-parse_absolute_uri] = xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::parse_absolute_uri :relfileprefix: ../../ :mrdocs: Return a reference to a parsed URL string == Synopsis Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/parse.hpp#L65[boost/url/parse.hpp]>` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- system::result<xref:boost/urls/url_view.adoc[url_view]> parse_absolute_uri(core::string_view s); ---- == Description This function parses a string according to the grammar below and returns a view referencing the passed string upon success, else returns an error. Ownership of the string is not transferred; the caller is responsible for ensuring that the lifetime of the character buffer extends until the view is no longer being accessed. === Example [,cpp] ---- system::result< url_view > rv = parse_absolute_uri( "http://example.com/index.htm?id=1" ); ---- === BNF [,cpp] ---- absolute-URI = scheme ":" hier-part [ "?" query ] hier-part = "//" authority path-abempty / path-absolute / path-rootless / path-empty ---- === Specification * link:https://datatracker.ietf.org/doc/html/rfc3986#section-4.3[4.3. Absolute URI (rfc3986)] == Exceptions |=== | Name | Thrown on | `std::length_error` | `s.size() > url_view::max_size` |=== == Return Value A result containing a value or an error == Parameters |=== | Name | Description | *s* | The string to parse |=== == See Also xref:boost/urls/parse_origin_form.adoc[parse_origin_form], xref:boost/urls/parse_relative_ref.adoc[parse_relative_ref], xref:boost/urls/parse_uri.adoc[parse_uri], xref:boost/urls/parse_uri_reference.adoc[parse_uri_reference], xref:boost/urls/url_view.adoc[url_view]. [.small]#Created with https://www.mrdocs.com[MrDocs]#