Return the password.

Synopsis

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

Description

If present, this function returns a string representing the password (which may be an empty string). 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" ).password() == "pass" );

Complexity

Linear in this->password().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, user, userinfo.