Return the user.

Synopsis

template<
    class StringToken = string_token::return_string>
StringToken::result_type
user(
    StringToken&& token = {}) const;

Description

If present, this function returns a string representing the user (which may be empty). Otherwise it returns an empty string. Any percent-escapes in the string are decoded first.

Example

assert( url_view( "http://jane%2Ddoe:pass@example.com" ).user() == "jane-doe" );

Complexity

Linear in this->user().size().

Exception Safety

Calls to allocate may throw.

BNF

userinfo    = user [ ":" [ password ] ]

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

Specification

See Also

has_password, has_userinfo, encoded_password, encoded_user, encoded_userinfo, password, userinfo.