boost::urls::segments_ref::assign

Assign segments

Synopsis

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

void
assign(std::initializer_list<core::string_view> init);

Description

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

All iterators are invalidated.

NOTE

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

url u; u.segments().assign( { "path", "to", "file.txt" } );

Linear in `init.size() + this->url().encoded_query().size() + this->url().encoded_fragment().size()`.

Strong guarantee.

Calls to allocate may throw.

Parameters

Name Description
init

The list of segments to assign.

Created with MrDocs