[#boost-urls-params_encoded_ref-replace-06] = xref:boost/urls/params_encoded_ref/replace-06.adoc[boost::urls::params_encoded_ref::replace] :relfileprefix: ../../../ :mrdocs: Replace params == Synopsis Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/params_encoded_ref.hpp#L802[boost/url/params_encoded_ref.hpp]>` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- template<class FwdIt> xref:boost/urls/params_encoded_base/iterator.adoc[iterator] replace( xref:boost/urls/params_encoded_base/iterator.adoc[iterator] from, xref:boost/urls/params_encoded_base/iterator.adoc[iterator] to, FwdIt first, FwdIt last); ---- == Description This function replaces a range of params with a range of params. All iterators that are equal to `from` or come after are invalidated. [NOTE] The strings referenced by the inputs must not come from the underlying url, or else the behavior is undefined. == Mandates [,cpp] ---- std::is_convertible< std::iterator_traits< FwdIt >::reference_type, param_pct_view >::value == true ---- == Complexity Linear in `this‐>url().encoded_query().size()`. == Exception Safety Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input. == Exceptions [cols=2] |=== | Name | Thrown on | `system_error` | The range contains an invalid percent‐encoding. |=== == Return Value * An iterator to the first element inserted, or one past `to` if `first == last`. * An iterator to the first element inserted, or one past `to` if `first == last`. == Parameters [cols=2] |=== | Name | Description | *from* | The first element to replace. | *to* | One past the last element to replace. | *first* | The first element to insert. | *last* | One past the last element to insert. |=== [.small]#Created with https://www.mrdocs.com[MrDocs]#