Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
static_url_base::set_encoded_authority

(Inherited from url_base)

Set the authority.

Synopsis
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( [link url.ref.boost__urls__url_base.url `url`]().[link url.ref.boost__urls__static_url_base.set_encoded_authority `set_encoded_authority`]( "My%20Computer" ).[link url.ref.boost__urls__static_url_base.has_authority `has_authority`]() );
Exception Safety

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

Exceptions

Type

Thrown On

system_eror

The string contains an invalid percent-encoding.

Parameters

Name

Description

s

The authority string to set.

BNF
[link url.ref.boost__urls__static_url_base.authority `authority`]     = [ [link url.ref.boost__urls__static_url_base.userinfo `userinfo`] "@" ] [link url.ref.boost__urls__static_url_base.host `host`] [ ":" [link url.ref.boost__urls__static_url_base.port `port`] ]

[link url.ref.boost__urls__static_url_base.userinfo `userinfo`]      = *( unreserved / pct-encoded / sub-delims / ":" )
[link url.ref.boost__urls__static_url_base.host `host`]          = IP-literal / IPv4address / reg-[link url.ref.boost__urls__host_type `name`]
[link url.ref.boost__urls__static_url_base.port `port`]          = *DIGIT
Specification
See Also

remove_authority.


PrevUpHomeNext