[#boost-urls-url_base-segments-04]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/url_base.adoc[url_base]::segments
:relfileprefix: ../../../
:mrdocs:


Return the path as a container of segments

== Synopsis


Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/url_base.hpp#L1889[boost/url/url_base.hpp]>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:boost/urls/segments_view.adoc[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

[,cpp]
----
segments_view sv = url_view( "/path/to/file.txt" ).segments();
----

=== Complexity

Constant.


=== Exception Safety

Throws nothing.


=== BNF

[,cpp]
----
path          = [ "/" ] segment *( "/" segment )
----

=== Specification

* link:https://datatracker.ietf.org/doc/html/rfc3986#section-3.3[3.3. Path (rfc3986)]

Return the path as a container of segments

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

[,cpp]
----
segments_view sv = url_view( "/path/to/file.txt" ).segments();
----

=== Complexity

Constant.


=== Exception Safety

Throws nothing.


=== BNF

[,cpp]
----
path          = [ "/" ] segment *( "/" segment )
----

=== Specification

* link:https://datatracker.ietf.org/doc/html/rfc3986#section-3.3[3.3. Path (rfc3986)]



== See Also


xref:boost/urls/url_view_base/is_path_absolute.adoc[is_path_absolute],            xref:boost/urls/url_view_base/encoded_path.adoc[encoded_path],            xref:boost/urls/url_view_base/encoded_segments.adoc[encoded_segments].            xref:boost/urls/url_view_base/path.adoc[path],            xref:boost/urls/segments_view.adoc[segments_view].



xref:boost/urls/url_view_base/is_path_absolute.adoc[is_path_absolute],            xref:boost/urls/url_view_base/encoded_path.adoc[encoded_path],            xref:boost/urls/url_view_base/encoded_segments.adoc[encoded_segments].            xref:boost/urls/url_view_base/path.adoc[path],            xref:boost/urls/segments_view.adoc[segments_view].






[.small]#Created with https://www.mrdocs.com[MrDocs]#