boost::urls::url::remove_password :: Boost Libraries Documentation

# boost::urls::url::remove_password

Remove the password

## Synopsis

Declared in `<boost/url/url.hpp>`

    url&
    remove_password() noexcept;

## Description

This function removes the password from the userinfo if a password exists. If there is no userinfo or no authority, the call has no effect.

| The interpretation of the userinfo as individual user and password components is scheme‐dependent. Transmitting passwords in URLs is deprecated.

## Example

    assert( url( "http://user:pass@example.com" ).remove_password().authority().buffer() == "user@example.com" );

## Postconditions

    this->has_password() == false && this->encoded_password().empty() == true

## Complexity

Linear in `this‐>size()`.

## Exception Safety

Throws nothing.

## BNF

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

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

## Specification

- https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.1

## Return Value

`*this`

## See Also

`set_encoded_password`, `set_encoded_user`, `set_password`, `set_user`.

Created with MrDocs