[#5918EC3CB93F9B17C45545FF345AB66DAAAE4405]

<div id="5918EC3CB93F9B17C45545FF345AB66DAAAE4405">
    <div>
        <h2>Function format</h2>
        <p><span>Format arguments into a URL</span></p>


    </div>

    <div>
        <h3>Synopsis</h3>
        <div>
            <code>
                            </code>
        </div>
        <pre class="source-code cpp">
            template<class... Args>
url
format(
    core::string_view fmt,
    Args&&... args);
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>Format arguments according to the format</span> <span>URL string into a</span>
<span>url</span>
<span>.</span></p>

<p><span>The rules for a format URL string are the same</span>
<span>as for a `std::format_string`, where replacement</span>
<span>fields are delimited by curly braces.</span></p>

<p><span>The URL components to which replacement fields</span>
<span>belong are identified before replacement is</span>
<span>applied and any invalid characters for that</span>
<span>formatted argument are percent-escaped.</span></p>

<p><span>Hence, the delimiters between URL components,</span>
<span>such as `:`, `//`, `?`, and `#`, should be</span>
<span>included in the URL format string. Likewise,</span>
<span>a format string with a single `"{}"` is</span>
<span>interpreted as a path and any replacement</span>
<span>characters invalid in this component will be</span>
<span>encoded to form a valid URL.</span></p>

<h3>Example</h3>
<code>
assert(format("{}", "Hello world!").buffer() == "Hello%20world%21");
</code>
<h3>Preconditions</h3>
<p><span>All replacement fields must be valid and the</span>
<span>resulting URL should be valid after arguments</span>
<span>are formatted into the URL.</span></p>

<p><span>Because any invalid characters for a URL</span>
<span>component are encoded by this function, only</span>
<span>replacements in the scheme and port components</span>
<span>might be invalid, as these components do not</span>
<span>allow percent-encoding of arbitrary</span>
<span>characters.</span></p>

<h3>BNF</h3>
<code>
replacement_field ::=  "{" [arg_id] [":" (format_spec | chrono_format_spec)] "}"
arg_id            ::=  integer | identifier
integer           ::=  digit+
digit             ::=  "0"..."9"
identifier        ::=  id_start id_continue*
id_start          ::=  "a"..."z" | "A"..."Z" | "_"
id_continue       ::=  id_start | digit
</code>
<h3>Specification</h3>
<li><a href="https://fmt.dev/latest/syntax.html">Format String Syntax</a></li>

    </div>



</div>