boost::urls::url::url

Constructor

Synopsis

Declared in <boost/url/url.hpp>
explicit
url(core::string_view s);

Description

This function constructs a URL from the string s, which must contain a valid URI or relative-ref or else an exception is thrown. The new url retains ownership by allocating a copy of the passed string.

Example


url u( "https://www.example.com" );

Effects


return url( parse_uri_reference( s ).value() );

Postconditions


this->buffer().data() != s.data()

Complexity

Linear in s.size().

Exception Safety

Calls to allocate may throw. Exceptions thrown on invalid input.

BNF


URI           = scheme ":" hier-part [ "?" query ] [ "#" fragment ]

relative-ref  = relative-part [ "?" query ] [ "#" fragment ]

Specification

Exceptions

Name Thrown on
system_error The input does not contain a valid url.

Parameters

Name Description
s The string to parse.