boost::urls::url_base::set_encoded_authority :: Boost Libraries Documentation

# boost::urls::url_base::set_encoded_authority

Set the authority

## Synopsis

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

    url_base&
    set_encoded_authority(pct_string_view s);

## Description

This function sets the authority to the specified string. The string may contain percent‐escapes.

## Example

    assert( url().set_encoded_authority( "My%20Computer" ).has_authority() );

## Exception Safety

Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.

## BNF

    authority     = [ userinfo "@" ] host [ ":" port ]

    userinfo      = *( unreserved / pct-encoded / sub-delims / ":" )
    host          = IP-literal / IPv4address / reg-name
    port          = *DIGIT

## Specification

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

## Exceptions

Name | Thrown on
`system_eror` | The string contains an invalid percent‐encoding.

## Return Value

`*this`

## Parameters

Name | Description
s | The authority string to set.

## See Also

`remove_authority`.

Created with MrDocs