boost::urls::url_base::set_encoded_fragment

Set the fragment.

Synopsis

Declared in <include/boost/url/url_base.hpp>

url_base&
set_encoded_fragment(pct_string_view s);

Description

This function sets the fragment to the specified string, which may contain percent‐escapes and which may be empty. An empty fragment is distinct from having no fragment. Escapes in the string are preserved, and reserved characters in the string are percent‐escaped in the result.

assert( url("?first=john&last=doe" ).set_encoded_fragment( "john%2Ddoe" ).fragment() == "john-doe" );

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

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

Strong guarantee.

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

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

3.5. Fragment

Exceptions

Name	Thrown on
`s`	contains an invalid percent&hyphen;encoding&period;

Parameters

Name	Description
s	The string to set&period;