std::string find_first_of() 方法

自 C++20 起

// (1) Const version only
constexpr size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept;

// (2) Const version only
constexpr size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;

// (3) Const version only
constexpr size_type find_first_of( const CharT* s, size_type pos = 0 ) const;

// (4) Const version only
constexpr size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept;

// (5) Const version only
template < class StringViewLike >
constexpr size_type find_first_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* see below */);

自 C++17 起

// (1) Const version only
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept;

// (2) Const version only
size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;

// (3) Const version only
size_type find_first_of( const CharT* s, size_type pos = 0 ) const;

// (4) Const version only
size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept;

// (5) Const version only
template < class StringViewLike >
size_type find_first_of( const StringViewLike& t, size_type pos = 0 ) const noexcept(/* see below */);

自 C++11 起

// (1) Const version only
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept;

// (2) Const version only
size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;

// (3) Const version only
size_type find_first_of( const CharT* s, size_type pos = 0 ) const;

// (4) Const version only
size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept;

直到 C++11

// (1) Const version only
size_type find_first_of( const basic_string& str, size_type pos = 0 ) const;

// (2) Const version only
size_type find_first_of( const CharT* s, size_type pos, size_type count ) const;

// (3) Const version only
size_type find_first_of( const CharT* s, size_type pos = 0 ) const;

// (4) Const version only
size_type find_first_of( CharT ch, size_type pos = 0 ) const;

查找第一个等于给定字符序列中任一字符的字符。
搜索仅考虑区间 [ pos, size() )。

• (1) 查找第一个等于 str 中任一字符的字符。

• (2) 查找第一个等于范围 [ s, s + count ) 中任一字符的字符。
  此范围可以包含空字符。

• (3) 查找第一个等于 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() 用于比较。默认情况下，`Traits` 是 std::char_traits<CharT>。

示例

#include <cassert>
#include <iostream>
#include <string>
#include <string_view>
 
int main() {
    using namespace std::string_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)
    const char* buf = "xyzabc";
    sz = "consteval"s.find_first_of(buf, 0, 3);
    //
    assert(sz == std::string::npos);
    sz = "consteval"s.find_first_of(buf, 0, 6);
    //    └─────────────────────────┘c in buf
    assert(sz == 0);
 
    // (3)
    sz = "decltype"s.find_first_of(buf);
    //      └──────────────────────┘c in buf
    assert(sz == 2);
 
    // (4)
    sz = "co_await"s.find_first_of('a');
    //       └──────────────────────┘
    assert(sz == 3);
 
    // (5)
    std::string_view sv{"int"};
    sz = "constinit"s.find_first_of(sv);
    //      └───────────────────────┘n in sv
    assert(sz == 2);
 
    std::cout << "All tests passed.\n";
}

输出

All tests passed.