boost::urls::url_base::set_encoded_user

Set the user

Synopsis

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

url_base&
set_encoded_user(pct_string_view s);

Description

This function sets the user part of the userinfo the the string, which may contain percent‐escapes. Escapes in the string are preserved, and reserved characters in the string are percent‐escaped in the result.

assert( url().set_encoded_user("john%20doe").userinfo() == "john doe" );

this->has_authority() == true && this->has_userinfo() == true

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

Strong guarantee.

Calls to allocate may throw.

userinfo      = [ [ user ] [ ':' password ] ]

user          = *( unreserved / pct-encoded / sub-delims )
password      = *( unreserved / pct-encoded / sub-delims / ":" )

3.2.1. User Information (rfc3986)

Exceptions

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

Parameters

Name	Description
s	The string to set&period;