:relfileprefix: ../../../ [#boost-urls-params_ref-replace-01] = xref:boost.adoc[pass:[boost]]::xref:boost/urls.adoc[pass:[urls]]::xref:boost/urls/params_ref.adoc[pass:[params_ref]]::replace Replace elements == Synopsis Declared in header `` [source,cpp,subs="verbatim,macros,-callouts"] ---- template xref:boost/urls/params_base/iterator.adoc[iterator] replace( xref:boost/urls/params_base/iterator.adoc[iterator] from, xref:boost/urls/params_base/iterator.adoc[iterator] to, FwdIt first, FwdIt last); ---- == Description This function replaces a range of elements 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_view >::value == true ---- === Complexity Linear in `this->url().encoded_query().size()`. === Exception Safety Strong guarantee. Calls to allocate may throw. == Return Value An iterator to the first element inserted, or one past `to` if `first == last`. == Parameters |=== | Name | Description | *from,to* | The range of elements to replace. | *first,* | last The range of params to assign. |===