front

Return the first segment

Synopsis

string
front() const noexcept;

Declared in file <include/boost/url/segments_base.hpp> on line 241

Defined in file <include/boost/url/impl/segments_base.hpp> on line 105

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->empty() == false

Effects

return *begin();

Example

assert( url_view( "/path/to/file.txt" ).segments().front() == "path" );

Complexity

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

Exception Safety

Calls to allocate may throw.