Namespaces
Variants

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

来自 zh.cppreference.net
 
 
 
std::basic_string
 
size_type find_last_of( const basic_string& str,
                        size_type pos = npos ) const;
(1) (C++11 起为 noexcept)
(C++20 起为 constexpr)
size_type find_last_of( const CharT* s,
                        size_type pos, size_type count ) const;
(2) (C++20 起为 constexpr)
size_type find_last_of( const CharT* s, size_type pos = npos ) const;
(3) (C++20 起为 constexpr)
size_type find_last_of( CharT ch, size_type pos = npos ) const;
(4) (C++11 起为 noexcept)
(C++20 起为 constexpr)
template< class StringViewLike >
size_type
    find_last_of( const StringViewLike& t,
                  size_type pos = npos ) const noexcept(/* see below */);
(5) (C++17 起)
(C++20 起为 constexpr)

查找与给定字符序列中任意字符相等的最后一个字符。具体搜索算法未指定。搜索仅考虑范围 [0, pos] 。如果给定字符序列中的所有字符均未出现在该范围内,则返回 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 时,此重载才会参与重载决议。

在所有情况下,均通过调用 Traits::eq 检查相等性。

参数

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 >> )

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

示例

#include <iostream>
#include <string>
int main()
{
    const std::string path = "/root/config";
    auto const pos = path.find_last_of('/');
    const auto leaf = path.substr(pos + 1);
    std::cout << leaf << '\n';
}

输出:

config

缺陷报告

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

缺陷报告 应用于 发布时行为 正确行为
LWG 141 C++98 重载 (1) 仅在 npos 时可能返回 pos >= size ( ) 此时搜索范围为
[ ​ 0 ​ , size ( ) )
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> 的公开成员函数)