std::basic_string<CharT,Traits,Allocator>::find_last_of
ja.cppreference.net より
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
>>
)
何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません( strong exception safety guarantee )。
例
このコードを実行
#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++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| 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 によって誤って削除された |
復元 |
関連項目
|
指定された部分文字列の最初の出現を検索する
(public member function) |
|
|
部分文字列の最後の出現を検索する
(public member function) |
|
|
文字の最初の出現を検索する
(public member function) |
|
|
文字の最初の不在を検索する
(public member function) |
|
|
文字の最後の不在を検索する
(public member function) |
|
|
文字の最後の出現を検索する
( std::basic_string_view<CharT,Traits>のpublic member function)
|