[#56A0C45ED8D09B93DEC18B805B18E15699B6F8C6]

<div id="56A0C45ED8D09B93DEC18B805B18E15699B6F8C6">
    <div>
        <h2>Function <a href="#">static_url</a>::
set_path</h2>
        <p><span>Set the path.</span></p>


    </div>

    <div>
        <h3>Synopsis</h3>
        <div>
            <code>
                            </code>
        </div>
        <pre class="source-code cpp">
            static_url&
set_path(core::string_view s);
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>This function sets the path to the</span> <span>string, which may be empty.</span>
<span>Reserved characters in the string are</span>
<span>percent-escaped in the result.</span></p>

<div>
<h4>NOTE</h4>
<p><span>The library may adjust the final result</span>
<span>to ensure that no other parts of the url</span>
<span>is semantically affected.</span></p>

</div>
<div>
<h4>NOTE</h4>
<p><span>This function does not encode '/' chars, which</span>
<span>are unreserved for paths but reserved for</span>
<span>path segments. If a path segment should include</span>
<span>encoded '/'s to differentiate it from path separators,</span>
<span>the functions</span>
<span>set_encoded_path</span>
<span>or</span>
<span>segments</span>
<span>should be used instead.</span></p>

</div>
<h3>Example</h3>
<code>
url u( "http://www.example.com" );

u.set_path( "path/to/file.txt" );

assert( u.path() == "/path/to/file.txt" );
</code>
<h3>Complexity</h3>
<p><span>Linear in `this->size() + s.size()`.</span></p>

<h3>Exception Safety</h3>
<p><span>Strong guarantee.</span>
<span>Calls to allocate may throw.</span></p>

<h3>BNF</h3>
<code>
path          = path-abempty    ; begins with "/" or is empty
              / path-absolute   ; begins with "/" but not "//"
              / path-noscheme   ; begins with a non-colon segment
              / path-rootless   ; begins with a segment
              / path-empty      ; zero characters

path-abempty  = *( "/" segment )
path-absolute = "/" [ segment-nz *( "/" segment ) ]
path-noscheme = segment-nz-nc *( "/" segment )
path-rootless = segment-nz *( "/" segment )
path-empty    = 0<pchar>
</code>
<h3>Specification</h3>
<li><a href="https://datatracker.ietf.org/doc/html/rfc3986#section-3.3">3.3.  Path (rfc3986)</a></li>

    </div>



</div>