boost::urls::url_view_base::segments

Return the path as a container of segments

Synopsis

Declared in <boost/url/url_view_base.hpp>

segments_view
segments() const noexcept;

Description

This function returns a bidirectional view of strings over the path. The returned view references the same underlying character buffer; ownership is not transferred. Any percent‐escapes in strings returned when iterating the view are decoded first.

Example

segments_view sv = url_view( "/path/to/file.txt" ).segments();

Complexity

Constant.

Exception Safety

Throws nothing.

BNF

path          = [ "/" ] segment *( "/" segment )

Specification

https://datatracker.ietf.org/doc/html/rfc3986#section-3.3

Return Value

A bidirectional view of segments.