std::basic_string_view<CharT,Traits>::ends_with
constexpr bool ends_with( basic_string_view sv ) const noexcept; |
(1) | (since C++20) |
constexpr bool ends_with( CharT c ) 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(), c)
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 |
| c | - | 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 testing macro: __cpp_lib_starts_ends_with.
Example
#include <iostream>
#include <string_view>
auto main() -> int
{
using namespace std::literals;
std::cout
<< std::boolalpha
// (1) bool ends_with( basic_string_view sv ) const noexcept;
<< std::string_view("https://cppreference.com").ends_with(".com"sv) << ' ' // true
<< std::string_view("https://cppreference.com").ends_with(".org"sv) << ' ' // false
// (2) bool ends_with( CharT c ) const noexcept;
<< std::string_view("C++20").ends_with('0') << ' ' // true
<< std::string_view("C++20").ends_with('3') << ' ' // false
// (3) bool ends_with( const CharT* s ) const;
<< std::string_view("string_view").ends_with("view") << ' ' // true
<< std::string_view("string_view").ends_with("View") << ' ' // false
<< '\n';
}
Output:
true false true false true false
See also
|
(C++20)
|
checks if the string view starts with the given prefix (public member function) |
|
(C++20)
|
checks if the string starts with the given prefix (public member function of std::basic_string<CharT,Traits,Allocator>) |
|
(C++20)
|
checks if the string ends with the given suffix (public member function of std::basic_string<CharT,Traits,Allocator>) |
|
(C++23)
|
checks if the string contains the given substring or character (public member function of std::basic_string<CharT,Traits,Allocator>) |
|
(C++23)
|
checks if the string view contains the given substring or character (public member function) |
|
(C++17)
|
compares two views (public member function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string_view/ends_with
