url::set_scheme (2 of 2 overloads)

Set the scheme.

url_base&
set_scheme(
    scheme id);

This function sets the scheme to the specified known urls::scheme id, which may not be scheme::unknown or else an exception is thrown. If the id is scheme::none, this function behaves as if remove_scheme were called.

assert( url( "http://example.com/echo.cgi" ).set_scheme( scheme::wss ).buffer() == "wss://example.com/echo.cgi" );

Linear in this->size().

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

Type	Thrown On
`system_error`	The scheme is invalid.

Name	Description
`id`	The scheme to set.