[#1068E13A463520DAE9CDE4043554506F69F09B1F]

<div id="1068E13A463520DAE9CDE4043554506F69F09B1F">
    <div>
        <h2>Function <a href="#">params_ref</a>::
set</h2>
        <p><span>Set a value</span></p>


    </div>

    <div>
        <h3>Synopsis</h3>
        <div>
            <code>
                            </code>
        </div>
        <pre class="source-code cpp">
            iterator
set(
    core::string_view key,
    core::string_view value,
    ignore_case_param ic = = {});
        </pre>
    </div>

    <div>
        <h3>Description</h3>
        <p><span>This function performs one of two</span> <span>actions depending on the value of</span>
<span>`this->contains( key, ic )`.</span></p>

<li><span>If key is contained in the view</span>
<span>then one of the matching elements has</span>
<span>its value changed to the specified value.</span>
<span>The remaining elements with a matching</span>
<span>key are erased. Otherwise,</span></li>
<li><span>If `key` is not contained in the</span>
<span>view, then the function apppends the</span>
<span>param `{ key, value }`.</span></li>
<p><span></span>
<span>All iterators are invalidated.</span></p>

<h3>Example</h3>
<code>
url u( "?id=42&id=69" );

u.params().set( "id", "none" );

assert( u.params().count( "id" ) == 1 );
</code>
<h3>Postconditions</h3>
<code>
this->count( key, ic ) == 1 && this->find( key, ic )->value == value
</code>
<h3>Complexity</h3>
<p><span>Linear in `this->url().encoded_query().size()`.</span></p>

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


    </div>



</div>