Namespaces
Variants

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

From cppreference.net
C++
Strings library
std::basic_string
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) ? " содержит "
                                     : " не содержит ")
              << 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" содержит "hello"
"hello world" не содержит "goodbye"
"hello world" содержит 'w'
"hello world" не содержит 'x'

Смотрите также

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