Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
segments_base::front

Return the first segment.

Synopsis
std::string
front() const;
Description

This function returns a string with the first segment of the path without any leading or trailing '/' separators. Any percent-escapes in the string are decoded first.

Preconditions
this->[link url.ref.boost__urls__segments_base.empty `empty`]() == false
Effects
return *[link url.ref.boost__urls__segments_base.begin `begin`]();
Example
assert( url_view( "/path/to/file.txt" ).segments().[link url.ref.boost__urls__segments_base.front `front`]() == "path" );
Complexity

Linear in this->front().size().

Exception Safety

Calls to allocate may throw.


PrevUpHomeNext