std::basic_string::find_first_of

来自cppreference.com
< cpp‎ | string‎ | basic string
 
C++
 
字符串库
 
std::basic_string
 
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const;
 (1)
size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;
 (2)
size_type find_first_of( const CharT* s, size_type pos = 0 ) const;
 (3)
size_type find_first_of( CharT ch, size_type pos = 0 ) const;
 (4)
size_type find_first_of( std::basic_string_view<CharT, Traits> sv,
                         size_type pos = 0 ) const
 (5) (C++17 起)

寻找等于给定字符序列中字符之一的首个字符。搜索只考虑区间 [pos, size()) 。若字符不存在于区间中，则返回 npos 。

1) 寻找等于 str 中字符之一的首个字符，如同用 find_first_of(std::basic_string_view<CharT, Traits>(str), pos) (C++17 起)。
2) 寻找等于 s 所指向的字符串的首 count 个字符中字符之一的首个字符。等价于 find_first_of(basic_string(s, count), pos) (C++17 前)find_first_of(std::basic_string_view<CharT, Traits>(s, count), pos) (C++17 起) 。
3) 寻找等于 s 所指向的字符串中字符之一的首个字符。以首个空字符确定字符串长度。等价于 find_first_of(basic_string(s), pos) (C++17 前)find_first_of(std::basic_string_view<CharT,Traits>(s), pos) (C++17 起) 。
4) 寻找等于 ch 的首个字符。
5) 寻找等于 sv 中字符之一的首个字符。

目录

[编辑] 参数

str - 鉴别要搜索的字符的 string
pos - 搜索开始的位置
count - 鉴别要搜索的字符的字符串长度
s - 指向鉴别要搜索的字符的字符串的指针
ch - 鉴别要搜索的字符的字符
sv - 鉴别要搜索的字符的 std::basic_string_view

[编辑] 返回值

找到的字符的位置，或若找不到这种字符则为 npos 。

[编辑] 异常

1-4) （无）
(C++11 前)
1,4)
noexcept 规定：  
noexcept
  
2,3) （无）
(C++11 起)
(C++14 前)
1)
noexcept 规定：  
noexcept
  
2-4) （无）
(C++14 起)
5)
noexcept 规定：  
noexcept
  
 (C++17 起)

[编辑] 注意

用 traits::eq() 进行比较。

[编辑] 示例

运行此代码
#include <iostream>
#include <string>
 
int main()
{
    // 测试字符串
    std::string str = std::string("Hello World!");
 
    // 搜索用的字符串和字符
    std::string search_str = std::string("o");
    const char* search_cstr = "Good Bye!";
 
    std::cout << str.find_first_of(search_str) << '\n';
    std::cout << str.find_first_of(search_str, 5) << '\n';
    std::cout << str.find_first_of(search_cstr) << '\n';
    std::cout << str.find_first_of(search_cstr, 0, 4) << '\n';
    // 'x' 不在 "Hello World' 中，从而它将返回 std::string::npos
    std::cout << str.find_first_of('x') << '\n';
}

可能的输出： 

4
7
1
4
18446744073709551615

[编辑] 参阅

 于字符串中寻找字符
(公开成员函数) [编辑]
寻找子串的最后一次出现
(公开成员函数) [编辑]
寻找字符的首次缺失
(公开成员函数) [编辑]
寻找字符的最后一次出现
(公开成员函数) [编辑]
寻找字符的最后一次缺失
(公开成员函数) [编辑]
返回仅由在另一字节字符串中找到的字符组成的最大起始段长度
(函数) [编辑]
来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/find_first_of&oldid=48942”