Set the fragment.

Synopsis

Declared in <boost/url/url.hpp>

url&
set_fragment(core::string_view s);

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

Return Value

*this

Parameters

Name

Description

s

The string to set.

See Also

remove_fragment, set_encoded_fragment.

Created with MrDocs