std::basic_string<CharT,Traits,Allocator>::contains
来自 zh.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) 一个字符串视图
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'
参见
|
(C++20)
|
检查字符串是否以给定前缀开头
(公开成员函数) |
|
(C++20)
|
检查字符串是否以给定后缀结尾
(公开成员函数) |
|
查找给定子串的首次出现
(公开成员函数) |
|
|
返回子串
(公开成员函数) |
|
|
(C++23)
|
检查字符串视图是否包含给定子串或字符
(
std::basic_string_view<CharT,Traits>
的公开成员函数)
|