std::basic_string<CharT,Traits,Allocator>::contains
От ru.cppreference.net
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) Объект string view
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>
)
|