NAME¶

std::basic_string_view::ends_with - std::basic_string_view::ends_with

Synopsis¶

constexpr bool ends_with( basic_string_view sv ) const noexcept; (1) (since C++20)
constexpr bool ends_with( CharT ch ) const noexcept; (2) (since C++20)
constexpr bool ends_with( const CharT* s ) const; (3) (since C++20)

Checks if the string view ends with the given suffix, where

1) the suffix is a string view. Effectively returns size() >= sv.size() &&
compare(size() - sv.size(), npos, sv) == 0.
2) the suffix is a single character. Effectively returns !empty() &&
Traits::eq(back(), ch).
3) the suffix is a null-terminated character string. Effectively returns
ends_with(basic_string_view(s)).

Parameters¶

sv - a string view which may be a result of implicit conversion from
std::basic_string
ch - a single character
s - a null-terminated character string

Return value¶

true if the string view ends with the provided suffix, false otherwise.

Notes¶

Feature-test macro Value Std Feature
__cpp_lib_starts_ends_with 201711L (C++20) String prefix and suffix checking:
starts_with() and ends_with()

Example¶

// Run this code

#include <cassert>
#include <string_view>

int main()
{
using namespace std::literals;

assert
(""
// (1) ends_with( basic_string_view sv )
&& std::string_view("https://cppreference.com").ends_with(".com"sv) == true
&& std::string_view("https://cppreference.com").ends_with(".org"sv) == false

// (2) ends_with( CharT c )
&& std::string_view("C++20").ends_with('0') == true
&& std::string_view("C++20").ends_with('3') == false

// (3) ends_with( const CharT* s )
&& std::string_view("string_view").ends_with("view") == true
&& std::string_view("string_view").ends_with("View") == false
);
}

See also¶

starts_with checks if the string view starts with the given prefix
(C++20) (public member function)
starts_with checks if the string starts with the given prefix
(C++20) (public member function of std::basic_string<CharT,Traits,Allocator>)

ends_with checks if the string ends with the given suffix
(C++20) (public member function of std::basic_string<CharT,Traits,Allocator>)

contains checks if the string contains the given substring or character
(C++23) (public member function of std::basic_string<CharT,Traits,Allocator>)

contains checks if the string view contains the given substring or character
(C++23) (public member function)
compare compares two views
(public member function)