std::basic_string_view<CharT,Traits>::contains
From cppreference.com
< cpp | string | basic string view
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
std::basic_string_view
(C++20)
(C++20)
basic_string_view::contains
(C++23)
Constants
(until C++20)(until C++20)(until C++20)(until C++20)(until C++20)(C++20)
Deduction guides (C++20)
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() {}