std::basic_string_view<CharT,Traits>::front - cppreference.com (original) (raw)

| constexpr const_reference front() const; | | (since C++17) | | ----------------------------------------- | | ------------- |

Returns reference to the first character in the view.

If empty() is true, the behavior is undefined. (until C++26)
If empty() is true: If the implementation is hardened, a contract violation occurs. Moreover, if the contract-violation handler returns under “observe” evaluation semantic, the behavior is undefined. If the implementation is not hardened, the behavior is undefined. (since C++26)

[edit] Return value

_[data](../basic%5Fstring%5Fview.html#data "cpp/string/basic string view")_[0]

[edit] Complexity

Constant.

[edit] Example

#include #include   int main() { for (std::string_view str{"ABCDEF"}; !str.empty(); str.remove_prefix(1)) std::cout << str.front() << ' ' << str << '\n'; }

Output:

A ABCDEF B BCDEF C CDEF D DEF E EF F F

[edit] See also

| | accesses the last character (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | checks whether the view is empty (public member function) [edit] | | | accesses the first character (public member function of std::basic_string<CharT,Traits,Allocator>) [edit] |