std::basic_string<CharT,Traits,Allocator>::contains
Материал из cppreference.com
< cpp | string | 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) |
проверяет, начинается ли строка с заданного префикса (public функция-элемент) |
| (C++20) |
проверяет, заканчивается ли строка заданным суффиксом (public функция-элемент) |
| находит первое вхождение заданной подстроки (public функция-элемент) | |
| возвращает подстроку (public функция-элемент) | |
| (C++23) |
проверяет, содержит ли строковое представление заданную подстроку или символ (public функция-элемент std::basic_string_view<CharT,Traits>)
|
