[#597D1609A744B1E6A5513DBF516311A2127CDC0F]

<div id="597D1609A744B1E6A5513DBF516311A2127CDC0F">
    <div>
        <h2>Function <a href="#">url</a>::
set_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&
set_host_name(core::string_view s);
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>The host is set to the specified string,</span> <span>which may be empty.</span>
<span>Reserved characters in the string are</span>
<span>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_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></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>