|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
constexprbool contains( basic_string_view sv)constnoexcept; | (1) | (since C++23) |
constexprbool contains( CharT c)constnoexcept; | (2) | (since C++23) |
constexprbool contains(const CharT* s)const; | (3) | (since C++23) |
Checks if the string view contains the given substring, where
All three overloads are equivalent toreturn find(x)!= npos;, wherex is the parameter.
Contents |
| sv | - | a string view |
| c | - | a single character |
| s | - | a null-terminated character string |
true if the string view contains the provided substring,false otherwise.
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_string_contains | 202011L | (C++23) | contains functions |
#include <string_view>usingnamespace 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 andstd::string_view("basic_string_view").contains("String")==false); int main(){}
(C++20) | checks if the string view starts with the given prefix (public member function)[edit] |
(C++20) | checks if the string view ends with the given suffix (public member function)[edit] |
| find characters in the view (public member function)[edit] | |
| returns a substring (public member function)[edit] | |
(C++23) | checks if the string contains the given substring or character (public member function of std::basic_string<CharT,Traits,Allocator>)[edit] |
