...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Set the host to a name.
url_base& set_encoded_host_name( pct_string_view s);
The host is set to the specified string, which may contain percent-escapes
and can be empty. Escapes in the string are preserved, and reserved characters
in the string are percent-escaped in the result. The host type is host_type::name
.
assert( url( "http://www.example.com/index.htm").set_encoded_host_name( "localhost" ).host_address() == "localhost" );
this->has_authority() == true && this->host_ipv6_address() == addr && this->host_type() == host_type::name
Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.
Type |
Thrown On |
---|---|
|
|
Name |
Description |
---|---|
|
The string to set. |
reg-name = *( unreserved / pct-encoded / "-" / ".")
set_encoded_host
, set_encoded_host_address
, set_host
,
set_host_address
, set_host_ipv4
, set_host_ipv6
, set_host_ipvfuture
, set_host_name
.