set_fragment

Set the fragment.

Synopsis


                url_base&
set_fragment(
    string_view s);

Declared in file <src/url_base.cpp> at line 1481

Description

This function sets the fragment to the specified string, which may be empty. An empty fragment is distinct from having no fragment. Reserved characters in the string are percent-escaped in the result.

Example


assert( url("?first=john&last=doe" ).set_encoded_fragment( "john doe" ).encoded_fragment() == "john%20doe" );

Postconditions


this->has_fragment() == true && this->fragment() == s

Complexity

Linear in `this->size() + s.size()`.

Exception Safety

Strong guarantee. Calls to allocate may throw.

BNF


fragment    = *( pchar / "/" / "?" )

Specification

3.5. Fragment