Function params_encoded_ref::append

Append params

Synopsis

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

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

Description

This function appends the params in an initializer-list to the view.

The end() iterator is invalidated.

Example

url u;

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

Complexity

Linear in this->url().encoded_query().size().

Exception Safety

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

Exceptions

Name Thrown on

system_error

init contains an invalid percent-encoding.

Return Value

An iterator to the first new element.

Parameters

Name Description

init

The list of params to append.