boost::urls::segments_ref::assign :: Boost Libraries Documentation

# boost::urls::segments_ref::assign

Assign segments

## Synopsis

Declared in `<boost/url/segments_ref.hpp>`

    template<class FwdIt>
    void
    assign(
        FwdIt first,
        FwdIt last);

## Description

The existing contents are replaced by a copy of the contents of the range. Reserved characters in the range are automatically escaped.

All iterators are invalidated.

| None of the character buffers referenced by the range may overlap the character buffer of the underlying url, or else the behavior is undefined.

## Mandates

    std::is_convertible< std::iterator_traits< FwdIt >::reference_type, core::string_view >::value == true

## Complexity

Linear in `std::distance( first, last ) + this‐>url().encoded_query().size() + this‐>url().encoded_fragment().size()`.

## Exception Safety

Strong guarantee. Calls to allocate may throw.

## Parameters

Name | Description
--- | ---
first | The beginning of the range of segments to assign.
last | The end of the range of segments to assign.

Created with MrDocs