boost::urls::segments_encoded_ref::insert :: Boost Libraries Documentation

# boost::urls::segments_encoded_ref::insert

Insert segments

## Synopsis

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

    iterator
    insert(
        iterator before,
        pct_string_view s);

## Description

This function inserts a segment before the specified position. Reserved characters in the segment are automatically escaped. Escapes in the segment are preserved.

All iterators that are equal to `before` or come after are invalidated.

## Complexity

Linear in `s.size() + this‐>url().encoded_resource().size()`.

## Exception Safety

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

## Exceptions

Name | Thrown on
`system_error` | The segment contains an invalid percent‐encoding.

## Return Value

An iterator to the inserted segment.

## Parameters

Name | Description
--- | ---
before | An iterator before which the segment is inserted. This may be equal to `end()`.
s | The segment to insert.

Created with MrDocs