boost::urls::url_base::set_scheme_id

Set the scheme

Synopsis

Declared in <include/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.

  • 3.1. Scheme (rfc3986)

    • Exceptions

    Name Thrown on
    The

    scheme is invalid.

    Parameters

    Name Description
    id

    The scheme to set.

    Created with MrDocs