boost::urls::url_base::set_scheme_id

Set the scheme

Synopsis

Declared in <boost/url/url_base.hpp>

url_base&
set_scheme_id(urls::scheme id);

Description

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_id( scheme::wss ).buffer() == "wss://example.com/echo.cgi" );

Linear in this->size().

Strong guarantee.

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

Exceptions

Name Thrown on

The

scheme is invalid.

Parameters

Name Description

id

The scheme to set.

Created with MrDocs