boost::urls::segments_view
Non‐owning decoded path segment view
Synopsis
Declared in <boost/url/segments_view.hpp>
class segments_view
: public segments_base
Types
Name |
Description |
A Bidirectional iterator to a path segment |
|
A Bidirectional iterator to a path segment |
|
The reference type |
|
A signed integer type used to represent differences. |
|
The reference type |
|
An unsigned integer type used to represent size. |
|
The value type |
Member Functions
Name |
Description |
|
Constructor |
Assignment |
|
Return the last segment |
|
Return an iterator to the beginning |
|
Return the referenced character buffer. |
|
Return true if there are no segments |
|
Return an iterator to the end |
|
Return the first segment |
|
Returns true if this references an absolute path. |
|
Return the number of segments |
Friends
| Name | Description |
|---|---|
Mutable decoded path segment proxy |
|
Non‐owning encoded path segment view |
|
Common functionality for containers |
Description
Presents the path of a URL as a read‐only bidirectional range of percent‐decoded segments. The range references the original buffer, so callers must keep that storage alive for as long as the view is accessed.
Example
url_view u( "/path/to/file.txt" );
segments_view ps = u.segments();
assert( ps.buffer().data() == u.buffer().data() );
Any percent‐escapes are decoded on demand when iterators are dereferenced.
Iterator Invalidation
Changes to the underlying character buffer can invalidate iterators which reference it.
See Also
segments_encoded_view, segments_encoded_ref, segments_ref.
Created with MrDocs