[#2F3F0A15279B87862E26E0007F4493610FD53EA9]

<div id="2F3F0A15279B87862E26E0007F4493610FD53EA9">
    <div>
        <h2>Function <a href="#">url_base</a>::
set_encoded_host_name</h2>
        <p><span>Set the host to a name</span></p>


    </div>

    <div>
        <h3>Synopsis</h3>
        <div>
            <code>
                            </code>
        </div>
        <pre class="source-code cpp">
            url_base&
set_encoded_host_name(pct_string_view s);
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>The host is set to the specified string,</span> <span>which may contain percent-escapes and</span>
<span>can be empty.</span>
<span>Escapes in the string are preserved,</span>
<span>and reserved characters in the string</span>
<span>are percent-escaped in the result.</span>
<span>The host type is</span>
<span>host_type::name</span>
<span>.</span></p>

<h3>Example</h3>
<code>
assert( url( "http://www.example.com/index.htm").set_encoded_host_name( "localhost" ).host_address() == "localhost" );
</code>
<h3>Postconditions</h3>
<code>
this->has_authority() == true && this->host_ipv6_address() == addr && this->host_type() == host_type::name
</code>
<h3>Exception Safety</h3>
<p><span>Strong guarantee.</span>
<span>Calls to allocate may throw.</span>
<span>Exceptions thrown on invalid input.</span></p>

<h3>BNF</h3>
<code>
reg-name    = *( unreserved / pct-encoded / "-" / ".")
</code>
<h3>Specification</h3>
<li><a href="https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2">            3.2.2. Host (rfc3986)</a></li>

    </div>



</div>