[#boost-urls-segments_encoded_ref-replace-0f] = xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/segments_encoded_ref.adoc[segments_encoded_ref]::replace :relfileprefix: ../../../ :mrdocs: Replace segments == Synopsis Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/segments_encoded_ref.hpp#L717[boost/url/segments_encoded_ref.hpp]>` [source,cpp,subs="verbatim,replacements,macros,-callouts"] ---- template<class FwdIt> xref:boost/urls/segments_encoded_base/iterator.adoc[iterator] replace( xref:boost/urls/segments_encoded_base/iterator.adoc[iterator] from, xref:boost/urls/segments_encoded_base/iterator.adoc[iterator] to, FwdIt first, FwdIt last); ---- == Description This function replaces a range of segments with annother range of segments. Reserved characters in the new range are automatically escaped. Escapes in the new range are preserved. All iterators that are equal to `from` or come after are invalidated. === Preconditions None of the character buffers referenced by the new range may overlap the character buffer of the underlying url, or else the behavior is undefined. === Complexity Linear in `std::distance( first, last ) + this‐>url().encoded_resouce().size()`. === Exception Safety Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input. == Exceptions |=== | Name | Thrown on | `system_error` | The range contains an invalid percent‐encoding. |=== == Return Value An iterator to the first segment inserted, or one past `to` if `init.size() == 0`. == Parameters |=== | Name | Description | *from* | The first element in the range of segments to replace. | *to* | One past the last element in the range of segments to replace. | *first* | The first element in the new range of segments. | *last* | One past the last element in the new range of segments. |=== [.small]#Created with https://www.mrdocs.com[MrDocs]#