std::basic_string<CharT,Traits,Allocator>::contains

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

Проверяет, содержит ли строка заданную подстроку. Подстрока может быть одним из следующих вариантов:

1) Представление строки sv (которое может быть результатом неявного преобразования из другого std::basic_string).

2) Отдельный символ ch.

3) Строка символов с завершающим нулём s.

Все три перегрузки эквивалентны return find(x) != npos;, где x — параметр.

Параметры

sv	-	представление строки, которое может быть результатом неявного преобразования из другого `std::basic_string`
ch	-	отдельный символ
s	-	строка символов с завершающим нулём

Возвращаемое значение

true, если строка содержит заданную подстроку, и false в противном случае.

Примечания

Макрос проверки поддержки	Значение	Стандарт	Возможность
`__cpp_lib_string_contains`	`202011L`	(C++23)	`contains` функции

Пример

#include <iomanip>
#include <iostream>
#include <string>
#include <string_view>
#include <type_traits>

template<typename SubstrType>
void test_substring(const std::string& str, SubstrType subs)
{
    constexpr char delim = std::is_scalar_v<SubstrType> ? '\'' : '\"';
    std::cout << std::quoted(str)
              << (str.contains(subs) ? " contains "
                                     : " does not contain ")
              << std::quoted(std::string{subs}, delim) << '\n';
}

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

    auto helloWorld = "hello world"s;

    test_substring(helloWorld, "hello"sv);
    test_substring(helloWorld, "goodbye"sv);
    test_substring(helloWorld, 'w');
    test_substring(helloWorld, 'x');
}

Вывод:

"hello world" contains "hello"
"hello world" does not contain "goodbye"
"hello world" contains 'w'
"hello world" does not contain 'x'

См. также

starts_with (C++20)	проверяет, начинается ли строка с заданного префикса (открытая функция-член)
ends_with (C++20)	проверяет, заканчивается ли строка заданным суффиксом (открытая функция-член)
find	находит первое вхождение заданной подстроки (открытая функция-член)
substr	возвращает подстроку (открытая функция-член)
contains (C++23)	проверяет, содержит ли представление строки заданную подстроку или символ (открытая функция-член `std::basic_string_view<CharT,Traits>`)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/string/basic_string/contains