NAME¶

std::basic_string::ends_with - std::basic_string::ends_with

Synopsis¶

constexpr bool
ends_with( std::basic_string_view<CharT, Traits> sv ) const (1) (since C++20)
noexcept;
constexpr bool (2) (since C++20)
ends_with( CharT ch ) const noexcept;
constexpr bool (3) (since C++20)
ends_with( const CharT* s ) const;

Checks if the string ends with the given suffix. The suffix may be one of the
following:

1) A string view sv (which may be a result of implicit conversion from another
std::basic_string).
2) A single character ch.
3) A null-terminated character string s.

All three overloads effectively return std::basic_string_view<CharT, Traits>(data(),
size()).ends_with(x), where x is the parameter.

Parameters¶

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

Return value¶

true if the string 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>
#include <string_view>

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

const auto str = "Hello, C++20!"s;

assert
(""
&& str.ends_with("C++20!"sv) // (1)
&& !str.ends_with("c++20!"sv) // (1)
&& str.ends_with("C++20!"s) // (1) implicit conversion string to string_view
&& !str.ends_with("c++20!"s) // (1) implicit conversion string to string_view
&& str.ends_with('!') // (2)
&& !str.ends_with('?') // (2)
&& str.ends_with("C++20!") // (3)
&& !str.ends_with("c++20!") // (3)
);
}

See also¶

starts_with checks if the string starts with the given prefix
(C++20) (public member function)
starts_with checks if the string view starts with the given prefix
(C++20) (public member function of std::basic_string_view<CharT,Traits>)
ends_with checks if the string view ends with the given suffix
(C++20) (public member function of std::basic_string_view<CharT,Traits>)
contains checks if the string contains the given substring or character
(C++23) (public member function)
contains checks if the string view contains the given substring or character
(C++23) (public member function of std::basic_string_view<CharT,Traits>)
compare compares two strings
(public member function)
substr returns a substring
(public member function)