size_type
rfind(const basic_string& str,
size_type pos = npos) const; // (1) C++03
size_type
rfind(const basic_string& str,
size_type pos = npos) const noexcept; // (1) C++11
constexpr size_type
rfind(const basic_string& str,
size_type pos = npos) const noexcept; // (1) C++20
size_type
rfind(const charT* s,
size_type pos, size_type n) const; // (2) C++03
constexpr size_type
rfind(const charT* s,
size_type pos, size_type n) const; // (2) C++20
size_type
rfind(const charT* s,
size_type pos = npos) const; // (3) C++03
constexpr size_type
rfind(const charT* s,
size_type pos = npos) const; // (3) C++20
size_type
rfind(charT c,
size_type pos = npos) const; // (4) C++03
constexpr size_type
rfind(charT c,
size_type pos = npos) const; // (4) C++20
// string_viewを引数に取るオーバーロード
template <class T>
size_type
rfind(const T& t,
size_type pos = npos) const noexcept(下記参照); // (5) C++17
template <class T>
constexpr size_type
rfind(const T& t,
size_type pos = npos) const noexcept(下記参照); // (5) C++20
概要
最後に現れる指定文字列を検索する。
テンプレートパラメータ制約
- (5) :
is_convertible_v<const T&, basic_string_view<charT, traits>>
がtrue
であることis_convertible_v<const T&, const charT*>
がfalse
であること
要件
(3) の形式の場合、s
は少なくとも traits_type::length(s) + 1
の要素を持つ charT
の配列を指していること。
効果
- (1)
pos
以前で最後にstr
と一致する位置を返す。 - (2)
pos
以前で最後にs
と一致する位置を返す。s
は長さn
の文字列へのポインタである。 - (3) (2) と同様だが、こちらは NULL 終端の文字列を扱う。
- (4)
pos
以前で最後にc
と一致する位置を返す。 - (5)
basic_string_view<charT, traits> sv = t;
として変数sv
を作成し、pos
より前で最後にsv
と一致する位置を返す。
戻り値
見つかればその位置を返し、見つからない場合は basic_string::npos
を返す。
例外
- (1) 投げない
- (5)
noexcept
内の式は、以下と等価である
is_nothrow_convertible_v<const T&, basic_string_view<charT, traits>>
備考
pos
は比較対象となる最後の文字位置では無いことに注意。(例を参照)- 文字列の一致は、文字列の各文字について
traits_type::eq
を用いて検査される。
例えば、(1) の形式の場合、以下のような条件を満たす最大のxpos
を求める。xpos <= pos
かつxpos + str.size() <= size()
0 <= I
かつI < str.size()
を満たす全てのI
について、traits_type::eq(at(xpos + I), str.at(I))
- (3) の形式の場合、
s
の文字列長はtraits_type::length(s)
で求められる。
例
#include <iostream>
#include <string>
int main()
{
const std::string s("Hello, world. Welcome to C++ world.");
const std::string str("world");
// pos を後ろの "world" の "w" の位置にしても、後ろの "world" が見つかる
std::cout << s.rfind(str, 29) << std::endl;
// pos を後ろの "world" の "w" の一つ前にすると、後ろの "world" は見つからずに前の "world" が見つかる
std::cout << s.rfind("world", 28) << std::endl;
// 標準の char_traits では大文字と小文字は区別されるため、"world" の "w" は見つからずに "Welcome" の "W" が見つかる
std::cout << s.rfind('W', 29) << std::endl;
}
xxxxxxxxxx
#include <iostream>
#include <string>
int main()
{
const std::string s("Hello, world. Welcome to C++ world.");
const std::string str("world");
// pos を後ろの "world" の "w" の位置にしても、後ろの "world" が見つかる
std::cout << s.rfind(str, 29) << std::endl;
// pos を後ろの "world" の "w" の一つ前にすると、後ろの "world" は見つからずに前の "world" が見つかる
std::cout << s.rfind("world", 28) << std::endl;
// 標準の char_traits では大文字と小文字は区別されるため、"world" の "w" は見つからずに "Welcome" の "W" が見つかる
std::cout << s.rfind('W', 29) << std::endl;
}
出力
29
7
14
実装例
(1) 以外の形式は、(1) の形式を使用して実装することができる。
// (2)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::rfind(const charT* s, size_type pos, size_type n) const
{
return rfind(std::basic_string(s, n), pos);
}
// (3)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::rfind(const charT* s, size_type pos = npos) const
{
return rfind(std::basic_string(s), pos);
}
// (4)
template <class charT, class traits, class Allocator>
size_type basic_string<charT, traits, Allocator>::rfind(charT c, size_type pos = npos) const
{
return rfind(std::basic_string(1, c), pos);
}
関連項目
名前 | 説明 |
---|---|
find_end |
指定された最後のサブシーケンスを検索する |
参照
- LWG2064 - More
noexcept
issues inbasic_string
- P0254R2 Integrating
std::string_view
andstd::string
- LWG Issue 2946. LWG 2758's resolution missed further corrections
- 意図しない暗黙変換防止のために
string_view
を受けるオーバーロード(5)の引数型をconst T&
に変更
- 意図しない暗黙変換防止のために
- P0980R1 Making
std::string
constexpr