boost::urls::params_encoded_ref::append

Append params

Synopsis

Declared in <include/boost/url/params_encoded_ref.hpp>

iterator
append(param_pct_view const& p);

» more…​

iterator
append(std::initializer_list<param_pct_view> init);

» more…​

template<class FwdIt>
iterator
append(
    FwdIt first,
    FwdIt last);

» more…​

Description

This function appends a param to the view.

The `end()` iterator is invalidated.

url u;

u.encoded_params().append( { "first", "John" } );

Linear in `this‐>url().encoded_query().size()`.

Strong guarantee.

Calls to allocate may throw. Exceptions thrown on invalid input.

Exceptions

Name Thrown on

`p`

contains an invalid percent‐encoding.

`init`

contains an invalid percent‐encoding.

The

range contains an invalid percent‐encoding.

Return Value

An iterator to the new element.

Parameters

Name Description

p

The param to append&period;

init

The list of params to append&period;

first,

last The range of params to append&period;

Created with MrDocs