| Home | Libraries | People | FAQ | More

##### url_view::password

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

- 3.2.1. User Information (rfc3986)

###### See Also

`has_password`, `has_userinfo`, `encoded_password`, `encoded_user`, `encoded_userinfo`, `user`, `userinfo`.