Assign segments
Synopsis
Declared in header </boost/url/segments_encoded_ref.hpp#L321[boost/url/segments_encoded_ref.hpp,window=blank_]>
void
assign(initializer_list<pct_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. Escapes in the list are preserved. All iterators are invalidated.
Note
|
None of the character buffers referenced by the list may overlap the character buffer of the underlying url, or else the behavior is undefined. |
Example
url u;
u.segments().assign( {"path", "to", "file.txt"} );
Complexity
Linear in init.size() + this->url().encoded_query().size() + this->url().encoded_fragment().size()
.
Exception Safety
Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.
Return Value
-
void
Parameters
Name | Type |
---|---|
init |
|