Namespaces
Variants

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

From cppreference.net
std::basic_string
size_type find_first_of ( const basic_string & str, size_type pos = 0 ) const ;
(1) (自 C++11 起为 noexcept)
(自 C++20 起为 constexpr)
size_type find_first_of ( const CharT * s,
size_type pos, size_type count ) const ;
(2) (自 C++20 起为 constexpr)
size_type find_first_of ( const CharT * s, size_type pos = 0 ) const ;
(3) (自 C++20 起为 constexpr)
size_type find_first_of ( CharT ch, size_type pos = 0 ) const ;
(4) (自 C++11 起为 noexcept)
(自 C++20 起为 constexpr)
template < class StringViewLike >

size_type
find_first_of ( const StringViewLike & t,

size_type pos = 0 ) const noexcept ( /* 见下文 */ ) ;
(5) (自 C++17 起)
(自 C++20 起为 constexpr)

在给定的字符序列中查找第一个与其中任一字符相等的字符。搜索仅考虑范围 [ pos , size() ) 。如果给定字符序列中的任何字符在该范围内均不存在,将返回 npos

1) 查找第一个与 str 中任意字符相等的字符。
2) 查找首个等于给定字符范围 [ s , s + count ) 中任意字符的字符。该范围可以包含空字符。
如果 [ s , s + count ) 不是有效的 范围 ,则行为未定义。
3) 查找与字符指针 s 所指向字符串中任意字符相等的首个字符。字符串长度通过首个空字符确定,使用 Traits :: length ( s )
如果 [ s , s + Traits :: length ( s ) ) 不是有效的 范围 ,则行为未定义。
4) 查找第一个等于 ch 的字符。
5) 隐式转换 t 为字符串视图 sv ,如同通过 std:: basic_string_view < CharT, Traits > sv = t ; 实现,随后查找首个与 sv 中任意字符相等的字符。
此重载仅当 std:: is_convertible_v < const StringViewLike & ,
std:: basic_string_view < CharT, Traits >>
true std:: is_convertible_v < const StringViewLike & , const CharT * > false 时参与重载决议。

目录

参数

str - 用于标识要搜索字符的字符串
pos - 开始搜索的位置
count - 标识要搜索字符的字符串长度
s - 指向标识要搜索字符的字符串的指针
ch - 要搜索的字符
t - 对象(可转换为 std::basic_string_view )用于标识要搜索的字符

返回值

找到字符的位置,若未找到此类字符则返回 npos

异常

1,4) 不抛出任何异常。
5)
noexcept 规范:
noexcept ( std:: is_nothrow_convertible_v < const T & , std:: basic_string_view < CharT, Traits >> )

若因任何原因抛出异常,此函数不产生任何效果( 强异常安全保证 )。

注释

Traits :: eq ( ) 用于执行比较操作。

示例

#include <cassert>
#include <iostream>
#include <string>
#include <string_view>
int main()
{
    using namespace std::literals;
    std::string::size_type sz;
    // (1)
    sz = "alignas"s.find_first_of("klmn"s);
    //     └────────────────────────┘
    assert(sz == 1);
    sz = "alignof"s.find_first_of("wxyz"s);
    // 无匹配
    assert(sz == std::string::npos);
    // (2)
    sz = "consteval"s.find_first_of("xyzabc", 0, 3);
    // 无匹配 (× 不是目标字符)     ×××
    assert(sz == std::string::npos);
    sz = "consteval"s.find_first_of("xyzabc", 0, 6);
    //    └───────────────────────────────┘
    assert(sz == 0);
    // (3)
    sz = "decltype"s.find_first_of("xyzabc");
    //      └────────────────────────────┘
    assert(sz == 2);
    // (4)
    sz = "co_await"s.find_first_of('a');
    //       └──────────────────────┘
    assert(sz == 3);
    // (5)
    sz = "constinit"s.find_first_of("int"sv);
    //      └─────────────────────────┘
    assert(sz == 2);
    std::cout << "All tests passed.\n";
}

输出:

All tests passed.

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

缺陷报告 适用标准 发布时的行为 正确行为
LWG 847 C++98 未提供异常安全保证 增加强异常安全保证
LWG 2064 C++11 重载 (3,4) 为 noexcept 已移除
LWG 2946 C++17 重载 (5) 在某些情况下导致歧义 通过模板化避免歧义
P1148R0 C++11
C++17
重载 (4,5) 的 noexcept 因
LWG2064/LWG2946 被意外丢弃
已恢复

参见

查找给定子串的首次出现
(公开成员函数)
查找子串的最后一次出现
(公开成员函数)
查找字符的首个缺失位置
(公开成员函数)
查找字符的最后一次出现
(公开成员函数)
查找字符的最后缺失位置
(公开成员函数)
查找字符的首次出现
( std::basic_string_view<CharT,Traits> 的公开成员函数)
返回仅包含另一字节字符串中字符的最大初始段长度
(函数)