:relfileprefix: ../../ [#4C25147D18AA6635FADA4B7BB4AD9FB3FFD55ABD] = Class segments_encoded_ref pass:v,q[A view representing path segments in a URL] == Synopsis Declared in header `` [source,cpp,subs="verbatim,macros,-callouts"] ---- class segments_encoded_ref : public xref:boost/urls/segments_encoded_base.adoc[segments_encoded_base]; ---- == Types [,cols=2] |=== |Name |Description |xref:boost/urls/segments_encoded_base/const_iterator.adoc[`pass:v[const_iterator]`] | xref:boost/urls/segments_encoded_base/iterator.adoc[iterator] |xref:boost/urls/segments_encoded_base/const_reference.adoc[`pass:v[const_reference]`] | pass:v,q[The reference type] |xref:boost/urls/segments_encoded_base/difference_type.adoc[`pass:v[difference_type]`] | pass:v,q[A signed integer type used to represent differences.] |xref:boost/urls/segments_encoded_base/iterator.adoc[`pass:v[iterator]`] | |xref:boost/urls/segments_encoded_base/reference.adoc[`pass:v[reference]`] | pass:v,q[The reference type] |xref:boost/urls/segments_encoded_base/size_type.adoc[`pass:v[size_type]`] | pass:v,q[An unsigned integer type used to represent size.] |xref:boost/urls/segments_encoded_base/value_type.adoc[`pass:v[value_type]`] | pass:v,q[The value type] |=== == Member Functions [,cols=2] |=== |Name |Description |xref:boost/urls/segments_encoded_ref/assign.adoc[`pass:v[assign]`] | pass:v,q[Assign segments] |xref:boost/urls/segments_encoded_base/back.adoc[`pass:v[back]`] | pass:v,q[Return the last segment] |xref:boost/urls/segments_encoded_base/begin.adoc[`pass:v[begin]`] | pass:v,q[Return an iterator to the beginning] |xref:boost/urls/segments_encoded_base/buffer.adoc[`pass:v[buffer]`] | pass:v,q[Return the referenced character buffer.] |xref:boost/urls/segments_encoded_ref/clear.adoc[`pass:v[clear]`] | pass:v,q[Clear the contents of the container] |xref:boost/urls/segments_encoded_base/empty.adoc[`pass:v[empty]`] | pass:v,q[Return true if there are no segments] |xref:boost/urls/segments_encoded_base/end.adoc[`pass:v[end]`] | pass:v,q[Return an iterator to the end] |xref:boost/urls/segments_encoded_ref/erase.adoc[`pass:v[erase]`] | pass:v,q[Erase segments] |xref:boost/urls/segments_encoded_base/front.adoc[`pass:v[front]`] | pass:v,q[Return the first segment] |xref:boost/urls/segments_encoded_ref/insert.adoc[`pass:v[insert]`] | pass:v,q[Insert segments] |xref:boost/urls/segments_encoded_base/is_absolute.adoc[`pass:v[is_absolute]`] | pass:v,q[Returns true if this references an absolute path.] |xref:boost/urls/segments_encoded_ref/2conversion.adoc[`pass:v[operator segments_encoded_view]`] | pass:v,q[Conversion] |xref:boost/urls/segments_encoded_ref/operator_assign.adoc[`pass:v[operator=]`] | pass:v,q[Assignment] |xref:boost/urls/segments_encoded_ref/pop_back.adoc[`pass:v[pop_back]`] | pass:v,q[Remove the last segment] |xref:boost/urls/segments_encoded_ref/push_back.adoc[`pass:v[push_back]`] | pass:v,q[Append a segment] |xref:boost/urls/segments_encoded_ref/replace.adoc[`pass:v[replace]`] | pass:v,q[Replace segments] |xref:boost/urls/segments_encoded_ref/2constructor.adoc[`pass:v[segments_encoded_ref]`] | pass:v,q[Constructor] |xref:boost/urls/segments_encoded_base/size.adoc[`pass:v[size]`] | pass:v,q[Return the number of segments] |xref:boost/urls/segments_encoded_ref/url.adoc[`pass:v[url]`] | pass:v,q[Return the referenced url] |=== == Static Member Functions [,cols=2] |=== |Name |Description |xref:boost/urls/segments_encoded_base/max_size.adoc[`pass:v[max_size]`] | pass:v,q[Return the maximum number of characters possible] |=== == Description pass:v,q[Objects of this type are used to interpret] pass:v,q[the path as a bidirectional view of segments,] pass:v,q[where each segment is a string which may] pass:v,q[contain percent-escapes.] pass:v,q[The view does not retain ownership of the] pass:v,q[elements and instead references the original] pass:v,q[character buffer. The caller is responsible] pass:v,q[for ensuring that the lifetime of the buffer] pass:v,q[extends until it is no longer referenced.] pass:v,q[The view is modifiable; calling non-const] pass:v,q[members causes changes to the referenced] pass:v,q[url.] === Example [,cpp] ---- url u( "/path/to/file.txt" ); segments_encoded_ref ps = u.encoded_segments(); ---- pass:v,q[The strings returned when iterators are] pass:v,q[dereferenced have type] xref:boost/urls/pct_string_view.adoc[pct_string_view] pass:v,q[and may contain percent-escapes.] pass:v,q[Reserved characters in inputs are] pass:v,q[automatically escaped.] pass:v,q[Escapes in inputs are preserved.] pass:v,q[Exceptions are thrown on invalid inputs.] === Iterator Invalidation pass:v,q[Changes to the underlying character buffer] pass:v,q[can invalidate iterators which reference it.] pass:v,q[Modifications made through the container] pass:v,q[invalidate some or all iterators:] * xref:boost/urls/segments_encoded_ref/push_back.adoc[push_back] pass:v,q[: Only `end()`.] * xref:boost/urls/segments_encoded_ref/assign-0e.adoc[assign,] xref:boost/urls/segments_encoded_ref/clear.adoc[clear,] xref:boost/urls/segments_encoded_ref/operator_assign-02c.adoc[operator=] pass:v,q[: All elements.] * xref:boost/urls/segments_encoded_ref/erase-006.adoc[erase] pass:v,q[: Erased elements and all] pass:v,q[elements after (including `end()`).] * xref:boost/urls/segments_encoded_ref/insert-04.adoc[insert] pass:v,q[: All elements at or after] pass:v,q[the insertion point (including `end()`).] * xref:boost/urls/segments_encoded_ref/replace-07.adoc[replace] pass:v,q[: Modified] pass:v,q[elements and all elements] pass:v,q[after (including `end()`).]