std::basic_string_view<CharT,Traits>::contains
From cppreference.com
< cpp | string | basic string view
constexpr bool contains( basic_string_view sv ) const noexcept; |
(1) | (since C++23) |
constexpr bool contains( CharT c ) const noexcept; |
(2) | (since C++23) |
constexpr bool contains( const CharT* s ) const; |
(3) | (since C++23) |
Checks if the string view contains the given substring, where
1) the substring is a string view.
2) the substring is a single character.
3) the substring is a null-terminated character string.
All three overloads are equivalent to return find(x) != npos;, where x
is the parameter.
Contents |
[edit] Parameters
sv | - | a string view |
c | - | a single character |
s | - | a null-terminated character string |
[edit] Return value
true if the string view contains the provided substring, false otherwise.
[edit] Notes
Feature-test macro | Value | Std | Feature |
---|---|---|---|
__cpp_lib_string_contains |
202011L |
(C++23) | contains functions
|
[edit] Example
Run this code
#include <string_view> using namespace std::literals; static_assert ( // bool contains(basic_string_view x) const noexcept; "https://cppreference.com"sv.contains("cpp"sv) == true and "https://cppreference.com"sv.contains("php"sv) == false and // bool contains(CharT x) const noexcept; "C++23"sv.contains('+') == true and "C++23"sv.contains('-') == false and // bool contains(const CharT* x) const; std::string_view("basic_string_view").contains("string") == true and std::string_view("basic_string_view").contains("String") == false ); int main() {}
[edit] See also
(C++20) |
checks if the string view starts with the given prefix (public member function) |
(C++20) |
checks if the string view ends with the given suffix (public member function) |
find characters in the view (public member function) | |
returns a substring (public member function) | |
(C++23) |
checks if the string contains the given substring or character (public member function of std::basic_string<CharT,Traits,Allocator> )
|